Jenkins中使用Appium的最佳姿势

Posted 2021-04-07 51Testing软件测试网

　　最近在公司内部申请了一台云主机当做我们组自己的slave机器，于是把之前从北京侧同事那边借的Job迁移过来，appium相关的环境要全部重新配置。上次同事帮了我很多忙，所以我并不太清楚Jenkins这块儿到底应该怎么配置，这次是完全自己走了一遍坑，记录一下遇到的问题。

　　撰写本文时笔者的云主机上一些环境版本：

• Linux：Ubuntu 14.04

• npm：5.4.2

• node：6.11.5

• appium：1.7.1

　　环境变量

　　在配好slave机器之后，已经有了一些默认的环境变量（我的机器上是android环境），要配置appium，我们需要npm、node套件。我是一个比较保守的人，于是选择了node 6和npm 5，在Ubuntu上安装了这些，然后

　　npm install appium -g

　　等待安装完毕之后，基本的appium环境就具备了。于是我跑了一遍脚本，GG。看了报错发现appium、ruby等都没识别出来，对比之前的机器我发现因为环境变量没有新增，我的机器上Jenkins相关的环境变量配置在/data/config/config.properties文件中，我添加了node、ruby路径然后配置了PATH变量， 重启了机器 ，再跑一遍Job，发现appium、ruby等识别出来了。

　　注：网络环境不好的话，大概率可能会出来类似这样的log：

　　info UiAutomator2 downloading UiAutomator2 Server APK v0.1.9 : https://github.com/appium/appium-uiautomator2-server/releases/download/v0.1.9/appium-uiautomator2-server-v0.1.9.apk

　　info UiAutomator2 downloading UiAutomator2 Server test APK v0.1.9 : https://github.com/appium/appium-uiautomator2-server/releases/download/v0.1.9/appium-uiautomator2-server-debug-androidTest.apk

　　然后一直卡在这里不动了。那解决方式就简单了，手动下载这俩app，然后放到对应的目录~/.nvm/versions/node/v6.11.5/lib/node_modules/appium/node_modules/appium-uiautomator2-driver/uiautomator2/中就行。如果没有uiautomator2子目录，就新建一个。

　　进程守护

　　在配置好appium环境之后，运行appium

　　就可以启动appium进程。本地这么做当然没什么问题，但是在Jenkins上这么做就有问题了。首先，我们要在一个Job里跑脚本，当运行appium之后，整个会话就被堵塞了，后面的脚本没法执行了，所以我们一定要让appium server跑在后台，同时还要管理appium的日志已经启动/停止appium server。

　　方法一

　　我们都知道，Linux系统中有一个Upstart服务管理程序，它可以让一些服务在后台运行并且管理，相关的服务我们可以在/etc/init/目录下找到。既然它可以让服务在后台运行，我们也可以使用它来管理我们的appium服务。有了这个思路，我们只需要在/etc/init/目录下新增一个配置文件appium.conf：

　　stop on shutdown

　　respawn

　　script

　　. /data/config/config.properties

　　cd /data/log/appium

　　exec appium -a 127.0.0.1 --session-override > appium.log

　　end script

　　这里提一点，在Jenkins机器上跑appium，要想远程连接真机，需要指定ip为127.0.0.1，本机直接运行appium默认的ip是0.0.0.0，这个在Jenkins机器上是无法连接远程真机的。

　　这个配置文件写好保存好之后，我们运行起来就简单了，这里只需要了解三个命令：

　　# 启动appium服务

　　start appium

　　# 停止appium服务

　　stop appium

　　# 查看appium服务状态

　　status appium

　　然后appium的log被重定向到一个自定义的log文件中，就可以在Jenkins Job里输出相关的log内容了。在运行start appium之后，服务在后台运行，Job就可以继续执行后续脚本，达到了一个Job运行appium测试的目的。我目前使用的就是这个方法。

　　方法二

　　appium服务是一个node server，既然这样，那可以选取node应用的相关工具来管理。这里推荐pm2，一个非常强大的node服务管理工具，安装也非常简单：

　　npm install pm2 -g

　　使用的话，如果我们要达到上面方法一的效果，启动appium的命令应该这么写：

　　pm2 start appium -- -a 127.0.0.1

　　其中–代表了后面跟着appium识别的参数，这里并没有重定向log文件，因为pm2已经具备了比较强大的日志管理功能。在~/.pm2/logs/目录下，启动appium之后会生成2个日志文件，一个error的日志，一个普通的log日志，这个就非常强大了，同时提供了

　　pm2 flush

　　可以用来清空日志，重新收集。停止服务也非常简单：

　　pm2 stop appium

