【乾貨來襲】使用 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…