Compartilhar via


Assinatura de código manual no iOS

Este artigo explica como usar assinatura de código para o iOS. Você precisará assinar seu aplicativo para iOS se tiver selecionado iOS como uma das plataformas ao criar seu projeto de empacotamento.

Importante

Não há suporte para usar o Xcode para assinar digitalmente seus aplicativos móveis preparados para iOS. Siga as instruções abaixo para assinar corretamente seus pacotes de aplicativos móveis preparados para iOS.

Antes de começar

Pré-requisitos

Antes de começar, verifique se você tem:

  • ID do Aplicativo
  • UDIDs de dispositivos (somente para fins de teste e desenvolvimento)
  • Um dispositivo macOS para assinar código para iOS

Configurar o seu Mac

  1. Instale Xcode. Mais informações: Xcode
  2. Instale o PowerShell para macOS. Mais informações: Instalação do PowerShell no macOS
  3. Inscrever-se no Programa para Desenvolvedores da Apple
  4. Para distribuição da organização, inscreva-se no Programa para Desenvolvedores Corporativos da Apple

Criar ID do aplicativo

  1. Entre na sua conta de desenvolvedor em https://developer.apple.com e selecione a guia Conta.

    Guia Conta.

  2. Vá para Certificados, IDs & perfis > Identificadores.

  3. Selecione + para criar um novo identificador.

    Criar um identificador.

  4. Selecione IDs de Aplicativo e depois Continuar.

    Registrar um novo identificador

  5. Selecione o tipo como Aplicativo e depois Continuar.

  6. Registre um ID do Aplicativo:

    Registrar um ID de aplicativo.

    • Descrição: nome do seu aplicativo.
    • ID do pacote: selecione ID do pacote explícito.
    • Insira a ID do pacote que você usou ao criar o projeto de empacotamento. Mais informações: ID do pacote
    • Ative estes recursos:
      • Domínios associados
      • iCloud
      • Leitura de marcas NFC
      • Notificações por push
    • Selecione Continuar.
  7. Revise e registre a ID do Aplicativo.

Criar um certificado de distribuição

Criar Solicitação de Assinatura de Certificado (CSR)

  1. No seu computador Mac, vá para a pasta Aplicativos>Utilitários> abra Acesso ao Conjunto de Chaves.

  2. Selecione Acesso ao conjunto de chaves>Assistente de certificados>Solicitar um certificado de uma autoridade de certificação.

    Solicitar um certificado de uma AC.

  3. Preencha Informações do Certificado:

    • No campo Endereço de Email do Usuário, insira seu endereço de email do Apple ID
    • No campo Nome Comum, digite seu nome.
    • No grupo Solicitação, selecione Salvo em disco.
    • Salve o arquivo no seu computador Mac.
    • Selecione Continuar.

Carregar e instalar certificado

  1. Entre na sua conta de desenvolvedor em https://developer.apple.com selecionando a guia Conta.

  2. Acesse Certificados, IDs & perfis > Certificados.

  3. Selecione + para criar um novo certificado.

  4. Selecione App Store e Ad Hoc>Continuar.

    Certificados, identificadores & perfis

    Nota

    Se você tiver uma Conta de Desenvolvedor Corporativo, você terá a opção de criar um certificado de Distribuição Corporativo.

  5. Carregue o arquivo de Solicitação de Assinatura de Certificado (CSR) que foi gerado nas etapas anteriores.

    Carregar o certificado.

  6. Selecione Continuar e baixe o certificado em seu computador Mac.

  7. Clique duas vezes no arquivo .cer baixado para instalar no Acesso ao Conjunto de Chaves.

  8. Anote o Nome do certificado (geralmente formatado como Distribuição do iPhone: Nome (ID da Equipe)). Esse valor é a identidade de assinatura de código necessária para assinatura.

Registrar dispositivos para testes

Nota

Essa etapa só será necessária se você estiver distribuindo o aplicativo para usuários externos. Ela não será necessária se o aplicativo for apenas para usuários internos.

  1. Entre na sua conta de desenvolvedor em https://developer.apple.com selecionando a guia Conta.

  2. Acesse Certificados, IDs & perfis > Dispositivos.

  3. Selecione + para registrar um ou mais dispositivos.

  4. Insira o Nome do Dispositivo e ID do dispositivo (UDID).

    Registrar um dispositivo.

  5. Selecione Salvar.

    Gorjeta

    Você também pode registrar vários dispositivos uma vez carregando uma lista de UDIDs.

Criar perfil de provisionamento do iOS

  1. Entre na sua conta de desenvolvedor em https://developer.apple.com e selecione a guia Conta.

  2. Vá para Certificados, IDs & perfis > Perfis.

  3. Selecione + para criar um novo perfil.

  4. Selecione Ad Hoc>Continuar.

    Ad Hoc.

    Nota

    Para uso em produção, selecione o método de distribuição do App Store.

  5. Selecione a ID do Aplicativo que você criou anteriormente e escolha Continuar.

    ID do Aplicativo.

  6. Selecione o certificado que você criou anteriormente e escolha Continuar.

    Selecionar o certificado.

  7. Selecione todos os dispositivos de teste onde você deseja instalar seu aplicativo, depois escolha Continuar.

    Adicionar dispositivos.

  8. Nomeie o perfil de provisionamento e anote o nome.

  9. Selecione Gerar e baixe o perfil de seu Mac.

  10. Clique duas vezes no arquivo baixado (*.mobileprovision) para registrá-lo no Xcode.

Assinar o arquivo iOS

  1. Baixe e descompacte o arquivo iOS-Archive.zip do Armazenamento de Blobs do Azure. Isso cria uma pasta nomeada com base na ID do Pacote. No exemplo abaixo, a ID do Pacote é com.single.wrap.

  2. Somente para assinatura corporativa: abra o arquivo Distribution-exportOptions.plist com Xcode e altere o valor do campo de método para corporativo.

    Observação

    Não há suporte à assinatura do Enterprise com a assinatura do Key Vault.

  3. Abra o Terminal e altere o diretório para a pasta descompactada.

  4. Insira pwsh para iniciar o PowerShell no terminal.

  5. Execute o script do PowerShell com seu certificado e informações de perfil de provisionamento:

    ./SignAndGenerateIPA.ps1 -CodeSigningIdentity "YOUR_CODE_SIGNING_IDENTITY" -ProvisioningProfilePath "PATH_TO_PROVISIONING_PROFILE"
    

    Nota

    Para encontrar seu valor CodeSigningIdentity, clique com o botão direito do mouse no arquivo .mobileprovision, selecione Mais Informações>Visualizar. Procure o campo Nome em Certificados.

    Gorjeta

    O ProvisioningProfilePath é o caminho para o arquivo .mobileprovision que você baixou. Por exemplo: /Users/username/Downloads/MyProvisioningProfile.mobileprovision

    Executar script do PowerShell.

  6. Quando o script é concluído, um arquivo .ipa é criado (por exemplo, com.single.wrap.ipa).

    Importante

    Se o script falhar, exclua a pasta e os arquivos descompactados, pois eles podem estar corrompidos. Descompacte iOS-Archive.zip novamente antes de tentar.

    Pacote IPA.

Distribuir o aplicativo

Instale o arquivo .ipa nos dispositivos cadastrados usando o aplicativo Finder.

Para distribuição corporativa com Microsoft Intune:

Consulte também