Skip to content

Latest commit

 

History

History
116 lines (77 loc) · 4.15 KB

2YourFirstLitaSkill.md

File metadata and controls

116 lines (77 loc) · 4.15 KB

第一个Lita技能

在本章中，你将建立你的第一个聊天机器人技能——一个可以将给定的数字翻倍的技能。通过构建这个简单的技能，我们能够熟悉开发和发布机器人技能所涉及的相关组件和过程。

以下是要做的事情的概述:

  • 编写规则来匹配特定的用户消息
  • 为规则编写有效的代码
  • 编写RSpec测试，以确认你的技能按预期工作。
  • 设置一个发布流水线，这样你就可以将代码部署到RubyGems上
  • 在GitHub建立公共代码托管，并使用 Travis CI 进行持续的构建测试。

生成一个空技能

首先需要先安装git

  1. Git安装
sudo apt-get install git
  1. 配置git环境
git config --global user.name "你的用户名"
git config --global user.email "你的注册邮箱"
  1. 生成SSH密钥，输入下面命令后直接回车，生成密钥的位置默认是/home/“用户名”/.ssh/id_rsa.pub
ssh-keygen -C "你的注册邮箱" -t rsa
  1. 登录GitHub填入client端生成的公钥（id_rsa.pub中的内容）
  2. 将key加入到ssh-agent，在终端输入
ssh-add  ~/.ssh/id_rsa

git的快速入门可以参考廖雪峰的git教程

在mybot目录下执行如下命令，这个命令将创建一个新的 Lita-doubler 目录，其中包含构建第一个Lita技能所需的所有Ruby文件。

lita handler doubler

对于第一个技能，输入“yes”同意所有的可选提示

image-20201004092112029

新生成的lita-doubler目录下包含以下文件

image-20201004093305855

  • lib/lita/handlers/doubler.rb包含你将要编写的Lita技能的核心实现代码。
  • spec/lita/handlers/doubler_spec.rb包含一个空的测试工具，用于自动验证新的 Lita 技能是否按预期工作。
  • .travis.yml是免费在线构建服务器的默认配置。稍后，在将Lita技能推送到GitHub时，将设置这个属性来自动测试 Lita 技能的每个新版本。
  • lita-doubler.gemspec指定你的Lita技能发布为RubyGem所需的所有重要元数据。

完善lita-doubler.gemspec文件

用适当的描述、摘要和主页链接替换“ TODO”部分。

image-20201004094909164

进入lita-doubler目录下，运行bundle来安装gem的运行环境，这些环境列在gemspec文件的底部。

告诉Lita何时响应route

编写lita-doubler/lib/lita/handlers/doubler.rb，插入以下代码

      route(
        /^double\s+(\d+)$/i,
        :respond_with_double,
        command: true,
        help: { 'double N' => 'prints N + N' }
      )

使用单元测试验证第一个route

当你的处理程序无法识别预期的触发词时，编写Bot技能会令人沮丧。你可以通过编写route测试来避免这种情况。下面是一些使用Lita的expected.toroute语法进行RSpec测试。你可以测试正向“预期响应时响应”的情况，以及为反向的“当输入与特定路由不完全匹配时不响应”的情况。负面测试有助于构建一种心理模型，了解某一特定代码段的预期行为。对于像doubler这样的小技能来说，这并不是什么大问题。然而，当你创造更复杂的技能时，负面测试就派上用场了

编写lita-doubler/spec/lita/handlers/doubler_spec.rb，插入以下代码

  describe 'routing' do
    # allow extra whitespace
    it { is_expected.to route('Lita double 2') }
    it { is_expected.to route('Lita double    22') }
    # allow mixed casing
    it { is_expected.to route('Lita doUble 4') }

    # ignore numbers that don't look like integers
    it { is_expected.to_not route('Lita double two') }
    it { is_expected.to_not route('Lita double 1e4') }
  end

完善技能并写一些单元测试

把你的技能作为一个Ruby Gem发布给别人

git remote add origin git@github.com:ajietextd/lita-doubler.git
git add .
git commit -m "Add everything for first push to GitHub"