Apksigner.jar - Baixe a ferramenta de assinatura de aplicativos para Android

/lib - H3: Adicionar apksigner.jar à sua variável de ambiente PATH - H2: Como usar apksigner.jar para assinar um arquivo APK - H3: Gerar um keystore e um par de chaves usando keytool - H3: Assinar o arquivo APK usando o comando apksigner sign - H3: Verificar a assinatura usando o comando apksigner Verify - H2: Conclusão - H3: Resumo dos pontos principais - H3: Chamada à ação e recursos para aprendizado adicional - H2: Perguntas frequentes - H 3: Quais são os benefícios de usar o apksigner sobre o jarsigner? - H3: Como posso rotacionar minhas chaves de assinatura usando o apksigner? - H3: Como posso assinar um pacote de aplicativos usando o apksigner? - H3: Como posso solucionar erros comuns com o apksigner? - H3: Como posso automatizar o processo de assinatura com o apksigner? Artigo com formatação HTML: Como baixar apksigner.jar

Se você está desenvolvendo aplicativos para Android, já deve ter ouvido falar apksigner.jar, uma ferramenta que permite assinar seus arquivos APK com um certificado digital. Assinar seus arquivos APK é essencial para distribuir seus aplicativos aos usuários, pois garante a autenticidade e a integridade de seu aplicativo. Neste artigo, você aprenderá o que é apksigner.jar, como obtê-lo no Android SDK e como usá-lo para assinar seus arquivos APK.

O que é apksigner.jar e por que você precisa dele?

apksigner.jar é uma ferramenta para assinar arquivos APK

Um arquivo APK é um pacote que contém todos os arquivos e recursos do seu aplicativo Android. Antes de instalar ou atualizar um arquivo APK em um dispositivo, você precisa sinal com uma chave privada e um certificado. Assinar um arquivo APK prova que você é o autor do aplicativo e que ninguém o adulterou.

download apksigner.jar

Download File

apksigner.jar é uma ferramenta que ajuda você a assinar seus arquivos APK usando ferramentas padrão do SDK do Android e do JDK. Ele suporta diferentes esquemas de assinatura, como v1 (assinatura JAR), v2 (esquema de assinatura APK v2) e v3 (esquema de assinatura APK v3). Ele também permite que você verifique a assinatura de um arquivo APK e gire suas chaves de assinatura.

A assinatura de arquivos APK é necessária para distribuir aplicativos Android

Assinar seus arquivos APK não é apenas uma boa prática de segurança, mas também um requisito para distribuir seus aplicativos aos usuários. Por exemplo, se você deseja publicar seu aplicativo no Google Play, precisa assiná-lo com um chave de upload, que o Google usa para verificar sua identidade. O Google então assina seu aplicativo com um chave de assinatura do aplicativo, que é usado para autenticar seu aplicativo em dispositivos.

Assinar seus arquivos APK também garante que os usuários possam instalar atualizações em seu aplicativo sem problemas. Se você alterar sua chave de assinatura ou usar um esquema de assinatura inconsistente, os usuários poderão encontrar erros de instalação ou perder os dados do aplicativo.

Como obter apksigner.jar do Android SDK

Instale o Android Studio e o Android SDK Build Tools

Para usar o apksigner.jar, você precisa ter o Android Studio e o Android SDK Build Tools instalados em seu computador. O Android Studio é um ambiente de desenvolvimento integrado (IDE) que ajuda você a criar e testar aplicativos Android. As Android SDK Build Tools são uma coleção de ferramentas que ajudam você a compilar, depurar e empacotar seus aplicativos.

Você pode baixar o Android Studio em . Depois de instalar o Android Studio, você pode usar o SDK Manager para baixar e atualizar as Android SDK Build Tools. Você pode acessar o SDK Manager no menu Ferramentas no Android Studio.

Localize apksigner.jar no arquivo build-tools/diretório /lib

