To run tests on an iOS VM, follow these steps to set up your app as a
.app file. Make sure to install the Xcode command line tools.
Generate a simulator build using the
xcodebuild command. To create simulator builds, you must build your app for x86 64-bit. The command you run to create the build should look similar to this:
xcodebuild ENABLE_BITCODE=NO -workspace '/path/to/YourWorkspace.xcworkspace' -scheme 'myScheme' -arch x86_64 -sdk iphonesimulator
|ENABLE_BITCODE=NO||Turns off bitcode for the build.|
|-workspace||Takes your |
|-scheme||This is the build scheme.|
Note that you can also use
|-arch x86_64||Sets the build to 64-bit, which allows it to run on simulators.|
If you need to build a 32-bit version, use
|-sdk iphonesimulator||Sets the sdk to simulator.|
If you want a specific SDK, you can list your installed SDKs using the command
Depending on your setup, you may need to use the option
-configuration 'Debug' or
-configuration 'Release'. For more information on
xcodebuild, see Apple’s developer documentation.
- Test your app on a local iOS simulator by dragging and dropping the file onto your local Xcode simulator. If it doesn’t work in your local simulator, it won’t work in ours.
- Zip the
.appfile. Rainforest supports
- Make sure the file is not
.ipa, which would only work on real devices, whereas
.appcan be used on simulators.
After setting up your application for testing, there are 3 options for uploading the app to Rainforest:
- Uploading in-app
- Uploading via the CLI
- Uploading via a direct download link
If your app doesn’t load properly, check out Troubleshooting Mobile Builds.
Rainforest allows mobile app uploads in your Sites and Environments settings.
- Click the Settings icon (gear) in the navigation bar, then click Sites.
- Select the Apps tab, then click the New Mobile Site link.
- Give the app a unique name.
- Select the appropriate app type and add any URL. Then, click Done.
- Click the Edit icon (pencil) next to the app you added. Then, click the Upload button.
To upload your mobile app via the CLI, install the Rainforest command-line interface. For more information, see How to Install the CLI.
- After setup, use the following CLI command to view your list of environments:
rainforest environments --token YOUR_TOKEN
- Use this command to view your list of sites:
rainforest sites --token YOUR_TOKEN
- Look up the relevant site ID and environment ID using the Sites and Environments page in Rainforest.
- Use this command to upload your app.
rainforest mobile-upload --token YOUR_TOKEN --site-id 1234 --environment-id 5678 my_app.apk
Note: Rainforest stores your app in a secure, nonpublic location.
- Return to the Settings page to view your newly uploaded app.
Use a direct download link as an alternative to uploading your app via the CLI or in-app.
- Generate a simulator build using the
xcodebuildcommand. See Setting Up iOS Builds.
- Host your app somewhere that supports direct downloads. The hosted file URL must be a direct download link.
- Go to Settings > Sites.
- Under Apps, click the New Mobile Site link and set the type to “iOS VM.”
- Add the URL for your direct download.
Rainforest automatically downloads and installs your iOS application on our VMs from this URL when you run a mobile test.
- Use the "+ New Mobile Site" button to add another mobile application
- Repeat one of the options above to add more applications
If you have any questions, reach out to us at [email protected].
Updated 2 months ago