General settings

Manage your app's general settings

Version files

The file path(s) corresponding to your app's version files. Runway will bump the version in these files during manual or automated version bumps, and parses these files to determine your app's Version in code for the working branch and the release branch.

Version files are populated by default using platform-specific files where versions are commonly found, but you can always customize your app's version files to any files found in your repository.

The default file types that Runway will detect versions in are as follows:

iOS:

  • .pbxproj

  • .xcconfig

  • .plist

  • .json

  • .yaml

Android:

  • .gradle

  • .json

  • .yaml

React Native / OTA:

  • package.json

The table below describes the format (in regex) Runway is expecting to find the version in depending on the file type.

File typeRegular expressionDescriptionExample

.pbxproj

MARKETING_VERSION = (\d+\.\d+\.\d+)

Matches the string MARKETING_VERSION = (case sensitive) followed by one or more digits separated by a . character

MARKETING_VERSION = 12.2.2

.xcconfig

MARKETING_VERSION = (\d+\.\d+\.\d+)

Matches the string MARKETING_VERSION = (case sensitive) followed by one or more digits separated by a . character

MARKETING_VERSION = 12.2.2

.plist

CFBundleShortVersionString<\/key>\s*<string>(\d+\.\d+\.\d+)<\/string>

Matches the CFBundleShortVersionString</key> string (case sensitive) followed by zero or more white space characters (spaces, tabs, line breaks), followed by the <string> string, followed by one or more digits separated by a . character, followed by the </string> string

CFBundleShortVersionString</key><string>2.2.2</string>

.yaml

version:\s+?(\d+\.\d+\.\d+)

Matches the version: string, followed by one or more white space characters (spaces, tabs, line breaks), followed by one or more digits separated by a . character

version: 12.2.2

.gradle

versionName.*?(\d+\.\d+\.\d+)|versionString.*?(\d+\.\d+\.\d+)

Matches the versionName string, followed by zero or more of any character (except line breaks), followed by one or more digits separated by a . character OR the string versionString, followed by zero or more of any character (except line breaks), followed by one or more digits separated by a . character

versionName 12.2.2

.json

\"version\":\s+?\"(\d+\.\d+\.\d+)\"

Matches the "version": string (case sensitive), followed by one or more white space characters (spaces, tabs, line breaks), followed by the one or more digits separated by a . character wrapped in quotation marks

"version": "12.2.2"

Default (all other file types)

(\d+\.\d+\.\d+)

Matches one or more digits separated by a . character

12.2.2

Localization directories

Specify the directory/paths that contain your app's localization files. Localization directories are relevant for teams using the Translations release step to track the status of their localizable strings.

Fixes settings

Configure settings for work item Fixes found on the Feature Readiness step.

  • Require fix approvals: Any work items designated as fixes will require a team member with sufficient privileges to manually approve them before they can be pulled into the release. Approvals can be performed on the Feature readiness release step.

If Require fix approvals is enabled, and the Merge pull requests created by Runway automation is also enabled, Runway will only auto-merge cherry-pick PRs open against the release branch if the fix has been approved in Runway.

  • Add pull request GitHub status check for fix request approvals: Runway will include a status check on any pull requests created for fixes going into the release branch. The status check will only pass when the fix request associated with the PR has been approved.

Last updated