Depois de instalar o Android SDK Build Tools, você pode encontrar apksigner.jar no ferramentas de construção//lib diretório, onde é o número da versão das Ferramentas de Construção que você instalou. Por exemplo, se você instalou o Build Tools 31.0.0, pode encontrar apksigner.jar no build-tools/31.0.0/lib diretório.

Adicione apksigner.jar à sua variável de ambiente PATH

Para facilitar o uso do apksigner.jar na linha de comando, você pode adicioná-lo ao seu CAMINHO variável de ambiente.A variável de ambiente PATH é uma lista de diretórios que seu sistema operacional procura por arquivos executáveis quando você digita um comando.

Para adicionar apksigner.jar ao seu PATH no Windows, siga estas etapas:

Abra o Painel de Controle e clique em Sistema e Segurança.

Clique em Sistema e depois em Configurações avançadas do sistema.

Clique em Variáveis de ambiente e selecione Caminho na lista Variáveis do sistema.

Clique em Editar e depois em Novo.

Digite ou cole o caminho para o diretório onde o apksigner.jar está localizado, como C:\Usuários\\AppData\Local\Android\Sdk\build-tools\31.0.0\lib.

Clique em OK e depois em OK novamente para salvar as alterações.

Para adicionar apksigner.jar ao seu PATH no Mac ou Linux, você pode editar seu .bash_profile ou .bashrc arquivo e anexe a seguinte linha:

exportar PATH=$PATH:

Por exemplo, se apksigner.jar estiver localizado em /Usuários//Library/Android/sdk/build-tools/31.0.0/lib, você pode adicionar esta linha:

export PATH=$PATH:/Usuários//Library/Android/sdk/build-tools/31.0.0/lib

Salve o arquivo e reinicie seu terminal para que as alterações entrem em vigor.

Como usar apksigner.jar para assinar um arquivo APK

Gere um keystore e um par de chaves usando keytool

Para assinar um arquivo APK, você precisa de um armazenamento de chaves e um par de chaves. Um keystore é um arquivo que armazena uma ou mais chaves privadas e seus certificados associados. Um par de chaves consiste em uma chave privada e uma chave pública que estão ligadas matematicamente. A chave privada é usada para assinar o arquivo APK, enquanto a chave pública é incorporada ao certificado que verifica a assinatura.

Você pode usar ferramenta-chave, uma ferramenta do JDK, para gerar um keystore e um par de chaves. Para fazer isso, você pode executar o seguinte comando:

keytool -genkeypair -keystore .jks -alias -keyalg RSA -keysize 2048 -validity 10000 -dname "CN=, OU=, O =, L=, S=, C=" -storepass -keypass

Neste comando, você precisa substituir os seguintes parâmetros por seus próprios valores:

: o nome do arquivo keystore, como myapp.jks.

: o nome do par de chaves, como myappkey.

: o nome do aplicativo ou do desenvolvedor, como My App ou John Doe.

: o nome da unidade ou departamento dentro da organização, como Desenvolvimento ou Engenharia.

: o nome da organização ou empresa, como My Company ou ABC Inc.

: o nome da cidade onde a organização está localizada, como Nova York ou Londres.

: o nome do estado ou província onde a organização está localizada, como NY ou ON.

: o código de duas letras do país onde a organização está localizada, como EUA ou CA.

: A senha para acessar o keystore, como myapp1234.

: a senha para acessar o par de chaves, que pode ser igual ou diferente da senha do armazenamento de chaves, como myapp1234.

Este comando criará um arquivo keystore com o nome especificado e um par de chaves com o alias especificado no diretório atual. Você também será solicitado a inserir algumas informações sobre o certificado, como o período de validade, o nome e a organização. Você pode aceitar os valores padrão ou inserir os seus próprios.

Assine o arquivo APK usando o comando apksigner sign

Depois de ter um armazenamento de chaves e um par de chaves, você pode usar apksigner para assinar seu arquivo APK. Para fazer isso, você pode executar o seguinte comando:

sinal apksigner --ks .jks --ks-key-alias --ks-pass passe: --passe de chave: --fora .apk .apk

Neste comando, você precisa substituir os seguintes parâmetros por seus próprios valores:

