iOS 测试 iOS-remote 安装篇之 ios-minicap 安装使用完全指南

yxys01 · 发布于 2017年10月16日 · 最后由 yxys01 回复于 2017年10月20日 · 920 次阅读
本帖已被设为精华帖!

前段时间,说要做iOS远程真机

最开始是参考了百度项光特大佬的一篇文章:非越狱iOS设备的远程控制实现原理

然后有幸接触到codeskyblue大佬的wdaproxy(ps:这是用go语言实现的)

接着我就写了一篇 iOS 远程真机实现讨论帖!!

后面有幸参与weamylady的iOS_remote项目,iOS-remote是结合WebDriverAgentios-minicap 开源项目做出来的基于JAVA的iOS远程真机控制的项目。

下面我讲一下其中ios-minicap的安装及错误指南

ios-minicap简介

minicap 是开源项目 STF 中的高速截图工具。STF利用此工具不断的传输图片信息并在web端绘制实现

以前只有Android版本,最近有新的ios版本,现在就安装过程中遇到的一些问题进行分享(ps:感谢sorccu 在issue里面给我的指点)

github地址:https://github.com/openstf/ios-minicap

你可以git clone或者直接下载zip包。

安装教程

1、准备工作

$ brew install libjpeg-turbo

$ brew install cmake

2、下载ios-minicap

$ git clone https://github.com/openstf/ios-minicap

3、build项目

$ cd /User/yourname/ios-minicap

$ ./build.sh

$ ./run.sh

运行成功后,不要关闭该终端窗口

4、运行demo

重新打开一个终端端口

$ cd /User/yourname/ios-minicapexample

$ npm install

$ node app.js

全部成功运行后

5、打开浏览器,输入网址http://localhost:9002

Q&A:

在README.MD中请注意下面的安装需求:

这里写图片描述

我最开始没能注意这个要求,就直接./build.sh 当然是各种报错

首先安装 libjpeg-turbo

安装方式:brew install libjpeg-turbo

然后./build.sh是报这个错误

./open_xcode.sh: line 5: cmake: command not found
make: *** No targets specified and no makefile found. Stop.

然后我就去点击那个cmake的链接。。。最坑的来了,官网下载的都是APP文件,而.build.sh 里面内容如下:

#!/usr/bin/env bash

mkdir build
cd build
cmake ../
make

因为安装的cmake是APP,根本无法从脚本直接启动CMakeLists.txt,我就去issue里面提问题,才发现原来可以通过brew直接安装。。。

安装方法:brew install cmake

安装完成之后,再次运行./build.sh,cmake会自动编译配置文件,然后运行./run.sh

$ ./run.sh 

++ system_profiler SPUSBDataType
++ sed -n -E -e '/(iPhone|iPad)/,/Serial/s/ *Serial Number: *(.+)/\1/p'

UDID=0c6cxxxxxxxxxxe76dfdc55b57e0d1502ab92aab
PORT=12345
RESOLUTION=400x600
./build/ios_minicap --udid 0c6cxxxxxxxxxxe76dfdc55b57e0d1502ab92aab --port 12345 --resolution 400x600
EnableDALDevices
2017-07-31 12:24:26.081 ios_minicap[80709:3237274] Available devices:
2017-07-31 12:24:26.081 ios_minicap[80709:3237274] 0c6cxxxxxxxxxxe76dfdc55b57e0d1502ab92aab
2017-07-31 12:24:26.081 ios_minicap[80709:3237274] CC24414NH0XF9T9C7

由于个人隐私原因,将udid部分进行加密(就是用x去替代一部分而已啦)

我以为这个已经是启用成功
重新开启一个终端:
一步一步运行一下代码:

$ cd example

$ npm install

$ node app.js

运行到最后一步开始报错:

Listening on port 9002
Got a client
{ Error: connect ECONNREFUSED 127.0.0.1:12345
at Object.exports._errnoException (util.js:1026:11)
at exports._exceptionWithHostPort (util.js:1049:20)
at TCPConnectWrap.afterConnect [as oncomplete] (net.js:1136:14)
code: 'ECONNREFUSED',
errno: 'ECONNREFUSED',
syscall: 'connect',
address: '127.0.0.1',
port: 12345 }
Be sure to run ios-minicap on port 12345

