For ensuring the quality of our iOS Apps during development and testing, we decide to use Jenkins jobs to test it on WeTest cloud devices for every update of our app. After investigating various tools, we are going to use gtest + gmock as the unit test framework and Appium as the UI test framework for the SDK.
We describe the Appium solution below, including Appium mechanism, steps to setup Appium locally and integrating our tests into Jenkins jobs. Setting up Appium locally is just for running and checking test cases, while the Jenkins job with the WeTest Automated Test Plugin are triggered to start automation test on WeTest cloud mobile devices for each release during the whole development lifecycle.
1. Appium Mechanism
This is a typical Client-Server architecture. XCode or xcodebuild command installs and launches WebDriverAgentRunner app in the iOS device. This app accepts HTTP command, parse it and call underlying XCTest.framework interfaces to control the app under test.
- Automation script was written in Python or Java.
- WebDriverAgentRunner is the command server accepting HTTP commands and the target app of WebDriverAgent that is an open-source iOS automation tool originally developed by Facebook and now maintained by Appium.
- Appium server is a bridge accepts automation script requests and then call related WebDriverAgent HTTP commands.
- XCTest.framework — It is an Apple official iOS framework provides interfaces to interact with app UI.
2. Setting up Local Appium Test Environment
Dev Env: XCode, Command Line Tools, python, pip, HomeBrew, node , npm, libimobiledevice tools
Install all dev env dependencies.
- XCode can be installed via Mac AppStore or downloaded from https://developer.apple.com/download/all/?q=xcode
- Command Line Tools can be downloaded from https://developer.apple.com/download/all/?q=xcode
- node and npm
- Appium can be installed via Appium Desktop (releases page) or via npm. We use the latter one.
- libimobiledevice tools
So far, all dependencies have been installed. We can run ‘appium-doctor - -ios’ to verify the Appium installation. Appium doctor would check multiple dependencies. Only the “necessary dependencies” are needed, so we ignore the optional dependencies currently.
3. Debugging on the Device
As I said before, WebDriverAgentRunner is a controlling app running in the iOS device. Appium have already integrated it into its installation folder. We can launch WebDriverAgent.xcodeproj in the following path:
Then, we change WebDriverAgentLib and WebDriverAgentRunner to “Automatically manage signing” as the screenshot below
1) Launch WebDriverAgent.xcodeproj project in XCode
2) Click WebDriverAgent project name as shown in the upper left rectangle of the following screenshot
3) Click the “Signing & Capabilities” tab
4) Switch to target WebDriverAgentLib and click “Automatically manage signing”. Choose a developer team name in the “Team” select box.
5) Switch to target WebDriverAgentRunner and click “Automatically manage signing”. Choose a developer team name in the “Team” select box.
Select the Target as WebDriverAgentRunner and Select a target device. Then, launch it from Xcode menu item “Product / Test”
Xcode Console will print messages when running . You might enable it from menu item “View / Debug Area / Activate Console”
When ServerURLHere is shown, the WebDriverAgentRunner is succesfully launched and waiting for commands over HTTP.
Then, stop the running WebDriverAgent project and close XCode completely. Appium will internally handle to launch the WebDriverAgentRunner automatically.
Start Appium — Just run ‘appium’ in the Terminal
Run a simple test script：
4. Jenkins — Submitting Test Tasks to WeTest Device Cloud
WeTest Automated Test Plugin
Follow the steps in https://www.wetest.net/documents/detail/automation/wRW21ryg to install and configure the WeTest Jenkins plugin.
Prepare the Appium automated test script
WeTest provides an sample script in the Github repository: https://github.com/WeTestQuality/WeTest-Automated-Testing/tree/main/samples/iOS/Appium/python
We follow the sample script to create our test script zip package by running the create-zip.sh (https://github.com/WeTestQuality/WeTest-Automated-Testing/blob/main/samples/iOS/Appium/python/create-zip.sh) . Then, we renamed the zip file to “ArchiveTestAppiumDemo1.zip” as shown in screenshot below.
Please note that there is a line “mv $UPLOADDIR/TEST-*.xml $UPLOADDIR/TEST-ALL.xml” in the runTest.sh is needed for generating the TEST-ALL.xml result file, which WeTest leveraging it to generate the Report Analysis.
Submit test tasks to WeTest
We configure the Build section and set ipa file path and script zip file path to Plugin settings. The paths must be absolute paths. Device groups can be manually configured. Tests would run in parallel in those devices in the selected device group.
Click “Build Now” of the job and and view result report URL from the Console Output
5. Retrieving the Test Result and Analysis
All test analysis in one view. Go to https://console.wetest.net/app/testlab/automation/reports and get the test report.
Exporting Appium Script Output
WeTest provides either download script log from the page (The Script Log button in the following screen)
Or, retrieve it from the REST API “Get Results of Devices in Test” https://www.wetest.net/documents/detail/automation/v4W7Vvyn#2.get-results-of-devices-in-test
We try to call (replace <SecreId>:<SecretKey> with the secret id and secret key got from the Account Settings page)
Then it would return the JSON result with script_log_url. script_log_url is a link to the logs zip file. Download it and unzip it, the Appium script output (filename: runTest.log) along with other logs reside in it.
WeTest provides maximum mobile device coverage and an easy way to automate Appium test using powerful REST APIs and Jenkins plugin. We can integrate it with other CI/CD system. Due to ease of running tests in parallel on WeTest, we can increase quality and velocity with the cloud-based digital quality platform in the whole development lifecycle.