Troubleshooting iOS Mobile App Builds

iOS 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 
com.rainforestqa.ExampleApp

# terminate app
xcrun simctl terminate BCFE928E-1FFB-446B-A41C-288558412F0D 
com.rainforestqa.ExampleApp

# uninstall app
xcrun simctl uninstall BCFE928E-1FFB-446B-A41C-288558412F0D 
com.rainforestqa.ExampleApp

# 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.

  • Note: If using a Dropbox link, please make sure your it ends in dl=1.
  • See Dropbox help for more info.
  • Some users have used this workaround for Dropbox

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.

If you have any questions, please feel free to reach out to us at [email protected] or through Intercom!

Updated 2 months ago


Troubleshooting iOS Mobile App Builds


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.