　　其他相关用法请自行Google。 记得使用pm2启动服务，一定要设置相应的环境变量，否则GG！

　　环境检查

　　运行appium脚本之前，我们需要通过appium-doctor工具检查运行环境是否都具备了。安装appium-doctor很简单：

　　npm install appium-doctor -g

　　然后检查一下环境：

　　appium-doctor

　　踩坑集锦

　　在Jenkins机器上，Job运行起来之后，报了一个大大的ERROR：

　　An unknown server-side error occurred while processing the command. Original error: JAVA_HOME is not set currently. Please set JAVA_HOME. (Selenium::WebDriver::Error::UnknownError)

　　我就纳闷了，appium-doctor都没问题，怎么跑起来有问题了呢？我又观察了log输出，发现了存在问题的log：

　　[UiAutomator2] Unable to remove port forward 'Error executing adbExec. Original error: 'Command '/data/tools/android_sdk/platform-tools//adb -P 5037 -s 172.22.36.116:7401 forward --remove tcp:8200' exited with code 1'; Stderr: 'error: listener 'tcp:8200' not found'; Code: '1''

　　没看懂什么意思，于是我去Google搜了一波，搜到的信息大多都和我实际遇到的问题无关，包括JAVA_HOME没设置的问题，也没收获。于是我又仔细观察了log，发现了一个疑点：

　　[debug] [UiAutomator2] Deleting UiAutomator2 session

　　[debug] [UiAutomator2] Deleting UiAutomator2 server session

　　[UiAutomator2] Did not get confirmation UiAutomator2 deleteSession worked; Error was: Error: Trying to proxy a session command without session id

　　这个log看起来是有问题的，于是我又去Google搜了一波，依然没什么收获，我以为我的机器有毒，我就回到自己电脑上更新了一下appium，然后本地跑了一波，居然报了同样的错误！这我就不能忍了，本机为什么报这样的错误？既然搜不到，也只能在日志里寻找蛛丝马迹。本机报错的时候，我发现多了一些日志输出：

　　[MJSONWP] Encountered internal error running command: Error: JAVA_HOME is not set currently. Please set JAVA_HOME.

　　at getJavaHome (../../lib/helpers.js:110:9)

　　at getJavaForOs (../../lib/helpers.js:99:17)

　　at ADB.callee$0$0$ (../../../lib/tools/apk-signing.js:106:16)

　　at tryCatch (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:67:40)

　　at GeneratorFunctionPrototype.invoke [as _invoke] (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:315:22)

　　at GeneratorFunctionPrototype.prototype.(anonymous function) [as next] (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:100:21)

　　at invoke (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:136:37)

　　at enqueueResult (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:185:17)

　　at Promise.F (/usr/local/lib/node_modules/appium/node_modules/[email protected]/library/modules/$.export.js:30:36)

　　at AsyncIterator.enqueue (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:184:12)

　　at AsyncIterator.prototype.(anonymous function) [as next] (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:100:21)

　　at Object.runtime.async (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:209:12)

　　at ADB.callee$0$0 [as checkApkCert] (../../../lib/tools/apk-signing.js:106:13)

　　at UiAutomator2Server.checkAndSignCert$ (../../lib/uiautomator2.js:114:33)

　　at tryCatch (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:67:40)

　　at GeneratorFunctionPrototype.invoke [as _invoke] (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:315:22)

　　at GeneratorFunctionPrototype.prototype.(anonymous function) [as next] (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:100:21)

　　at invoke (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:136:37)

　　at enqueueResult (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:185:17)

　　at Promise.F (/usr/local/lib/node_modules/appium/node_modules/[email protected]/library/modules/$.export.js:30:36)

　　at AsyncIterator.enqueue (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:184:12)

　　at AsyncIterator.prototype.(anonymous function) [as next] (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:100:21)

　　at Object.runtime.async (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:209:12)

　　at UiAutomator2Server.checkAndSignCert (../../lib/uiautomator2.js:114:15)

　　at UiAutomator2Server.signAndInstall$ (../../lib/uiautomator2.js:108:16)

　　at tryCatch (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:67:40)

　　at GeneratorFunctionPrototype.invoke [as _invoke] (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:315:22)

　　at GeneratorFunctionPrototype.prototype.(anonymous function) [as next] (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:100:21)

　　at invoke (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:136:37)

　　at enqueueResult (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:185:17)

　　at Promise.F (/usr/local/lib/node_modules/appium/node_modules/[email protected]/library/modules/$.export.js:30:36)

　　at AsyncIterator.enqueue (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:184:12)

　　at AsyncIterator.prototype.(anonymous function) [as next] (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:100:21)

