Bitrise é uma plataforma em nuvem que proporciona o serviço de Integração contínua e Entrega contínua, com ênfase em desenvolvimento mobile (iOS, Android, Xamarin, React Native, etc).
Principais características
- Interface simples e intuitiva;
- Plano free para desenvolvedores de projetos Open Source (Developer Plan).
- Utilização de Step’s criados pela comunidade;
- Documentação objetiva;
- Integração com ferramentas de qualidade de código (SonarQube, Detekt, Lint, etc);
Workflow:
Um workflow é definido pelo conjunto de Steps que serão executados em ordem Top-Down. Ao criar um Workflow o arquivo bitrise.yml é gerado e nele irá conter todas as informações que serão executadas pela build. Após a execução de uma build, serão gerados os logs contendo os resultados. É possível alterar as configurações editando o arquivo bitrise.yml ou utilizando a interface de edição (Workflow Editor UI).
Exemplo de Workflow gerado pelo Bitrise (no primeiro build):
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| — | |
| format_version: '6' | |
| default_step_lib_source: https://github.com/bitrise-io/bitrise-steplib.git | |
| project_type: android | |
| trigger_map: | |
| – push_branch: "*" | |
| workflow: primary | |
| – pull_request_source_branch: "*" | |
| workflow: primary | |
| workflows: | |
| deploy: | |
| description: | | |
| ## To run this workflow | |
| If you want to run this workflow manually: | |
| 1. Open the app's build list page | |
| 2. Click on **[Start/Schedule a Build]** button | |
| 3. Select **deploy** in **Workflow** dropdown input | |
| 4. Click **[Start Build]** button | |
| Or if you need this workflow to be started by a GIT event: | |
| 1. Click on **Triggers** tab | |
| 2. Setup your desired event (push/tag/pull) and select **deploy** workflow | |
| 3. Click on **[Done]** and then **[Save]** buttons | |
| The next change in your repository that matches any of your trigger map event will start **deploy** workflow. | |
| steps: | |
| – activate-ssh-key@4.0.3: | |
| run_if: '{{getenv "SSH_RSA_PRIVATE_KEY" | ne ""}}' | |
| – git-clone@4.0.11: {} | |
| – cache-pull@2.0.1: {} | |
| – script@1.1.5: | |
| title: Do anything with Script step | |
| – install-missing-android-tools@2.2.0: | |
| inputs: | |
| – gradlew_path: "$PROJECT_LOCATION/gradlew" | |
| – change-android-versioncode-and-versionname@1.1.1: | |
| inputs: | |
| – build_gradle_path: "$PROJECT_LOCATION/$MODULE/build.gradle" | |
| – android-lint@0.9.4: | |
| inputs: | |
| – project_location: "$PROJECT_LOCATION" | |
| – module: "$MODULE" | |
| – variant: "$TEST_VARIANT" | |
| – android-unit-test@0.9.3: | |
| inputs: | |
| – project_location: "$PROJECT_LOCATION" | |
| – module: "$MODULE" | |
| – variant: "$TEST_VARIANT" | |
| – android-build@0.9.5: | |
| inputs: | |
| – project_location: "$PROJECT_LOCATION" | |
| – module: "$MODULE" | |
| – variant: "$BUILD_VARIANT" | |
| – sign-apk@1.2.3: | |
| run_if: '{{getenv "BITRISEIO_ANDROID_KEYSTORE_URL" | ne ""}}' | |
| – deploy-to-bitrise-io@1.3.15: {} | |
| – cache-push@2.0.5: {} | |
| primary: | |
| steps: | |
| – activate-ssh-key@4.0.3: | |
| run_if: '{{getenv "SSH_RSA_PRIVATE_KEY" | ne ""}}' | |
| – git-clone@4.0.11: {} | |
| – cache-pull@2.0.1: {} | |
| – script@1.1.5: | |
| title: Do anything with Script step | |
| – install-missing-android-tools@2.2.0: | |
| inputs: | |
| – gradlew_path: "$PROJECT_LOCATION/gradlew" | |
| – android-lint@0.9.4: | |
| inputs: | |
| – project_location: "$PROJECT_LOCATION" | |
| – module: "$MODULE" | |
| – variant: "$TEST_VARIANT" | |
| – android-unit-test@0.9.3: | |
| inputs: | |
| – project_location: "$PROJECT_LOCATION" | |
| – module: "$MODULE" | |
| – variant: "$TEST_VARIANT" | |
| – deploy-to-bitrise-io@1.3.15: {} | |
| – cache-push@2.0.5: {} | |
| app: | |
| envs: | |
| – opts: | |
| is_expand: false | |
| PROJECT_LOCATION: "." | |
| – opts: | |
| is_expand: false | |
| MODULE: app | |
| – opts: | |
| is_expand: false | |
| BUILD_VARIANT: Debug | |
| – opts: | |
| is_expand: false | |
| TEST_VARIANT: Debug |
Step:
São representados por blocos de código que serão executados de acordo com uma order pré definida em determinado workflow. Eles são desenvolvidos pela comunidade e podem ser escrito em várias linguagem como: bash, Go, Ruby, Swift, etc. Vale lembrar que qualquer pessoa poderá criar um Step e divulgar na comunidade.
Trigger:
São os gatilhos disparados a partir de uma chamada do Webhook do projeto, essas chamadas podem ser de: push, pull request e tag.
Eles são compostos por:
- Type (Push, Pull Request e Tag);
- Source Branch;
- Target Branch;
- Workflow.
Build:
São processos definidos pelos Workflows, que são construído através do encadeamento de Steps e executados por um Trigger.
Após a build ser finalizada, podemos configurar um step para disponibilizar e/ou armazenar os artefatos gerados.
Configurando o projeto
1. Devemos adicionar um novo app no dashboard do Bitrise. Para isso é necessário acessar o link https://app.bitrise.io/apps/add
2. Definir qual conta será vinculada e o nível de privacidade do projeto;
3. Definir em qual plataforma está armazenado o repositório;
4. Definir a branch principal do projeto;
5. Neste passo o Bitrise irá validar seu projeto e a branch escolhida;
6. Após a validação, devemos definir qual será o root path do projeto, seu módulo e a variant de build;
7. Por fim, podemos adicionar um Webhook ao projeto.
Um Webhook provê mecanismos para os servidores notificarem os clients sobre mudanças nos dados, nele é aplicado o paradigma reativo. No caso do Bitrise, iremos utilizar um Webhook que ficará responsável por observar as mudanças em uma determinada branch e a partir de uma mudança ele irá disparar o Trigger, dando início ao processo de Build.
8. Após a configuração, o Bitrise irá executar automaticamente o seu primeiro Build. Ele seguirá os passos definidos pelo Workflow primário (gerado automaticamente, com validações de Lint e testes unitários).
