Como Automatizar a Geração de APKs com GitHub Actions

Se você é desenvolvedor Android, sabe bem como é a rotina: você termina uma funcionalidade, precisa gerar um APK para testar no aparelho (ou enviar para um cliente) e, nesse momento, o Android Studio decide consumir toda a memória RAM do seu computador para compilar o projeto. Além de lento, é um processo manual que interrompe seu fluxo de trabalho.

Mas e se eu te dissesse que você nunca mais precisará clicar em "Build APK" na sua máquina?

A resposta está no CI/CD (Integração e Entrega Contínua). Usando o GitHub Actions, é possível configurar um fluxo de trabalho onde o próprio GitHub percebe que você atualizou o código, prepara um ambiente virtual, compila o seu projeto e te entrega o APK pronto para baixar. Tudo isso de forma gratuita e automática.

Neste artigo, vamos percorrer o caminho completo:

1. Preparação: Como enviar seu projeto local para o GitHub.

2. Automação: Como configurar o "workflow" que faz o trabalho pesado.

3. Distribuição: Como baixar e instalar o arquivo final.

Prepare o seu café, abra o terminal e vamos transformar o seu repositório em uma linha de produção automatizada!

1️⃣ Subindo o Projeto do PC para o GitHub

Se você já tem o código no seu computador (no Android Studio), siga estes passos para enviá-lo ao GitHub:

1. Crie um repositório vazio: No GitHub, clique no botão "+" > New repository. Dê um nome e clique em Create repository. Não marque a opção de adicionar README ou .gitignore agora.

2. Abra o terminal: No seu computador, abra a pasta do seu projeto Android e abra o terminal (ou o terminal embutido no Android Studio).

3. Inicie o Git e envie os arquivos: Execute os comandos abaixo um por um:

   Bash

   git init
   git add .
   git commit -m "Primeiro commit do meu App"
   git branch -M main
   git remote add origin https://github.com/SEU_USUARIO/NOME_DO_REPO.git
   git push -u origin main
   

   (Troque a URL pela do repositório que você acabou de criar).

---

2️⃣ Configurando a Automação (GitHub Actions)

Agora que o código está lá, vamos criar o "trabalhador" que vai compilar o APK para você.

1. No seu repositório no GitHub, clique em Add file > Create new file.

2. No nome do arquivo, digite: .github/workflows/gerar_apk.yml

3. Cole o código abaixo (este é o script que prepara a máquina virtual e gera o arquivo):

YAML

name: Build Android APK

on:
  push:
    branches: [ "main" ] # O build acontece toda vez que você enviar código para a main
  workflow_dispatch:      # Permite que você clique em um botão para gerar o APK manualmente

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout do código
        uses: actions/checkout@v4

      - name: Configurar Java
        uses: actions/setup-java@v4
        with:
          java-version: '17' # Se seu projeto for antigo, tente '11'
          distribution: 'temurin'
          cache: gradle

      - name: Dar permissão ao Gradle
        run: chmod +x gradlew

      - name: Compilar APK de Debug
        run: ./gradlew assembleDebug

      - name: Disponibilizar o arquivo para Download
        uses: actions/upload-artifact@v4
        with:
          name: App-Instalavel
          path: app/build/outputs/apk/debug/app-debug.apk

4. Clique em Commit changes... para salvar.

---

3️⃣ Acompanhando e Baixando o APK

Assim que você salvou o arquivo acima, o GitHub já começou a trabalhar.

1. Clique na aba Actions (fica no topo do repositório).

2. Você verá um processo chamado "Build Android APK". Clique nele.

3. Se a bolinha estiver amarela, ele está "cozinhando" o app. Se estiver verde, terminou!

4. Clique no nome do processo finalizado e role a página até o final.

5. Lá você verá o item "App-Instalavel". Clique nele para baixar o arquivo .zip que contém o seu APK.

---

💡 Informações Importantes para Não Errar

Ponto de Atenção	Por que é importante?
Pasta do Projeto	O script assume que seu código está na pasta app/. Se o seu projeto tiver outro nome de pasta, você deve ajustar o caminho no passo final do script.
Versão do Java	A maioria dos apps modernos usa Java 17. Se o seu build der erro de "Java version mismatch", mude para java-version: '11' no script.
Instalação no Celular	Como este APK não veio da Play Store, seu Android dirá que o app é de "Fonte Desconhecida". Basta autorizar a instalação nas configurações do aparelho.

---

📝 Resumo do Processo

• No PC: git push para enviar o código.

• No GitHub: O Actions detecta a mudança.

• Na Nuvem: O GitHub abre uma máquina Linux, instala o Java, baixa seu código e roda o comando assembleDebug.

• Resultado: O arquivo final fica guardado como um Artefato para você baixar de qualquer lugar.

Automatizar a geração do seu APK com o GitHub Actions é um divisor de águas. Além de liberar o processamento do seu computador, você profissionaliza o seu fluxo de trabalho, garantindo que o código que está no repositório é, de fato, o mesmo que está rodando no arquivo final.

O que vimos hoje é apenas a ponta do iceberg. Com essa base, você pode expandir sua automação para:

• Rodar testes unitários automaticamente antes de gerar o APK.

• Notificar sua equipe no Slack ou Discord sempre que um novo build estiver pronto.

• Configurar o envio automático para a Google Play Store usando chaves de assinatura (Release).

Agora é com você! Implemente esse workflow no seu projeto e sinta a diferença na sua produtividade. Ficou com alguma dúvida em algum passo ou teve algum erro de versão no Gradle? Deixe seu comentário abaixo! Vou adorar ajudar você a resolver.

E se esse tutorial foi útil, não esqueça de compartilhar com aquele amigo dev que ainda sofre esperando o Android Studio compilar! 🚀