Internal Testing Track no Google Play: configuração do track

O que é o Internal Testing Track?

Internal Testing Track é o primeiro nível de teste no Google Play Console, projetado para distribuir compilações dentro da equipe de desenvolvimento. O principal objetivo é realizar verificações rápidas de funcionamento, testar integrações e identificar erros críticos antes de expandir o público para os tracks Closed ou Open.

Ao contrário de outros tracks do Google Play, o Internal Testing não exige revisão do Google antes da ativação. A compilação fica disponível para os testadores em questão de minutos após o envio para a console. Isso torna o track ideal para compilações diárias (daily builds) e entrega automática a partir do pipeline de CI/CD.

De acordo com a documentação do Google Play Console (2024), o Internal Testing Track oferece duas opções de distribuição: lista de e-mail (até 100 participantes) e Google Groups (sem limite de quantidade). Os grupos são adequados para equipes grandes onde os membros mudam com frequência, enquanto o e-mail funciona melhor para um conjunto fixo de desenvolvedores.

Quando escolher o Internal Testing Track

O track Internal é escolhido nos estágios iniciais do desenvolvimento, quando o aplicativo ainda está instável e as APIs podem mudar. Um pipeline de CI/CD envia cada nova compilação para o track Internal, e a equipe recebe a versão mais recente imediatamente. Erros e logs de falhas são coletados através do Play Console antes que a compilação chegue a testadores ou usuários externos.

Para novas contas de desenvolvedor, o Internal Testing Track serve como o primeiro passo na preparação para publicação. O Google não revisa as compilações nesta etapa, permitindo que a equipe verifique a qualidade do produto por si só antes de enviá-lo para revisão.

Como configurar o Internal Testing Track no Google Play Console

A configuração do Internal Testing Track é feita no Google Play Console na seção Release > Testing > Internal Testing. O processo inclui criar o track, enviar a primeira compilação e adicionar testadores.

Para criar o track, vá até a seção Internal Testing e clique em Create track. Após criar o track, o sistema solicitará o envio da primeira compilação no formato AAB (Android App Bundle). O Google recomenda AAB para todos os tipos de teste, pois o formato otimiza o tamanho do aplicativo de acordo com a arquitetura do dispositivo.

Após o envio da compilação, o acesso ao track é aberto adicionando testadores. Sem pelo menos um testador, o track não é considerado ativo. O Google Play Console mostra o status do track, a lista de compilações enviadas e as estatísticas de instalação de cada participante.

// build.gradle - envio automático para o Internal Testing Track
android {
    def versionCode = System.env.GIT_COMMIT_COUNT ?: "1"
    def versionName = "1.0." + versionCode

    defaultConfig {
        versionCode versionCode.toInteger()
        versionName versionName
    }
}

// Implantar via plugin Gradle Play Publisher
plugins {
    id 'com.github.triplet.play' version '3.9.0'
}

play {
    track = "internal"
    serviceAccountCredentials = file("play-account.json")
}

Adicionar testadores ao track Internal

Adicionar testadores ao Internal Testing Track é possível de duas formas: por e-mail e através do Google Groups. A lista de e-mail é adequada para equipes pequenas com composição fixa. Cada testador é adicionado manualmente na console e recebe um convite no endereço especificado.

O Google Groups é preferível para equipes com composição variável ou gerenciamento de acesso automatizado. Basta adicionar o grupo ao track e todos os seus membros obtêm acesso às compilações. A alteração na composição do grupo ocorre sem atualizar as configurações no Play Console.

Os testadores instalam o aplicativo através do Google Play no seu dispositivo. Após serem adicionados ao track, eles veem o aplicativo como disponível para atualização (se o instalaram anteriormente de outro track) ou como um novo aplicativo para instalar. As compilações do track Internal não são publicadas publicamente — apenas os participantes do track podem vê-las.

Coleta de métricas no track Internal

O Google Play coleta automaticamente o Android Vitals para todas as compilações no Internal Testing Track: taxa de falhas, ANR e tempo de inicialização. O desenvolvedor vê as métricas no Play Console imediatamente após o primeiro testador instalar a compilação. Os dados estão disponíveis em tempo real sem atrasos de agregação.

Diferenças entre Internal Testing e os tracks Closed e Open

Internal Testing Track difere dos tracks Closed e Open em velocidade de acesso, requisitos de revisão e escala de público. O Internal não exige moderação, o Closed exige configuração de Google Groups e revisão, o Open passa por uma revisão completa do Google.

O track Internal é o único onde a compilação está disponível sem espera. Closed e Open exigem revisão do Google, que leva de várias horas a 2 dias. Para contas de desenvolvedor novas, o Open Testing Track é obrigatório: o aplicativo deve passar por 14 dias de testes abertos antes da publicação em produção.

Automatização do Internal Testing via CI/CD

Automatizar o envio para o Internal Testing Track é uma prática padrão para pipelines de CI/CD em projetos Android. O Gradle Play Publisher é o plugin mais popular para publicação automática de compilações. Ele assina o AAB, envia para o Google Play e atribui o track.

O Fastlane fornece a ação supply para enviar compilações ao Play Console. O parâmetro track especifica o track de destino: internal, closedalpha, openbeta ou production. O gerenciamento de versões e a conta de serviço são configurados uma vez no Fastfile.

# Fastfile - envio automatizado para o Internal Testing Track
platform :android do
    desc "Build and deploy to Internal Testing"
    lane :internal do
        gradle(task: "bundleRelease")
        supply(
            track: "internal",
            aab: "app/build/outputs/bundle/release/app-release.aab",
            skip_upload_metadata: true,
            skip_upload_images: true
        )
    end
end

Uma conta de serviço do Google Play é criada no Google Cloud Console com o papel de Publisher e vinculada à conta de desenvolvedor no Play Console. A chave JSON da conta de serviço é armazenada no repositório de CI/CD como uma variável protegida (GitHub Secrets, GitLab CI Variables, Jenkins Credentials).