【干货来袭】使用 Python 扩展 UiBot 的功能

前言：

UiBot 除了自带的强大功能外，还容许有编程经验的开发人员对功能进行自由扩展，目前 UiBot 支持如下四种扩展方式：

Python 插件、Lua 插件、Lua Mod 插件、COM 插件（ .Net 也使用这种方式扩展）

本期教程将为你们讲解如何利用这四种扩展方式扩充 UiBot 的功能。

Python 插件开发教程：

1. 插件开发快速上手：

打开 UiBot 安装目录下的 extend \ python 目录，在这个目录下建立 test.py 文件（记得修改文件扩展名），使用记事本打开这个文件，写入以下代码：

def Add(n1, n2): return n1 + n2

而后将文件另存为 utf-8 编码格式：

插件保存后，打开 UiBot 在源代码视图写入代码：

Import test traceprint test.add(1, 1)

运行 UiBot 脚本，运行后结果以下（输出2）表明插件调用正常：

若是运行结果不正常，可根据输出窗格的报错提示尝试解决，若是报错为 模块test没有加载成功，则检查 test.py 中的代码是否正确、文件名和路径是否正确（例如文件后缀问题）

2. 开发环境部署（VS Code）：

使用 Python 编写 UiBot 扩展库很容易，但 Python 自己是一门独立的编程语言，使用文本编辑器开发和调试都很不方便，所以建议使用 VS Code 集成开发环境作 Python 扩展库开发。

首先须要在机器上安装 Python 3.7.1，下载地址：www.python.org/downloads/r…

下载时选择 Windows x86-64 executable installer 版本，下载完成后直接安装。

安装 Python 时须要勾选 Add Python 3.7 to PATH，而后点击 Install Now 安装便可：

而后在机器上安装 VS Code，下载地址： code.visualstudio.com/

VS Code 安装完成后，是英文版本：

点击 VS Code 左侧边栏上方最后一个按钮（见截图），而后在搜索框里输入 Chinese，找到简体中文语言包安装：

安装完成后，VS Code 会提示是否重启编辑器使语言包生效，重启后软件便可显示为中文：

若是这步完成后语言没有切换成功，能够按热键 Ctrl + Shift + P，搜索 Configure Display Language，配置显示语言：

将红圈选中的内容更改成 zh-cn，保存文件后重启 VS Code，便可更换为中文显示：

VS Code 和 Python 都安装完成后，使用 VS Code 打开任意 py 后缀的文件，会自动提示是否安装 Python 开发环境

Python 扩展安装完成后，VS Code 还会要求你安装 pylint，这是在 VS Code 开发时用于语法错误检查的组件，能够根据本身的需求选择是否安装。 以上步骤操做后，使用 VS Code 的 Python 开发环境就部署完毕了，编写代码，而后F5运行看看效果吧。

3. Python 插件测试：

在 Python 文件中写入以下代码，这段代码在 UiBot 环境下是不会运行的，但在 Python 调试状态下会运行，以此实现更便捷的 Python 扩展库调试：

测试代码 if name == ‘main’: print(123)

4. UiBot 调用方法：

插件的文件名即为插件名，例如咱们编写的插件文件名为 test.py，则在 UiBot 中使用 Import test 便可载入插件。

对于 Python 插件来讲，每一个 def 的函数均可以使用 UiBot 调用。

目前 UiBot 还不支持 Python 插件中的一些特性，例如 可选参数、可变参数。

5. 插件使用的其余组件安装到 UiBot：

UiBot 内置的 Python 运行环境包含了绝大多数 Python 自带的扩展库和 pywin32 等使用频度较高的库，但仍不能保证所有覆盖，若是你在开发 Python 插件的过程当中，使用了 UiBot 没有附带的库，则可能产生插件在 Python 环境下运行正常，在 UiBot 环境下运行不正常的问题，这时候就须要将对应的扩展库添加到 UiBot 安装目录下的 lib \ site-packages 文件夹中解决。

6. Python 教程：

推荐廖雪峰大神编写的 Python 教程：www.liaoxuefeng.com/wiki/001431…