minium windows环境搭建

一、minium介绍

       官方的介绍：minium 是为小程序专门开发的自动化框架, 提供了 Python 和 JavaScript 版本。使用 minium 可以进行小程序 UI 自动化测试, 但是 minium 的功能不止于仅仅是 UI 自动化, 甚至可以使用 minium 来进行函数的 mock, 可以直接跳转到小程序某个页面并设置页面数据, 做针对性的全面测试, 这些都得益于我们开放了部分小程序 API 的能力。除此之外，小程序有部分组件使用了系统原生的组件，对于这部分的组件，我们也基于 uiautomator 和 wda 做了补充。

## 我们仅聚焦与ui自动化，工具的其他功能暂不做探索。

二、环境怎么搭建

minium环境的搭建非常简单，按照官方文档操作就行。

官网文档地址：登录 - 微信开发者代码管理https://git.weixin.qq.com/minitest/minium-doc

第一步：安装python  略

注意的是minium要求python3.8以上版本

 第二步：安装微信开发者工具

稳定版 Stable Build | 微信开放文档微信开发者平台文档https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html直接下载安装包一路下一步直到安装完成

注意安装完成后打开安全模式：设置 -> 安全设置 -> 服务端口: 打开

第三步：安装minium

 在线安装： 

pip3 install https://minitest.weixin.qq.com/minium/Python/dist/minium-latest.zip

离线安装 ：

https://minitest.weixin.qq.com/minium/Python/dist/minium-latest.zip解压后进入文件夹运行

python3 setup.py install

环境检查：

命令行执行：

minitest -v

出现以下结果说明安装成功：

{'version': '1.1.0', 'revision': '2fac2e36c281213874110f2088bc08c570bc1a2d', 'branch': 'master', 'update_at': '2021-08-05 21:17:09'}

第四步：开发者工具配置

实际上没啥配置内容，主要是弄到项目代码，appID，加入项目团队

获取小程序开发代码

这个直接找开发要git地址，获得代码拉取权限，可以根据需要选择拉取master代码或分支代码

由于各团队代码结构习惯的问题，直接问清楚开发小程序的代码目录

比如：***\special-mini-program\dist\weapp

获取AppID

这个也是直接问开发或者项目经理要

加入项目团队

这里的项目团队非常规意义的项目团队，是指微型小程序的团队

 找项目经理加入就行

微信开发者工具导入项目

 打开第二步安装的微信开发者工具，点击导入

 目录选择微信小程序的目录，注意这个目录不一定是开发代码的根目录，具体问开发

打开后查看渲染是否正常，正常则关闭开发者工具，保留创建项目页面。这种方式打开的环境不能支持自动化脚本，需要开启监听端口。

命令行开启开发者工具并打开监听端口

进入开发者工具安装目录
执行命令：cli.bat --auto D:\autotest\weixin\special-mini-program\dist\weapp --auto-port 9420
D:\autotest\weixin\special-mini-program\dist\weapp::微信小程序代码目录
9420是监听端口

比如：

C:\Users\55401>d:

D:\>cd D:\Program Files (x86)\Tencent\微信web开发者工具

D:\Program Files (x86)\Tencent\微信web开发者工具>cli.bat --auto D:\autotest\weixin\special-mini-program\dist\weapp --auto-port 9420
√ IDE server has started, listening on http://127.0.0.1:35808
[warn] DEPRECATED please upgrade to the following v2 command instead ( doc: https://developers.weixin.qq.com/miniprogram/dev/devtools/cli.html )

 cli auto --project D:\autotest\weixin\special-mini-program\dist\weapp --auto-port 9420

√ Open project with automation enabled success D:\autotest\weixin\special-mini-program\dist\weapp

命令执行后会打开微信开发者工具。

第五步：开始使用

新建python文件demo.py

import minium
mini = minium.Minium({
    "project_path": "path/to/project",   # 替换成你的【小程序项目目录地址】
    "dev_tool_path": "path/to/cli",      # 替换成你的【开发者工具cli地址】，macOS: <安装路径>/Contents/MacOS/cli， Windows: <安装路径>/cli.bat
})
print(mini.get_system_info())

到这里minium就搭建好了，其他插件的扩展根据需要自行安装就好。