bitrise plugin

Getting Started

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

fastlane add_plugin bitrise

About bitrise

This plugin allow you to trigger a specific Bitrise workflow with some arguments with a HTTPS POST request on the Bitrise.io API.

It also allow you to override some environments variables.

It can help you to automatically trigger a build after a bump commit for instance without have to log into bitrise.io.

Options

Option	Description	Type	Requirement	Environment Variable
`app_slug`	Bitrise application slug, avalaible on bitrise.io > your app > code	String	Mandatory	`BITRISE_APP_SLUG`
`trigger_token`	Bitrise build trigger token, avalaible on bitrise.io > your app > code	String	Mandatory	`BITRISE_TRIGGER_TOKEN`
`workflow`	Bitrise workflow to trigger, if not specified, it'll trigger the default one	String	Optional	`BITRISE_WORKFLOW`
`author`	Desribe who triggered the build. It'll appear on the Bitrise.io build	String	Optional	`BITRISE_AUTHOR`
`build_message`	Build message who'll appear on the Bitrise.io build	String	Optional	`BITRISE_BUILD_MESSAGE`
`branch`	The git branch to build	String	Optional	`BITRISE_GIT_BRANCH`
`commit`	The git commit hash to build	String	Optional	`BITRISE_GIT_COMMIT`
`tag`	The git Tag to build	String	Optional	`BITRISE_GIT_TAG`
`environments`	Bitrise environments to replace, it'll override the previous environment variables specified. The Hash key has to be the environment variable key (without the `$`), the Hash value has to be environment variable value	Hash	Optional	none

Return values

The bitrise plugin return a Hash containing the bitrise build informations return by the API.

Hash key	Description
`build_number`	Bitrise build number
`build_url`	Bitrise build url

If an error is return by the bitrise.io API, the plugin will throw an exception.

Examples

To trigger the default workflow set on Bitrise.io on the default git branch execute:

bitrise(
    app_slug: "YOUR_APP_SLUG",
    trigger_token: "YOUR_TRIGGER_TOKEN"
)

To trigger a build with a specific workflow, a specific git branch, display a build message, the build author and override some environments variables execute the following command:

bitrise(
    app_slug: "YOUR_APP_SLUG",
    trigger_token: "YOUR_TRIGGER_TOKEN",
    author: "Developer",
    branch: "release/1.3.2",
    build_message: "Deploy build version 1.3.2 build number 11 to Beta test",
    environments: {
        "BUILD_CONFIGURATION" => "Production",        # Environment variable to override during Bitrise.io build
        "ANOTHER_ENVIRONMENT_VARIABLE" => "123456"    # Environment variable to override during Bitrise.io build
    },
    workflow: "Beta"
)

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.

Author

Robin Authiat, @authiat_robin

I'm available for freelance work (Fastlane Continuous Delivery, Continuous Integration and iOS development). Feel free to contact me 🚀

fastlane-plugin-bitrise

Development