本文ほんぶん主要しゅよう介かい绍一个基于 uiautomator2 封ふう装そう的てき一いち个 Python 库 android-catcher，该库的てき功こう能のう主要しゅよう有ゆう对 Android 设备进行 UI 自じ动化测试和わ采さい集しゅう手しゅ机つくえ性能せいのう数すう据すえ，适用于如列れつ表ひょう滑すべり动、录制视频等とう各かく种测试场景けい下か CPU、内うち存そん、帧率等とう信しん息いき的てき捕と获，方便ほうべん后きさき续分析ぶんせき。

自じ动化测试的てき脚本きゃくほん是ぜ用よう Python 3 写うつし的てき，要よう运行脚本きゃくほん需要じゅよう先安さきやす装そう Python 3 环境
下しも载地址し： Python 3.6.5

打だ开脚本目ほんめ录执行ぎょう以下いか命令めいれい，安あん装そう依よ赖

pip install -r requirements.txt

安あん装そう完かん uiautomator2 之これ后きさき，一般只需要执行以下命令对设备进行初始化，在ざい设备上安かみやす装そう uiautomator2 服ふく务

python -m uiautomator2 init

出で现以下か提示ていじ则表示ひょうじ安やす装そう成功せいこう

更さら多た的てき uiautomator2 的てき使用しよう方式ほうしき可か参考さんこう：https://github.com/openatx/uiautomator2

这个脚本きゃくほん库根目め录下主要しゅよう的てき文ぶん件けん有ゆう

• info.py：手て机つくえ性能せいのう信しん息いき采さい集しゅう的てき脚本きゃくほん，其中定てい义了父ちち类 Info，已やめ实现的てき子こ类有 CPUInfo(CPU信しん息いき)、MemInfo(内うち存そん信しん息いき)、FPSInfo(帧率信しん息いき)、NetInfo(网络流量りゅうりょう信しん息いき)，使用しよう者しゃ可か以从 Info 派生はせい子こ类来实现自己じこ的てき采さい集しゅう需求
• task.py：测试场景的てき脚本きゃくほん，其中定てい义了父ちち类 Task，因いん为没有ゆう固定こてい的てき测试场景，因いん此使用しよう者しゃ需要じゅよう从 Task 派生はせい子こ类并重じゅう写うつし Task#execute 方法ほうほう来き自じ定てい义的测试场景，自じ定てい义方式しき可か参考さんこう：https://github.com/openatx/uiautomator2
• info_task.py：测试场景和わ采さい集しゅう信しん息いき灵活结合的てき脚本きゃくほん，使用しよう者しゃ不ふ需要じゅよう用よう到いた
• utils.py：工具こうぐ方法ほうほう脚本きゃくほん
• _main_.py：任にん务运行ぎょう的てき入口いりくち脚本きゃくほん，当とう没ぼつ有ゆう具体ぐたい的てき测试场景，只ただ是ぜ想そう采さい集しゅう指定してい时间段だん的てき信しん息いき，直接ちょくせつ运行该脚本きゃくほん

• -s：必选参さん数すう，指定してい设备号ごう，可か通どおり过 adb devices 获取
• -a：必选参さん数すう，要よう测试进程的てき applicationId
• -f：可か选参数すう，采さい样间隔，单位为秒，不ふ建けん议设置おけ太ぶと短みじか，最さい好こう是ぜ大だい于 0.1s，默だま认是 1s
• -d：可か选参数すう，采さい样持续时间，默だま认为10s
• -i：可か选参数すう，需要じゅよう采さい集しゅう的てき信しん息いき，可か以设置おけ多た个，目前もくぜん可か选的有ゆう四よん个，分ふん别为 cpu、mem、fps、net，用よう "," 隔へだた开，如 -i cpu,mem,fps,net
• -o：可か选参数すう，采さい集しゅう到いた的てき信しん息いき的てき输出目め录，如 "." 表示ひょうじ当とう前ぜん脚本きゃくほん所在しょざい的てき目め录，默だま认为 "."

采さい集しゅう到いた的てき信しん息いき根ね据すえ信しんじ息いき类型分ぶん别存放ひ在ざい指定してい输出目め录的 cpu_stats、mem_stats、fps_stats、net_stats 四个子目录下，文ぶん件名けんめい为 信しん息いき类型_设备号ごう_applicationId_版本はんぽん号ごう_测试场景名めい_时间戳，如 cpu_d3c2edaa_video.like_RecordVideo_1.9.9_1524122928.csv.csv，实际效果こうか大だい致如下か图

输出文ぶん件けん为 csv 文ぶん件けん，直接ちょくせつ打だ开和用よう Excel 打だ开的效果こうか分ぶん别如下か图


