多年前,我就在 MacOS 上用过 appium。当时的 appium-doctor 是 appium GUI 上的按钮,点开就可以检查 appium 环境配置是否符合要求。
最近重拾 appium,发现细节上有不少变化。将 appium 环境配置过程,以及遇到的问题记录如下,以作备忘。
安装 appium & appium-doctor
安装 appium:https://github.com/appium/appium-desktop/releases
发现 appium-doctor 不再集成到 appium GUI 上,需要额外安装。官方文档:http://appium.io/docs/en/about-appium/getting-started/#installation-via-desktop-app-download
npm install appium-doctor -g
启动 appium-doctor
发现 appium-doctor 无法正常启动,因为 node 版本太低了,最少要 node 8,而我本机的 node 还是 6.10.2 版本的。
通过 node 版本管理工具 nvm 下载 v12.16.0 的 node
nvm install v12.16.0
发现 appium-doctor 在 v12.16.0 node 环境仍无法正常启动,如下图。
在 appium 论坛中找到解决思路,我本机是 MacOS 10.15.2,可能是 appium-doctor 不支持这个版本的 MacOS。于是,更新文件 /usr/local/lib/node_modules/appium/lib/doctor/ios.js
else if (stdout.match('10.15') !== null) {
this.osVersion = '10.15';
cb(null, "Mac OS X 10.15 is installed.");
}
就这样,appium-doctor 无法启动的问题已经解决了。
安装 xcode-select
如下图,appium-doctor 运行之后,发现当前环境缺少 Xcode Command Line。如果手动输入 “y” 会弹出 xcode-select 的安装界面,过一会儿就会报错 network error
尝试使用以下命令安装,仍是一样的效果,弹出安装界面之后会报错 network error
xcode-select --install
搜到下文之后,直接就访问苹果官网(https://developer.apple.com/downloads/index.action)下载 Xcode Command Line 了。有 230+ MB。
完成环境配置
Xcode Command Line 完成安装之后,再运行 appium-doctor 就没问题了。环境已经 Ready。