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
Turns off bitcode for the build.
This is the build scheme.
Sets the build to 64-bit, which allows it to run on simulators.
Sets the sdk to simulator.
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
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.
If you have any questions, reach out to us at [email protected] or via the chat bubble below.
Updated 3 months ago