Testing iOS applications on VMs

Rainforest supports testing native Android phone and tablet applications.

Creating a new native iOS app test

Be sure to have your mobile applications set up in your Sites and Environments before proceeding.

  1. Create a new test for your native iOS application.
    Click New Test, then select ‘App’

Note: Plain English should be left as the Test Language of the test. Rainforest Automation is not available for mobile testing yet.

2. Click the App Source drop-down.
Select the URL for the file you wish to test.

Note: As Rainforest will automatically download, install and start your application for testing, you cannot select non-iOS VMs for this test.

3. Start a run, Select the iOS VM from the Platforms section.

Can I reuse my existing web tests?

In most cases, a company’s web app and native app are fundamentally different, so you will not be able to reuse your existing web tests for your native app. However, in some cases, you can (and should!) reuse the work that you have already done.

If your mobile and web apps are very similar, you can simply copy the appropriate tests for your web app to a new test for your mobile application.

Native mobile app and web application tests are separated in the Rainforest interface since they cannot share a starting URL.

  • The URL for a web browser test serves as a direction for the testers
  • The URL for a native app test is a source, where Rainforest will access and install your native application


App won’t load? Take a look at the following

Testing your build

If your app is not running properly on Rainforest’s VMs, we strongly recommend that you test it locally to ensure that your application is configured properly for running in a simulator. Try the following code to test that your build loads as expected on a simulator.

# list devices
xcrun simctl list
Ex: iPhone 7 (BCFE928E-1FFB-446B-A41C-288558412F0D) (Shutdown)

# open the simulator
open -a /Applications/Xcode.app/Contents/Developer/Applications/Simulator.app/Contents/MacOS/Simulator --args -CurrentDeviceUDID BCFE928E-1FFB-446B-A41C-288558412F0D

# install .app
# xcrun simctl install
xcrun simctl install BCFE928E-1FFB-446B-A41C-288558412F0D /tmp/Example.app

# get bundle ID
osascript -e 'id of app "/tmp/Example.app"'
# Ex: com.rainforestqa.ExampleApp

# launch app
#xcrun simctl launch
xcrun simctl launch BCFE928E-1FFB-446B-A41C-288558412F0D

# terminate app
xcrun simctl terminate BCFE928E-1FFB-446B-A41C-288558412F0D

# uninstall app
xcrun simctl uninstall BCFE928E-1FFB-446B-A41C-288558412F0D

# shutdown the simulator
xcrun simctl shutdown BCFE928E-1FFB-446B-A41C-288558412F0D 

Make sure your app URL is a direct download link

The hosted file URL must be a direct download link. If this is not the case, Rainforest will not be able to install the .apk file.

Verify Site URL

Rainforest will add a trailing slash "/" when creating the test. This will sometimes lead to an error that does not allow the test to direct to the correct URL which will fail the test. This can be avoided by adding a "#" to the end of your app source URL.

Whitelist IPs

Our testers come from various IP address, secure environments will often block testers from reaching your site. Whitelisting Rainforest IP addresses may be required.

Did this answer your question?