README_EN.md

tidevice

中文文档

Command line tool to communicate with iOS device, support the following functions

• ipa install and uninstall
• launch and kill app
• list installed app info
• retrieve performance data
• screenshot
• simulate run xctest, eg: WebDriverAgent
• other

Install

pip3 install -U tidevice

Usage

Show version number

$ tidevice version
0.1.0

List connected devices

$ tidevice list
List of apple devices attached
00008030-001A35E40212345678 codeskyblue的iPhoneSE

$ tidevice list --json
[
    {
        "udid": "00008030-001A35E40212345678",
        "name": "codeskyblue的iPhoneSE"
    }
]

App management

$ tidevice install example.ipa
$ tidevice install https://example.org/example.ipa

$ tidevice uninstall com.example.demo

$ tidevice launch com.example.demo

$ tidevice kill com.example.demo

# show installed app list
$ tidevice applist

Run XCTest

$ tidevice xctest -B com.facebook.wda.WebDriverAgent.Runner

Other

# mount developer image (need more test)
$ tidevice developer

# reboot device
$ tidevice reboot

$ tidevice screenshot screenshot.jpg

# TODO(ssx): collect performance
# $ tidevice perf -o fps,mem,cpu -B com.example.demo

DEVELOP

See DEVELOP

Thanks

• C implementation https://github.com/libimobiledevice
• https://github.com/facebook/idb
• Python implement of libimobiledevice: https://github.com/iOSForensics/pymobiledevice
• Apple Device Images: https://github.com/iGhibli/iOS-DeviceSupport
• https://github.com/anonymous5l/iConsole
• https://github.com/troybowman/dtxmsg
• https://github.com/troybowman/ios_instruments_client
• Binary of libimobiledevice for Windows http://docs.quamotion.mobi/docs/imobiledevice/
• 使用纯 python 实现 Instruments 协议，跨平台 (win,mac,linux) 获取 iOS 性能数据

LICENSE

MIT