- Print
- DarkLight
What are Environment Variables?
Note: Before using this feature, a developer must define the code that handles boot arguments.
On iOS, environment variables refer to boot variables. The behavior of this feature changes depending on the predefined code in the app. After the code is changed, you can use this feature to pass specific values to the app. For example, you can use environment variables to:
- Change the server endpoint for each scenario
- Change the application state for each scenario
App Prerequisites
To use this feature, the app must be able to handle boot variables. Below is a sample code in Swift. The value of <Key>
in the sample code must be the same as the Key registered in Autify.
#if DEBUG
if ProcessInfo.processInfo.environment["<Key>"] ! = nil {
// Do something
}
#endif
For more information on Swift's ProcessInfo class, please refer to Apple's official documentation.
How to Create Environment Variables
iOS
Click [Environment Variables] on the left sidebar
Click the [iOS] tab
Click [Create Environment Variables] and add the required data.
Let's take a look at what each input item means.
- Name
- A unique value to identify the environment variable you are creating
- Key
- Variable name
- Value
- Variable value
- Description (optional)
- Description of the environment variable
- Click [Create]
Android
When using environment variables in Android, you must specify appPackage and appActivity.
Click [Environment Variables] on the left sidebar
Click the [Android] tab
Click [Create Startup Activity]
Add the required data
※As mentioned above, you must specify appPackage and appActivity when using environment variables in Android.
Please select them in the Key section and create each.
Description of commonly used keys and values:
appPackage (Required)
Package name
Example value:
com.example.app
appActivity (Required)
Activity name
Example value:
.ExampleActivity
optionalIntentArguments (Optional)
- Intent Argument. When using this key, its value must include the option as described in the Specification for intent arguments section in the official documentation.
- Example values:
Name Key Value Example 1 optionalIntentArguments --es API_URL example.com Example 2 optionalIntentArguments --el USER_ID 127
Click [Create]
How to edit and delete environment variables
You can delete and edit environment variables on the Environment Variable List Page.
How to Use Environment Variables in Scenarios
You can use environmental variables on the build file selection page in new scenarios, existing scenarios, or when creating a new Step Group.
Select the target build file.
Select the [Set environment variables] button.
Select the environment variable you want to use.
Click [Select].
Others
- There is no upper limit to the number of environment variables that you can have.