Skip to main content

BrowserStack App Automate (XCUI)

Run your XCUI tests on BrowserStack App Automate. This step allows you to send test IPA's to the BrowserStack dashboard and run your test on it.

Prerequisites

Before running the BrowserStack App Automate (XCUI) step, you must complete certain prerequisites, as detailed in the table below:

Prerequisite Workflow StepDescription
Xcodebuild for TestingAfter the Xcodebuild for Testing step runs, the test IPA paths ($AC_TEST_IPA_PATH and $AC_UITESTS_RUNNER_PATH) will be created automatically. So that the BrowserStack component depends on these paths.
Screenshot
danger

In the build step, if there is no Xcodebuild Build for Testing step before BrowserStack, BrowserStack will throw an error and break the pipeline because it cannot find the paths that your step depends on.

Input Variables

The output(s) resulting from the operation of this component are as follows:

Screenshot
Sensitive Variables

Please do not use sensitive variables such as Username, Password, API Key, or Personal Access Key directly within the step.

We recommend using Environment Variables groups for such sensitive variables.

Variable NameDescriptionStatus
$AC_BROWSERSTACK_USERNAMEUsername of the BrowserStack account. It should come from the BrowserStack account.Required
$AC_BROWSERSTACK_ACCESS_KEYAccess key for the BrowserStack account. It should come from the BrowserStack account. For more information, please follow this document.Required
$AC_TEST_IPA_PATHFull path of the IPA file. This path will automatically generate in Xcodebuild for Testing step.Required
$AC_UITESTS_RUNNER_PATHFull path of the *-Runner.app. This path will automatically generate in Xcodebuild for Testing step.Required
$AC_BROWSERSTACK_PAYLOAD$AC_BROWSERSTACK_APP_URL and $AC_BROWSERSTACK_TEST_URL will be auto generated. Please check the documentation for more details about the payload.Optional
$AC_BROWSERSTACK_TIMEOUTBrowserStack plans a timeout in seconds. If there is any problem in BrowserStack, these variables will break the pipeline after a certain time. The default variable is 600 seconds.Required

To access the source code of this component, please use the following link:

Preview of GitHub - appcircleio/appcircle-browserstack-xcui-component