Signing the WebDriverAgent project to be able to build and install on real iOS devices

[Jacobvu84]

• Official guidelines can be found in http://appium.io/docs/en/drivers/ios-xcuitest-real-devices/#basic-manual-configuration

• We need to install WebDriverAgent to the device in order to manipulate the our application from test scripts.

• But first, we need to configure for signing the WebDriverAgent project which located in the Appium installation folder.

• Locate WebDriverAgent Xcode project

  • Appium desktop - usually use for inspection purpose

  • /Applications/Appium.app/Contents/Resources/app/node_modules/appium-webdriveragent/WebDriverAgent.xcodeproj

  • Appium Node modules - use for running automation test scripts.

  • /usr/local/lib/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent/WebDriverAgent.xcodeproj

  • Note: make sure you know where the Appium instance you are using.

• Check the WebDriverAgent.bundle file located in the folder

  • ./WebDriverAgent/Resources/WebDriverAgent.bundle. Otherwise you need to download by using:
  • mkdir -p Resources/WebDriverAgent.bundle
  • ./Scripts/bootstrap.sh -d

• Open WebDriverAgent.xcodeproj in Xcode

• Login your Apple account: Xcode → Preferences → Add the account.

  • In order to use vn.test.automation provisioning, your devices need to be registered to the LINE Corporation Apple account.
  • Otherwise, you can use Personal Team.

• On the left side panel, click on the WebDriverAgent to see the project setting

• Configure targets. Open the Targets → WebDriverAgentLib

  • If you are using LINE Corporation provisioning (only members who have been added to the LINE Corporation Apple account can use this configuration).
  • Apple development certification for building WedDriverAgent app.
    • Import the private key Naver_Vietnam_Test_Automation_iOS_Development.p12
  • Enter private key password: NONE or get from Shared accounts information
  • Import the developer certification: Naver_Vietnam_Test_Automation_iOS_Development.cer
  • Import the mobile provisioning: Naver_Vietnam_Test_Automation_Development_Provisioning.mobileprovision
  • You need to change bundle identifier of WebDriverAgent's build targets by using vn.test.automation.* prefix.
  • In the General tab, change the Bundle Identifier to vn.test.automation.wda.lib
  • Signing → Uncheck "Automatically manage signing"
  • Signing (Debug) → Team: "NAVER Japan K.K"
  • Signing (Release) → Team: NAVER Japan K.K"
  • Signing Certificate: iOS Developer
  • Repeat steps mentioned above for the target WebDriverAgentRunner.
  • Change the Bundle Identifier under the Build Setting tab → Product Bundle Identifier to vn.test.automation.WebDriverAgentRunner
  • Repeat steps mentioned above for the target IntegrationApp.
  • Change the Bundle Identifier under the Build Setting tab → Product Bundle Identifier to vn.test.automation.IntegrationApp
  • If you are using Personal Team:
  • Signing → Check "Automatically manage signing"
  • Bundle Identifier can be changed to any unique id.
  • Suggestion: Use Get Personal Team ID as the Bundle Identifier prefix. The Bundle Identifier off the target will become .wda.lib
  • Repeat steps mentioned above for the target WebDriverAgentRunner.
    • Change the Bundle Identifier under the Build Setting tab → Product Bundle Identifier to .WebDriverAgentRunner
  • Repeat steps mentioned above for the target IntegrationApp.
  • Change the Bundle Identifier under the Build Setting tab → Product Bundle Identifier to .IntegrationApp

[Jacobvu84]

Troubleshooting

• If the system ask your password too many times, try the trick:
  • Open your Keychain Access → Right click on "Login" → Lock Keychain "login".
  • Right click again and unlock the Keychain "login"

[Jacobvu84]

• How to automate the iOS application with Appium on Real device https://git.linecorp.com/gist/hiroaki-ozono/cff30ca166687d66fd4523f5a0408735
• Getting Started Guide - iOS
• The XCUITest Driver for iOS http://appium.io/docs/en/drivers/ios-xcuitest/
• Appium XCUITest Driver Real Device Setup - http://appium.io/docs/en/drivers/ios-xcuitest-real-devices/
• https://github.com/appium/appium-xcuitest-driver/blob/master/docs/real-device-config.md#full-manual-configuration