: o nome do arquivo keystore, como myapp.jks.

: o nome do par de chaves, como myappkey.

: A senha para acessar o keystore, como myapp1234.

: A senha para acessar o par de chaves, como myapp1234.

: o nome do arquivo APK assinado, como myapp-signed.apk.

: o nome do arquivo APK não assinado, como myapp-unsigned.apk.

Este comando assinará o arquivo APK usando o keystore e o par de chaves especificados e gerará um arquivo APK assinado com o nome especificado no diretório atual.Por padrão, ele usará os esquemas de assinatura v1 e v2. Você pode especificar um esquema de assinatura diferente usando o --v1-assinatura habilitada, --v2-assinatura habilitada, ou --assinatura v3 habilitada opções.

Verifique a assinatura usando o comando de verificação apksigner

Depois de assinar seu arquivo APK, você pode usar apksigner para verificar se a assinatura é válida e atende aos requisitos para instalar e atualizar seu aplicativo. Para fazer isso, você pode executar o seguinte comando:

apksigner verifique --verbose --print-certs .apk

Neste comando, você precisa substituir pelo nome do seu arquivo APK assinado, como myapp-signed.apk.

Este comando verificará a assinatura do seu arquivo APK e imprimirá algumas informações sobre ele, como o esquema de assinatura, os detalhes do certificado e quaisquer avisos ou erros. Se a assinatura for válida e atender aos requisitos, você verá uma mensagem como esta:

Verifica Verificado usando o esquema v1 (assinatura JAR): verdadeiro Verificado usando o esquema v2 (Esquema de Assinatura APK v2): verdadeiro Verificado usando o esquema v3 (Esquema de Assinatura APK v3): verdadeiro Número de signatários: 1 Signatário #1 certificado DN: CN=Meu Aplicativo, OU=Desenvolvimento, O=Minha Empresa, L=Nova York, S=NY, C=US Signatário #1 certificado SHA-256 resumo: 1234567890abcdef12 34567890abcdef1234567890abcdef1234567890abcdef Signer #1 certificate SHA-1 digest: 1234567890abcdef12345678 Signer #1 certificate MD5 digest: 1234567890abcdef Signer #1 key algoritmo: RSA Signer #1 tamanho da chave (bits): 2048 Signer #1 chave pública SHA-256 digest: 1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef Assinante #1 chave pública SHA-1 digest: 1234567890abcdef12345678 Signatário #1 chave pública MD5 digest: 1234567890 abcdef

Conclusão

Resumo dos principais pontos

Neste artigo, você aprendeu como baixar apksigner.jar do Android SDK e como usá-lo para assinar seus arquivos APK. Você também aprendeu por que assinar seus arquivos APK é importante para distribuir seus aplicativos aos usuários e garantir sua segurança e compatibilidade.Assinar seus arquivos APK com apksigner.jar é uma maneira simples e eficaz de preparar seus aplicativos para lançamento.

Chamada à ação e recursos para aprendizado adicional

Se quiser saber mais sobre o apksigner.jar e como usá-lo para assinar seus aplicativos, confira estes recursos:

: A documentação oficial para apksigner.jar do Google.

Práticas recomendadas para usar o apksigner

Usar o apksigner para assinar seus arquivos APK é uma maneira simples e eficaz de preparar seus aplicativos para lançamento, mas existem algumas práticas recomendadas que você deve seguir para garantir a segurança e a compatibilidade de seus aplicativos. Aqui estão algumas dicas e recomendações para usar o apksigner:

Use a versão mais recente do apksigner das ferramentas de compilação do Android SDK. A versão mais recente oferece suporte aos esquemas e recursos de assinatura mais recentes, como APK Signature Scheme v4, que permite instalação e verificação de aplicativos mais rápidas no Android 11 e superior. Você pode atualizar as Android SDK Build Tools usando o SDK Manager no Android Studio.

