文章目录
- 现象
- 原因分析与解决
- 排查手机内部minicap
- 解决minicap问题
- 查看移动端Android SDK版本
- 查看minicap支持版本
- 单次方案
- 多次方案
现象
原因分析与解决
由于atxserver2在与Android动终端的链接过程中使用了agent：atxserver2-android-provider，按照项目中使用方法成功连接。当运行这个项目后，手机连接入电脑将自动安装minicap、minitouch、atx-agent、whatsinput.apk、app-uiautomator-test.apk。
而负责手机界面传输的则是minicap这一个程序，因此主要的问题肯定存在于minicap中。
排查手机内部minicap
minicap这一程序能够运行的条件需要同时安装minicap和minicap.so两个文件，在手机的/data/local/tmp文件夹下。
使用以下命令可以进入文件夹中查看：（键入exit以退出）
adb shell
cd data/local/tmp
ls
如果文件夹中不存在minicap和minicap.so，表示安装失败；
如果存在，可以运行以下adb命令，测试minicap是否可以运行：
adb shell LD_LIBRARY_PATH=/data/local/tmp /data/local/tmp/minicap -P 2800x1840@2800x1840/0 -t
屏幕大小部分理论上应该填写设备的实际情况，
/0表示设备旋转角度，-t表示测试
minicap正常运行，会有如下图显示；未出现如下图，都可认定为无效minicap，可能是版本/机型不匹配等原因导致的。
如果minicap测试结果正，常还是无法在网页端正确显示，建议重启docker或重新插入移动端。
解决minicap问题
如果是minicap安装，但是测试不通过，需要先删除不匹配的minicap和minicap.so，如下：
adb shell
cd data/local/tmp
rm minicap
rm minicap.so
exit
现象中的第二截图，其实已经提示了出现minicap安装错误的原因：
ATX 此应用SDK版本太低，无法正常运行，请及时更新或联系开发者
安装的应用（minicap）Android SDK版本太低，而移动端系统Android SDK版本太高。
minicap版本太低，是因为官方给出的程序没有进行更新。
查看移动端Android SDK版本
首先，查看移动端Android SDK版本；
移动终端的CPU架构是arm64-v8a，Android SDK的版本31
查看minicap支持版本
通过对于项目源码的分析，项目所指向的minicap下载源openatx/stf-binaries（截止文章时间，master分支对应的tag0.3.2），最新版本只更新到Android SDK 30，如果使用的移动设备Android SDK高于30，则不会安装正确的版本或者直接安装失败。
经过我长时间的研究发现，这一切的原因是uiautomator2这一个库没有实时更新所导致的，那么下面我将会给出两个解决方案。
单次方案
既然能找到对应版本的minicap.so，可以直接将版本匹配的minicap和minicap.so（移动端Android SDK 31）下载，然后推送到移动端，即可解决。
然后通过adb命令推送到移动端：
adb push /home/data/minicap /data/local/tmp
adb push /home/data/minicap.so /data/local/tmp
再次测试minicap是否正常运行；
多次方案
如果有很多移动端需要连接，且版本都不匹配，单个一一推送太麻烦。上文中也提到了错误是因为uiautomator2库没有更新，因此我们就需要自行修改模块中的代码，从而让以后每一台移动端都可以下载版本匹配的minicap.so。
首先先找到自己uiautomator2库安装的位置，本人使用的是pip安装，路径为：
pip3 show uiautomator2
在其中我们需要修改的文件是init.py，有三个地方。我将使用vim界面进行截图，各位可以打开自己的编译器进行修改。
1.文件中211行（minicap）、220行（minitouch），需要修改代码为如图所示的路径：
/0.3.0/node_modules/@devicefarmer替换为/0.3.2/node_modules，因为原路径下版本不匹配；
220可以不修改，minitouch版本没有影响
后续仓库升级，需要修改为最新的tag
2.最后是代码的第378行，需要修改>号后的数字为32（因为当前最高版本为31）
修改完成后，保存退出，然后打开终端运行下面的代码：
python -m uiautomator2 init
执行此命令即将文初提到的五个文件安装到移动端，下载文件会比较慢，耐心等待；
如果出现download error，是因为文件会默认从一个镜像中下载，在镜像中没有Android SDK 32及以后版本的文件，所以会失败，镜像下载失败后，再从github中下载。
如果因为超时失败，就再次运行代码。
最终输出Successfully init AdbDevice就表示安装完成，可以测试minicap是否可用。
测试通过后，重启docker再重连手机，就发现成功显示手机屏幕。
