Run your Bitrise automation workflows with this CLI tool on your own development device, and on your Continuous Integration tool / service.
Part of the Bitrise Continuous Integration, Delivery and Automations Stack, with stepman and envman.
For a nice & quick intro you should check: https://www.bitrise.io/cli
The installation is quick and easy, check the latest release for instructions at: https://github.com/bitrise-io/bitrise/releases
You can find examples in the _examples folder.
If you're getting started you should start with _examples/tutorials,
this should guide you through the basics, while you'll already use bitrise
(requires installed bitrise
).
You can find a complete iOS sample project at: https://github.com/bitrise-io/sample-apps-ios-with-bitrise-yml
- Number one priority is UX for the end-user, to make it a pleasant experience to work with this tool!
- Code should be kept simple: easy to understand, easy to collaborate/contribute (as much as possible of course).
- Flexibility should also be kept in mind, but only if it does not affect the previous two points.
bitrise
CLI commands support a --format=[format]
parameter.
This is intended mainly for tooling support, by adding --format=json
you'll
get a JSON formatted output on Standard Output.
This is still work-in-progress, we're working on providing
the --format
param to every command except run
.
Every error, warning etc. message will go to StdErr; and on the StdOut you should only get the valid JSON output.
An example calling the version
command:
$ bitrise version --format=json
Will print {"version":"1.2.4"}
to the Standard Output (StdOut).
You can use your own Step as you can see in the _examples
, even if it's
not yet committed into a repository, or from a repository directly.
If you would like to share your awesome Step with others
you can do so by calling stepman share
and then following the
guide it prints.
We added some documents to make it a bit easier to get started with Bitrise CLI. The documentation includes a quick and a little longer guides for CLI, a React Native project workflow guide and an overview of the Step share process. You can find them in the _docs folder.