Use uma chave de upload separada para assinar seu pacote de aplicativos antes de carregá-lo no Google Play. Dessa forma, você pode manter sua chave de assinatura do app mais segura e ter a opção de redefinir sua chave de upload caso ela seja perdida ou comprometida. Você pode gerar uma nova chave de upload usando a keytool e registrá-la no Google Play usando a página Assinatura de aplicativo pelo Google Play no Play Console.

Use uma senha forte e um local seguro para seu armazenamento de chaves e arquivos de chaves. Seu armazenamento de chaves e arquivos de chaves contêm informações confidenciais que podem ser usadas para se passar por você ou adulterar seus aplicativos. Você deve protegê-los com uma senha forte que não seja fácil de adivinhar ou quebrar e armazená-los em um local seguro que não seja acessível a outras pessoas. Você também deve fazer backup do armazenamento de chaves e dos arquivos de chave, caso sejam corrompidos ou excluídos.

Use o valor minSdkVersion mais alto compatível com seu aplicativo.O valor minSdkVersion determina o nível de API de estrutura do Android mais baixo que o apksigner usa para confirmar que a assinatura do APK será verificada. Valores mais altos permitem que o apksigner use parâmetros de segurança mais fortes ao assinar o aplicativo, mas limitam a disponibilidade do aplicativo para dispositivos que executam versões mais recentes do Android. Por padrão, o apksigner usa o valor do atributo minSdkVersion do arquivo de manifesto do aplicativo, mas você pode substituí-lo usando a opção --min-sdk-version.

Verifique a assinatura do seu arquivo APK depois de assiná-lo. Você pode usar o comando de verificação apksigner para verificar se a assinatura do seu arquivo APK é válida e atende aos requisitos para instalar e atualizar seu aplicativo em diferentes versões do Android. Você também pode usar as opções --verbose e --print-certs para obter mais informações sobre a assinatura, como o esquema de assinatura, os detalhes do certificado e quaisquer avisos ou erros.

perguntas frequentes

Quais são os benefícios de usar o apksigner sobre o jarsigner?

jarsigner é outra ferramenta do JDK que pode ser usada para assinar arquivos APK usando o esquema de assinatura v1. No entanto, o apksigner tem algumas vantagens sobre o jarsigner, como:

O apksigner oferece suporte a esquemas de assinatura mais recentes, como v2, v3 e v4, que oferecem melhor segurança e desempenho do que v1.

O apksigner pode assinar arquivos APK que foram alinhados com o zipalign, o que otimiza o arquivo APK para carregamento e execução mais rápidos nos dispositivos. jarsigner não pode assinar arquivos APK alinhados.

O apksigner pode verificar a assinatura de um arquivo APK e verificar se há problemas ou avisos que possam afetar a instalação ou atualização do aplicativo. jarsigner não pode verificar a assinatura de um arquivo APK.

Como posso rotacionar minhas chaves de assinatura usando o apksigner?

Girar suas chaves de assinatura significa alterar sua chave privada e certificado sem afetar a compatibilidade ou a segurança do aplicativo. Isso pode ser útil se sua chave for comprometida ou expirar, ou se você quiser usar um algoritmo ou tamanho de chave mais forte.Para rotacionar suas chaves de assinatura usando o apksigner, você pode seguir estas etapas:

Gere um novo keystore e um par de chaves usando keytool com um alias e certificado diferente do antigo.

Assine seu arquivo APK com os pares de chaves antigo e novo usando o comando apksigner sign com a opção --next-signer.

Verifique a assinatura do seu arquivo APK usando o comando apksigner Verify com a opção --min-sdk-version definida como 24 ou superior.

Isso criará uma assinatura que contém os certificados antigo e novo, o que permitirá que os dispositivos com Android 7.0 (API de nível 24) ou superior aceitem o novo certificado como uma atualização válida. Os dispositivos que executam versões anteriores do Android ainda usarão o certificado antigo para verificar o aplicativo.

Como posso assinar um pacote de aplicativos usando o apksigner?

