latest_appcenter_build_number plugin

Getting Started

This project is a fastlane plugin. To get started with fastlane-plugin-latest_appcenter_build_number, add it to your project by running:

fastlane add_plugin latest_appcenter_build_number

About latest_appcenter_build_number

Use AppCenter API to get the latest version and build number for an App Center app

Example

You can fetch the latest version for a given app with the following command in your Fastfile:

version_number = latest_appcenter_build_number

this will use the environment variable APPCENTER_API_TOKEN to fetch the list of apps for a given owner account, and then prompt you for which one to use. This can also be specified as a parameter, e.g.:

version_number = latest_appcenter_build_number(api_token: "my-APPCENTER-api-token")

The parameters owner_name and app_name, or environment variables APPCENTER_OWNER_NAME, and APPCENTER_APP_NAME, can also be set:

version_number = latest_appcenter_build_number(
  api_token: "my-APPCENTER-api-token", # note that this will need to be generated from here: https://appcenter.ms/settings/apitokens
  owner_name: "owner-name",
  app_name: "My-Awesome-App"
)

You can then use version_number for whatever purpose you required, including updating the shortVersion or buildNumber of your Xcode project.

Replacing latest_hockey_build_number

If you're using this as a direct replacement for the old latest_hockey_build_number having migrated your apps to AppCenter, you should change instances of this:

latest_hockey_build_number(api_token: "my-HOCKEY-api-token", bundle_id: "com.example.my-awesome-app")

to this:

latest_appcenter_build_number(
  api_token: "my-APPCENTER-api-token", # note that this will need to be generated from here: https://appcenter.ms/settings/apitokens
  owner_name: "owner-name",
  app_name: "My-Awesome-App"
)

To find out your app_name correctly, head to https://appcenter.ms/apps?os=All. Your app_name will most likely be what's listed under the 'Name' column but with hyphens instead of whitespace.

To find out your owner_name correctly, head to https://appcenter.ms/settings/profile. Your owner_name will most likely be what's listed under the 'username' field.

Run tests for this plugin

To run both the tests, and code style validation, run

rake

To automatically fix many of the styling issues, use

rubocop -a

Issues and Feedback

For any other issues and feedback about this plugin, please submit it to this repository.

Troubleshooting

If you have trouble using plugins, check out the Plugins Troubleshooting guide.

Using fastlane Plugins

For more information about how the fastlane plugin system works, check out the Plugins documentation.

About fastlane

fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out fastlane.tools.