Configuração de assinatura de código do Android no App Center

Assinar um aplicativo é um requisito para executá-lo em dispositivos reais durante o processo de desenvolvimento ou para distribuí-lo por meio de um programa beta ou na Play Store. Sem assinatura de código, o aplicativo só pode ser executado em um emulador.

Quando o App Center cria um aplicativo Android com um tipo de build de depuração, um repositório de chaves para um desenvolvedor não é necessário, mas pode ser carregado. Essas compilações serão assinadas automaticamente com uma chave de depuração. Para um build de versão que será implantado, carregue um repositório de chaves no App Center.

Gerando um armazenamento de chaves

Se você não tiver um armazenamento de chaves no momento, poderá gerar um no Android Studio. Você pode encontrar instruções sobre como gerar um repositório de chaves para assinar APKs no Guia do usuário oficial do Android Studio.

Configurando a assinatura de código

O App Center dá suporte a três maneiras diferentes de configurar a assinatura de código para aplicativos Android. Para todos os três métodos, primeiro você precisa ir para a configuração de build e habilitar a assinatura de código:

1. Vá para seu aplicativo no App Center.
2. Vá para Construir.
3. Vá para o branch que deseja configurar escolhendo-o na lista.
4. Use o menu "Configurações" no canto superior direito ou escolha Configurar se o branch ainda não estiver configurado para compilação.
5. Habilite builds de Sign.
6. Selecione Salvar.

Em seguida, dependendo do seu cenário, use a mais adequada das três opções nas seções abaixo. A primeira opção envolve o check-in de credenciais em seu repositório, enquanto as outras duas usam o App Center para lidar com suas credenciais.

A partir do Android 11, é obrigatório usar o assinante do APK (se você usar o nível 30 da API), pois ele definirá alguns esquemas extras "Esquema de assinatura do APK v2 agora necessário". O App Center agora (desde 17 de dezembro de 2020) assina aplicativos Android usando o assinante APK internamente, em vez do assinante JAR que era usado anteriormente. Como parte do recurso para habilitar o assinante do APK no App Center, a tarefa de assinatura do Android V3 foi implementada e os requisitos para a nova tarefa de assinatura eram alterar a forma como o arquivo de armazenamento de chaves é salvo – para armazenar o arquivo de armazenamento de chaves em um arquivo seguro AzDO (tarefa de build e versão de assinatura do Android – Azure Pipelines | Documentos da Microsoft).

 android.useNewApkCreator = false

R. Armazenando tudo na configuração do Gradle

Você pode especificar os detalhes de assinatura no arquivo (nível do build.gradle aplicativo). Os detalhes de assinatura, juntamente com todas as credenciais e as informações do armazenamento de chaves, ficarão visíveis no repositório. Primeiro, adicione todos os itens necessários ao seu código e faça check-in deles no repositório. Em seguida, na configuração de build no App Center, habilite Minhas configurações do Gradle são totalmente definidas para lidar com a assinatura automaticamente.

B. Carregando tudo para o App Center

Você pode carregar o repositório de chaves e configurar as credenciais de assinatura por meio do App Center. Nesse caso, o App Center primeiro criará seu aplicativo Android e, em seguida, executará uma etapa de assinatura após a compilação bem-sucedida.

Defina sua configuração de build no App Center da seguinte maneira:

1. As configurações de Desativar meu Gradle estão totalmente definidas para lidar com a assinatura automaticamente.
2. Faça upload do arquivo do repositório de chaves para o arquivo de upload do arquivo do repositório de chaves. Você pode arrastar o arquivo para a caixa ou clicar nele e procurar o arquivo. Os arquivos de armazenamento de chaves têm a extensão .keystore ou .jks.
3. Insira a senha do armazenamento de chaves, o alias da chave e a senha da chave nos campos correspondentes. Esses valores são os mesmos que você inseriria no Android Studio ao assinar um build.

C. Armazenando detalhes de assinatura no repositório com variáveis de ambiente

Use esse método se o repositório já contiver o armazenamento de chaves, mas você não quiser armazenar as credenciais lá. No momento da compilação, as credenciais serão fornecidas como propriedades do sistema para a compilação do Gradle. Consulte o exemplo de código a seguir sobre como usá-los:

android {
    signingConfigs {
        releaseSigningConfig {
            storeFile rootProject.file("app/testapp.jks")
            storePassword System.getProperty("APPCENTER_KEYSTORE_PASSWORD")
            keyAlias System.getProperty("APPCENTER_KEY_ALIAS")
            keyPassword System.getProperty("APPCENTER_KEY_PASSWORD")
        }
    }

    buildTypes {
        release {
            signingConfig signingConfigs.releaseSigningConfig
        }
    }
}

No código acima, proteger os valores por trás das propriedades do sistema injetadas em seu build mantém suas credenciais de assinatura seguras – os valores são criptografados e só estão disponíveis para os agentes de build no momento do build. Você pode fornecer os valores por meio do App Center. Você também pode codificar qualquer um dos valores e fazer check-in deles em seu repositório. Para usar o App Center para proteger os valores:

1. Vá para a configuração de build.
2. Certifique-se de que a caixa de seleção chamada Minhas configurações do Gradle esteja totalmente definida para lidar com a assinatura automaticamente , se não estiver marcada.
3. Insira a senha do armazenamento de chaves, o alias da chave e a senha da chave nos campos correspondentes. Esses valores são os mesmos que você inseriria no Android Studio ao assinar um build.

Se você usar variações de produto, talvez seja necessário ajustar o código acima para que todas as configurações de versão usem a configuração de assinatura correta.

 Execution failed for task ':app:validateSigningRelease'.
 Keystore file '.../android/app/debug.keystore' not found for signing config 'debug'