另外可か以为测试的てき每まい个阶段だん添加てんか一いち个节点てん说明

task.period = "idle"

生成せいせい类似如下的てき图

适用于没有ゆう具体ぐたい测试场景，在ざい脚本きゃくほん运行之の后きさき一段时间内都处于采集状态的情况，持じ续时间可以通过配置はいち参さん数すう指定してい，过程中ちゅう使用しよう者しゃ可か以随意ずいい操作そうさ手しゅ机つくえ。通つう过命令れい行ぎょう直接ちょくせつ运行 _main_.py 脚本きゃくほん文ぶん件けん，并指定してい相しょう关参数すう 比ひ方かた说我要よう采さい集しゅう applicationId 为 video.like 这个应用 10s 内的ないてき cpu 信しん息いき和わ内ない存そん信しん息いき，采さい样间隔为 200ms，输出目め录为当とう前目まえめ录，那な么可以在脚本きゃくほん所在しょざい的てき目め录执行ぎょう以下いか命令めいれい

python _main_.py -s 设备号ごう-a video.like -f 0.2 -d 10 -i mem,cpu -o .

脚本きゃくほん运行结束之の后きさき可か以在根ね目め录下看み到いた如下图所示しめせ的てき文ぶん件けん生成せいせい

注ちゅう：要よう带 -d 参さん数すう，指定してい采さい集しゅう的てき持もち续时间，否いや则脚本きゃくほん默だま认运行ぎょう 10s，并且无需 -t 参さん数すう，默だま认测试场景けい名めい为 Random

自じ定てい义测试场景けい不能ふのう直接ちょくせつ调用 _main_.py 脚本きゃくほん，需要じゅよう创建新しん的てき脚本きゃくほん，继承 task.py#Task 并重写うつし Task#execute 方法ほうほう，在ざい Task#execute 中ちゅう实现自じ定てい义测试场景けい的てき逻辑，如下图所示しめせ：

这里创建了りょう名めい为 start_app.py 的てき脚本きゃくほん，运行命令めいれい：

python start_app.py -s 设备号ごう-a 进程名めい -f 0.1 -i cpu,mem -o .

就可以启动对应的 APP，并采集しゅう CPU 信しん息いき和わ内ない存そん信しん息いき，采さい样间隔为 100ms，输出到いた当とう前目まえめ录。注意ちゅうい这里没ぼつ有ゆう了りょう -d 参さん数すう，因いん为采集しゅう的てき持もち续时间以测试任にん务的持じ续时间的持じ续时间为准なぞらえ，设置的てき参まいり数すう一定要按照说明来，否いや则不能ふのう采さい集しゅう到いた数かず据すえ 如果想そう采さい集しゅう自じ定てい义的信しん息いき，可か以继承うけたまわ info.py#Info 并重写うつし Info#get_start_info 和わ Info#get_end_info 方法ほうほう，可か参考さんこう已やめ实现的てき四种信息采集的写法，最さい后きさき通どおり过 Task#add_info 方法ほうほう添加てんか。

自じ定てい义好测试场景之の后きさき，调用 _main_#main 方法ほうほう，传入测试场景实例，测试场景的てき名称めいしょう会かい作さく为输出で文ぶん件けん命名めいめい的てき一いち部分ぶぶん，这里最さい好こう取と能のう准じゅん确表达测试场景けい的てき名称めいしょう，如某个 APP 录制视频测试场景的てき名称めいしょう为 RecordVideo 采さい集しゅう到いた的てき信しん息いき可か通どおり过 Excel 制せい成なり图表，以下いか是ぜ完かん整せい录制视频这个测试场景的てき CPU 占うらない比和ひわ内ない存そん的てき变化

通つう过图表ひょう可か以直观分析应用よう不同ふどう版本はんぽん和わ不同ふどう场景下か的てき性能せいのう状じょう况

以上いじょう就是该库的てき一些使用介绍。由よし于工作こうさく经验尚ひさし浅あさ，Python 也是现学现用，在ざい写うつし这个库时，可能かのう会かい有ゆう许多考こう虑不周しゅう或ある不ふ完かん善ぜん的てき地方ちほう，有能ゆうのう力りょく的てき小しょう伙伴可か以直接ちょくせつ修おさむ改あらため该库，以实现更多た自じ定てい义功能のう，另外也希望きぼう大家たいか能のう多用たよう，多た发现问题，欢迎 issue，欢迎 star，有ゆう新しん的てき使用しよう需求和わ想そう法ほう也欢迎むかえ提出ていしゅつ，后きさき续会不断ふだん完かん善ぜん，感かん谢！