最开始我也不知道怎么回事,后面才发现,或许是其他终端处理干净,12345端口未被启动或者被占用。

(ps:如果address: '127.0.0.1',一栏中提示的不是127.0.0.1本地地址,那有同学更改了host然后导致报错,将host改回即可)

解决方案:

查看12345端口

$ lsof -i tcp:12345

kill掉12345端口所有的进程(或者强制退出终端)

kill PID

再次在ios-minicap的目录下/run.sh 启动12345端口号:

启动信息如下

++ sed -n -E -e '/(iPhone|iPad)/,/Serial/s/ *Serial Number: *(.+)/\1/p'
++ system_profiler SPUSBDataType
+ UDID=0c6cxxxxxxxxxxe76dfdc55b57e0d1502ab92aab 
+ PORT=12345
+ RESOLUTION=400x600
+ ./build/ios_minicap --udid 0c6cxxxxxxxxxxe76dfdc55b57e0d1502ab92aab --port 12345 --resolution 400x600
EnableDALDevices
2017-07-31 14:43:46.851 ios_minicap[82104:3332798] Available devices:
2017-07-31 14:43:46.851 ios_minicap[82104:3332798] 0c6cxxxxxxxxxxe76dfdc55b57e0d1502ab92aab 
2017-07-31 14:43:46.851 ios_minicap[82104:3332798] CC24414NH0XF9T9C7
resolution: 400x600
Allocating 731648 bytes for JPEG encoder
== Banner ==
version: 1
size: 24
pid: 82104
real width: 400
real height: 600
desired width: 400
desired height: 600
orientation: 
quirks: 1
banner: 118b840109010058200901005820001
New client connection

重开一个终端窗口,定位到ios-minicap里面的example文件夹(就是cd到里面那个文件夹中)运行node app.js

提示:

Listening on port 9002
Got a client

在浏览器中打开http://localhost:9002

即可实时录制屏幕

希望我的指南能帮助你们成功安装ios-minicap。

ios-minicap 终极大招

最后,放上终极大招——我正在使用的,已经编译好的项目文件:

ios-minicap:链接:http://pan.baidu.com/s/1skNaatR 密码:rjs2

同样,如果百度链接挂了,就去CSDN中下载:ios-minicap

如果使用存在问题,应该是路径问题,检查CMakeLists.txt中路径是否更改自己的 ios-minicap的本地路径。

iOS-remote 安装篇

iOS-remote 安装篇之 ios-minicap 安装使用完全指南

iOS-remote 安装篇之 WebDriverAgent 安装使用完全指南

iOS-remote 安装篇之 iOS-remote安装使用完全指南

参考文献

iOS-minicap + WDA 实现 ios 远程真机测试 https://testerhome.com/topics/10262
基于 WebDriverAgent 的 iOS 远程控制 https://testerhome.com/topics/8890
iOS 远程真机 (仅限屏幕查看) https://testerhome.com/topics/6470

致谢

@codeskyblue
@weamylady

欢迎使用以及提出宝贵意见

@seveniruby
@Lihuazhang
@xdf
@chenhengjie123

如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!
共收到 18 条回复
110 Lihuazhang 将本帖设为了精华贴 10月19日 10:46
940906

node app.js 一直卡在Listen on port9002
./run.js启动,到banner:xx,后面没有New client connection,所以http://localhost:9002上咋也没有
怎么破? 咋异常日志都没有。。。
UDID我是直接写死的

25f875
yxys01 · #5 · 2017年10月20日 作者
940906HeartBeat 回复

./run.sh启动吧。。。
不应该吧,一般node app.js至少会有Error的提示吧
eg:

{ Error: connect ECONNREFUSED 127.0.0.1:12345
at Object.exports._errnoException (util.js:1026:11)
at exports._exceptionWithHostPort (util.js:1049:20)
at TCPConnectWrap.afterConnect [as oncomplete] (net.js:1136:14)
code: 'ECONNREFUSED',
errno: 'ECONNREFUSED',
syscall: 'connect',
address: '127.0.0.1',
port: 12345 }
Be sure to run ios-minicap on port 12345

