How to Generate a File for testRigor iOS Simulators

Kevin Carroll

To test an iOS application on testRigor infrastructure it is important to remember that we use simulators. At the moment, testing on real devices is possible by integrating a 3rd party device farm like LambdaTest with testRigor.

Our simulators are able to test iOS applications compiled for x86 (Intel chips) or arm64 (Apple Silicon chips). The following steps describe the process to correctly generate an iOS application file ready to upload to testRigor.

1. Open the application in Xcode.
2. Click the application name at the top of the application.
   
3. Select a simulator device.
4. Setting the correct scheme is a one-time process if it has not been done before:
   • Click the application name at the top of the application.
   • Select Edit scheme.
   • A pop-up will open.
   • Select Release from Build configuration.
   • Click the Close button at the bottom right of the popup.
5. Select the device from the list at the top menu.
6. Click Product in the menu bar at the top of the screen.
7. Select Build. This will cause your app to render a new .app file, which may take a few minutes, but you should be able to continue the process up to Step 18.
8. Click Xcode on the right of the Apple logo ( or ) at the top of the screen.
9. Select Preferences or Settings.
10. Select the Locations tab in the popup that opens.
11. Click the right arrow ( or ) on the right of the Finder directory below Derived data.
12. Open the DerivedData folder.
13. Open the folder with the name of the desired app/build (this might have a randomized string of characters added to the name).
14. Open the Build folder.
15. Open the Products folder.
16. Open the Release-iphonesimulator folder.
17. The latest build should be in that folder; you can distinguish it from other files of a similar name by the date and time of creation. If it has not finished rendering, allow it to complete the process before moving on to the next step.
18. Add the extension .app to the name of the file once it has completed rendering.
19. Right click on the file with the application name + the .app extension (e.g., myiosfile.app).
20. Select Compress.
21. The file should now have the .zip extension.

Now you are ready to begin testing your iOS application on testRigor. If you have already created your iOS suite, simply upload the filename.app.zip file into the file input in Test Suite Details. If you have yet to create your test suite, the filename.app.zip file will need to be ready before attempting to do so.