Um pacote de aplicativo é um formato de arquivo que contém todos os arquivos e recursos do seu aplicativo em um formato compactado. Ele permite que o Google Play gere arquivos APK otimizados para diferentes configurações de dispositivos, como tamanho da tela, idioma e arquitetura. Para assinar um pacote de aplicativos usando apksigner, você pode usar o mesmo comando usado para assinar um arquivo APK, mas com o --v4-assinatura habilitada verdadeiro opção. Por exemplo:

sinal apksigner --ks .jks --ks-key-alias --ks-pass passe: --passe de chave: --fora .aab --v4-signing-enabled true .aab

Isso assinará seu pacote de aplicativos usando o esquema de assinatura v4, que é necessário para pacotes de aplicativos. Você também pode usar outros esquemas de assinatura, como v1, v2 ou v3, mas eles não são obrigatórios para pacotes de aplicativos.

Como posso solucionar erros comuns com o apksigner?

Às vezes, você pode encontrar alguns erros ou problemas ao usar o apksigner para assinar ou verificar seus arquivos APK. Aqui estão alguns erros comuns e como corrigi-los:

ErroCausaSolução

Falha ao carregar o signatário "signatário #1"O keystore ou a senha da chave estão incorretos ou ausentes.Certifique-se de inserir a senha correta para seu armazenamento de chaves e par de chaves usando as opções --ks-pass e --key-pass.

Nenhuma chave com alias ''encontrado no armazenamento de chaves .jksO alias da chave está incorreto ou ausente.Certifique-se de inserir o alias correto para seu par de chaves usando a opção --ks-key-alias.

A minSdkVersion do APK é muito baixa (x). Deve ser pelo menos y.O valor minSdkVersion do seu aplicativo é inferior ao mínimo exigido pelo esquema de assinatura.Aumente o valor minSdkVersion de seu aplicativo no arquivo de manifesto ou substitua-o usando a opção --min-sdk-version.

As assinaturas do APK não correspondem aos certificados do signatário nº 1.O arquivo APK foi assinado com diferentes certificados com atributos conflitantes.Certifique-se de usar certificados consistentes ao assinar seu arquivo APK com vários pares de chaves.

O APK não está alinhado ao zip.O arquivo APK não foi alinhado com o zipalign, que otimiza o arquivo APK para carregamento e execução mais rápidos nos dispositivos.Use zipalign para alinhar seu arquivo APK antes de assiná-lo ou use a opção falsa --v1-signing-enabled para desabilitar o esquema de assinatura v1.

Como posso automatizar o processo de assinatura com o apksigner?

Se você deseja automatizar o processo de assinatura com apksigner, pode usar um GradleName tarefa ou uma script de shell para executar os comandos apksigner. Gradle é uma ferramenta de automação de compilação que ajuda você a gerenciar as dependências, tarefas e saídas do seu projeto. Um script shell é um arquivo que contém uma série de comandos que podem ser executados por um programa shell, como Bash ou PowerShell.

Para usar uma tarefa Gradle para assinar seu arquivo APK com apksigner, você pode adicionar o seguinte código ao seu aplicativo build.gradle arquivo:

android ... signatureConfigs release storeFile file(".jks") storeSenha"" keyAlias ""chaveSenha"" buildTypes release signatureConfig signatureConfigs.release

Esse código criará uma configuração de assinatura chamada release e a atribuirá ao tipo de compilação release.Você precisa substituir os parâmetros por seus próprios valores. Você pode então usar o montarLiberar tarefa para construir e assinar seu arquivo APK com apksigner.

Para usar um script de shell para assinar seu arquivo APK com apksigner, você pode criar um arquivo chamado assinar.sh e adicione o seguinte código:

#!/bin/bash apksigner sign --ks .jks --ks-key-alias --ks-pass passe: --passe de chave: --fora .apk .apk apksigner verifique --verbose --print-certs .apk

Este código assinará e verificará seu arquivo APK com apksigner usando os parâmetros especificados. Você precisa substituir os parâmetros por seus próprios valores. Você pode então executar o script a partir da linha de comando usando o seguinte comando:

bash sign.sh 0517a86e26