还有udid写死是什么意思??
你是不是没安装libimobiledevice 和 ideviceinstaller?

$ sudo brew update
$ sudo brew install libimobiledevice
$ sudo brew install ideviceinstaller

安装试试?

940906
25f875yxys01 回复

嗯嗯,说错了

25f875
yxys01 · #7 · 2017年10月20日 作者
940906HeartBeat 回复
$ cd /User/yourname/ios-minicapexample

$ npm install

$ node app.js

是不是没有npm install哦?

940906
25f875yxys01 回复

./run.sh中不是有句UDID=$(system_profiler SPUSBDataType | sed -n -E -e '/(iPhone|iPad)/,/Serial/s/ *Serial Number: *(.+)/\1/p')
这个我跑起来UDID获取到的为空,所以我直接写死一个真机的UDID了;
node app.js 我跑起来,只有一句Listen on port 9002,像是卡着了
感谢!
libimobiledevice 和ideviceinstaller我应该装过了的,我再捣腾一下

25f875
yxys01 · #9 · 2017年10月20日 作者
940906HeartBeat 回复

可以先单独试试能不能用$ idevice_id -l获取到真机的udid吧
详情可见:https://testerhome.com/topics/10467
如果不行,可以尝试重新更新下libimobiledevice和ideviceinstaller

$ brew uninstall ideviceinstaller
$ brew uninstall libimobiledevice
$ brew install --HEAD libimobiledevice
$ brew link --overwrite libimobiledevice
$ brew install ideviceinstaller
$ brew link --overwrite ideviceinstaller
940906
25f875yxys01 回复

可以的哦

25f875
yxys01 · #12 · 2017年10月20日 作者
940906HeartBeat 回复

能找到的话,你还是别把udid写死了,然后再试一下?

940906
25f875yxys01 回复

那样获取不到UDID哦,然后我mac上有很多模拟器的

14楼 已删除
25f875
yxys01 · #15 · 2017年10月20日 作者
940906HeartBeat 回复

我的Mac上也有很多模拟器啊。。。应该不是模拟器的问题,是udid的问题。。
你在终端跑下system_profiler SPUSBDataType | sed -n -E -e '/(iPhone|iPad)/,/Serial/s/ *Serial Number: *(.+)/\1/p'看看

940906
25f875yxys01 回复

这个可以的哦

25f875
yxys01 · #17 · 2017年10月20日 作者
940906HeartBeat 回复

你可以把你的run.sh文件里面的内容贴出来我看下吗?我感觉你那里和我的不一样。。。

25f875
yxys01 · #19 · 2017年10月20日 作者
940906HeartBeat 回复

抱歉。。。你这个udid不应该存在读不到的情况啊,我也帮别人安装过几十次ios-minicap了,第一次遇到你这个情况。。。而且还不报错误信息,根本不知道去哪找原因。
给你两个建议
1、删掉整个ios-minicap文件,重新git clone下来一次,别改udid跑一次看下能不能成功?(ps:libjpeg-turbo和cmake一定要确认用命令行安装好了的哈)
2、用我发的终极大招,把我上传那个下下来直接./run.sh试试(ps:如果报错试一下重新build.sh,还报错看下是不是CMakeLists.txt中路径的问题,如果是就把我的路径全部替换成你现在的路径)

别着急,iOS测试框架的使用一大部分时间都会花在环境安装上面,我为什么想写这么详细的安装贴就是因为我当时也是安装了好久这么些东西,甚至去github上提issue;当然,这也不失为一个好方法。

940906
25f875yxys01 回复

😃 嗯嗯,灰常感谢你的指导和帮助哇!我慢慢捣腾下!

940906

@yxys01 再次感谢楼主,之前一直用chrome打开,总报charles error report (我没开charles);换成safari就好了哈哈哈哈

25f875
yxys01 · #22 · 2017年10月20日 作者
940906HeartBeat 回复

可以了就好

需要 登录 后方可回复, 如果你还没有账号请点击这里 注册