To perform Airtest in iOS, the following steps are required
step 1 iOS-Tagent¶
We make some customized optimization and adjustments to it and it works well in:
Other versions of Xcode and iOS are not fully tested and may cause unexpected errors.
iOS-Tagent creates a WebDriver server on your iPhone which makes it possible to remote control iOS devices and locate UI elements.
a. Clone or Download iOS-Tagent
git clone email@example.com:AirtestProject/iOS-Tagent.git
b. Open iOS-Tagent with Xcode and connect your iPhone to Mac with a data cable
WebDriverAgentRunnerin the top menu of Xcode
Destination-> your iPhone
c. Start tests by click
Test. When something like this shows in the log, it means that iOS-Tagent have started successfully.
Test Suite 'All tests' started at 2017-01-23 15:49:12.585 Test Suite 'WebDriverAgentRunner.xctest' started at 2017-01-23 15:49:12.586 Test Suite 'UITestingUITests' started at 2017-01-23 15:49:12.587 Test Case '-[UITestingUITests testRunner]' started. t = 0.00s Start Test at 2017-01-23 15:49:12.588 t = 0.00s Set Up
step 2 Set up proxy¶
iproxy maps the iPhone port to the Mac port, so you can access the phone by accessing the Mac.
The original source code of iproxy is shown in https://github.com/libimobiledevice/libimobiledevice
a. Install iproxy with Homebrew
$ brew install libimobiledevice
b. Run iproxy
$ iproxy 8100 8100
Then try to access http://127.0.0.1:8100/status in your mac browser. If a json data about your iPhone is returned, it means iproxy started successfully. Moreover, you can see iPhone screen projected on the browser by visiting http://127.0.0.1:8100/inspector .
Note that iproxy can only listen to localhost. If you want to connect iPhone on AirtestIDE on a windows OS, you can try wdaproxy. The specific steps are as follows:
- Connect iPhone to Mac with a usb cable.
- Run wdaproxy in Mac. wdaproxy can map the iPhone port to the Mac port too. You can see the installation instruction in https://github.com/openatx/wdaproxy .
- Fill ip address and port of the iPhone (retrieved in the previous step) in the input box of AirtestIDE on Windows and click button “connect”.
step 3 AirtestIDE¶
Connect to the iPhone by ip address, refresh screen, run tests
After the above two steps, you can fill “http://127.0.0.1:8100” in the iOS address input box of AirtestIDE. Click button “connect” to connect your iPhone and start your Airtest test.
Note that you can also view the device Hierarchy
This feature work with Poco and AirtestIDE.
Q & A¶
We have collected a series of common issues on our Q&A. If you have any questions, please take a look at these first. If you can’t find your issue here, or you have any suggestion, please feel free to post it in Issues.
Common API in Airtest is supported
- start_app: OK
- stop_app: OK
- snapshot: OK
- home: OK
- touch: OK
- swipe: OK
- text: OK
- wait: OK
- exists: OK
- find_all: OK
- assert_exists: OK
- assert_not_exists: OK
- wake: Not supported now (may use ‘home’ instead)
- keyevent: Only support ‘home’ event
- clear_app: Not supported now
- install: Not supported now
- uninstall: Not supported now