　　at Object.runtime.async (/usr/local/lib/node_modules/appium/node_modules/[email protected]/regenerator/runtime.js:209:12)

　　这段日志显然是非常有用的，我摘取了日志中非常重要的几条信息：

　　我发现出现这个报错的场景是重新安装UiAutomator2相关的2个apk时候报的，大概猜测在重新安装的时候对这两个apk进行了签名相关的校验

　　报错主要的信息应该在uiautomator2.js、tools/apk-signing.js和helpers.js中，这些文件都在appium的node_modules中

　　获得了这些非常有用的信息之后，我打算查一下代码，看看到底是什么问题。首先看uiautomator2.js，这个文件在appium的appium-uiautomator2-driver依赖库中，定位到出问题的代码：

　　async signAndInstall (apk, apkPackage, timeout = SERVER_INSTALL_RETRIES * 1000, test = false) {

　　await this.checkAndSignCert(apk, apkPackage);

　　await this.adb.install(apk, true, timeout);

　　logger.info(`Installed UiAutomator2 server${test ?' test':''}apk`);

　　}

　　async checkAndSignCert (apk, apkPackage) {

　　let signed = await this.adb.checkApkCert(apk, apkPackage);

　　if (!signed) {

　　await this.adb.sign(apk);

　　}

　　return !signed;

　　}

　　checkAndSignCert就是检查并且签名的操作，这部分代码定位到之后，下一步寻找的就是tools/apk-signing.js，这个文件在appium的appium-adb依赖库中，定位到出问题的代码：

　　apkSigningMethods.checkApkCert = async function (apk, pkg){

　　const java = getJavaForOs();

　　if (!(await fs.exists(apk))) {

　　log.debug(`APK doesn't exist.${apk}`);

　　return false;

　　}

　　if (this.useKeystore) {

　　return await this.checkCustomApkCert(apk, pkg);

　　}

　　log.debug(`Checking app cert for${apk}.`);

　　try {

　　await exec(java, ['-jar', path.resolve(this.helperJarPath, 'verify.jar'), apk]);

　　log.debug("App already signed.");

　　await this.zipAlignApk(apk);

　　return true;

　　} catch (e) {

　　log.debug("App not signed with debug cert.");

　　return false;

　　}

　　};

　　继续定位，根据log发现是getJavaForOs方法出了问题，这个方法在helpers.js中，正好与log中下一步的报错信息吻合：

　　function getJavaForOs(){

　　const sep = path.sep;

　　let java = `${getJavaHome()}${sep}bin${sep}java`;

　　if (system.isWindows()) {

　　java = java + '.exe';

　　}

　　return java;

　　}

　　通过日志我们可以看到是getJavaHome方法报错了，继续定位：

　　function getJavaHome(){

　　if (process.env.JAVA_HOME) {

　　return process.env.JAVA_HOME;

　　}

　　throw new Error("JAVA_HOME is not set currently. Please set JAVA_HOME.");

　　}

　　到这里，精准定位问题了，throw的就是最开始的报错信息。原来appium-adb拿到java环境变量是通过process.env获取的，而process.env是node获取环境变量的手段，也就是说，如果没有export java home到环境变量中，这里拿到的肯定是undefined，就会抛出异常。我发现我的mac电脑还真没有export JAVA_HOME，于是我加上了这个变量，重新运行appium，完美运行。

　　为什么升级了一下appium就会出现问题了呢？显然是appium的这些依赖库代码更新了。我在appium的package.json中发现了这么一句依赖：

　　"appium-uiautomator2-driver": "0.x",

　　本机问题解决了，Jenkins机器上报的错是一模一样的，肯定是同样的问题。我仔细检查了Jenkins机器上环境变量的配置，突然发现，环境变量配置文件里只是配置了java home，并没有export！于是我在.bashrc中加了export操作，然后重启了机器，运行了一次Job……

　　失败！

　　求助了一波同事，发现其实我这种start appium的方式，服务运行的环境不一样，所以需要在appium.conf里加一句话：

　　script

　　. /data/config/config.properties

　　# 加的就是这一句

　　export JAVA_HOME=$JAVA_HOME

　　cd /data/log/appium

　　exec appium -a 127.0.0.1 --session-override > appium.log

　　end script

　　果然成功了！

　　总结

　　其实这些问题都不是什么大问题，但是在出现问题之后，我通过各种手段解决了它。最后Job开开心心的跑了起来，我重新配置上了定时任务，让它在迁移机器之后更好的发挥作用，做出更多的贡献！

 

推荐阅读

点击阅读☞

点击阅读☞

点击阅读☞

点击阅读☞

点击阅读☞

---

填问卷，看大牛都在学什么测试新技术！