Skip to end of metadata
Go to start of metadata

Using Self-Signed Application Files

If you need to maintain your own provisioning profile in the .ipa file, you should disable the App Resigning option when you set the Device Settings for your app in the cloud. You can also use the Appium capability resigningEnabled=false to disable app resigning. This option is available for private devices only.

Using .app files with our XCUI test runner

Our XCUI test runner accepts both .app and .ipa file formats for the --app and --test parameters.

iOS Application

All the build types listed below are supported, since we use a resigning process to embed our own provisioning profile into the uploaded .ipa file. With our own profile in place, the application will be allowed to install and launch on the cloud devices. The functionality of the application itself remains completely unmodified.

You can also use .ipa files generated by build tools outside of Xcode.

Building an .app Bundle

  1. Open your application project in Xcode.
  2. Select Generic iOS Device as your project's device target.
  3. In the Product menu, select Clean.
  4. In the Product menu, select Build.
  5. Navigate to your Xcode project's Products directory and find the generated .app file.
  6. Create an empty directory with the name Payload.
  7. Move the .app file inside the Payload directory.
  8. Compress the Payload directory into an archive (.zip file) and give it a new name with .ipa appended to the end of the file name.
    The .ipa file is now ready for upload to Sauce Labs.

Building an .ipa File

You can use any of the existing methods of distribution for your iOS app, except for the App Store type. This means that you can choose any of the three other export methods: Ad Hoc, Enterprise, Development.

  1. Open your application project in Xcode.
  2. Select Generic iOS Device as your project's device target.
  3. In the Product menu, select Clean.
  4. In the Product menu, select Archive.
    When the archiving process completes, you will see your application listed under Archives
  5. Select your application and click Export
  6. When prompted for an export method, select Ad Hoc, Enterprise or Development.
  7. Set these Distribution options:
    1. App Thinning: None
    2. Clear the selection Rebuild from Bitcode
    3. Strip Swift symbols is optional
    4. Clear the selection Include manifest for over-the-air installation
  8. Select your Distribution Certificate and Provisioning Profile (Automatic or Manual).
    This will generate the .ipa file. 
  9. When the file generation process completes, click Export and choose where to save the .ipa file.
  10. This .ipa file is now ready for upload to Sauce Labs.

XCUI test package

-Runner.app 

  1. Open your application project in Xcode.
  2. Select Generic iOS Device as your project's device target.
  3. Make sure that the your UI tests are part of a Target Membership and that those Targets are selected to be built in your Xcode Build scheme.

    Targets containing UI Tests are typically selected to be built at the "Test" build action.
  4. Launch the Build action, which is set to generate your test packages.
  5. Navigate to your Xcode project's Products directory and find the generated -Runner.app files.
  6. The -Runner.app files are ready to be used in the --test parameter of our XCUI test runner.

.ipa (Optional)

  1. Create an empty directory name Payload.
  2. Move the -Runner.app to the Payload directory
  3. Compress the Payload directory into an archive (.zip file) and give it a new name with .ipa file format ending.
  4. The .ipa file is ready to be used in the --test parameter of our XCUI test runner.
  • No labels