Registro de dispositivo e assinatura de aplicativo
Importante
O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar a migração.
Nesta página, você pode ler sobre as etapas a serem executadas ao distribuir um aplicativo iOS para testadores específicos. Saiba quais são o registro, o provisionamento e a assinatura do aplicativo. Você também pode aprender a usar a funcionalidade do App Center para tornar esse processo o mais indolor possível. Por fim, há soluções para alguns problemas comuns que você pode encontrar.
Assinatura de aplicativo, re-assinatura e provisionamento de dispositivo
Os desenvolvedores assinam aplicativos para segurança conforme exigido pela Apple ao distribuir. O requisito é o mesmo para distribuição por meio do Xcode, do App Center ou da iTunes Store. A assinatura de código é uma precaução para garantir que ninguém tenha adulterado seu aplicativo. Você pode ler mais na documentação da Apple sobre assinatura de aplicativo.
O diagrama a seguir exibe todo o fluxo de assinatura do aplicativo no App Center. Vamos examinar essas etapas com mais detalhes.
A assinatura de aplicativo só se aplica quando você deseja distribuir um aplicativo iOS para dispositivos de teste específicos. No diagrama, você deseja distribuir uma versão do aplicativo para os dispositivos do Testador 1 e do Testador 2. Para fazer isso, assine seu aplicativo com um perfil de provisionamento ad hoc . Esse perfil de provisionamento tem uma lista de UDIDs (identificadores de dispositivo) exclusivos. Somente os dispositivos que estão nessa lista são "provisionados" ou podem instalar o .ipa. O App Center pode detectar se um dispositivo está provisionado, pois sabemos a UDID do dispositivo de quando o testador registrou seu dispositivo pela primeira vez no App Center. Se detectarmos que o dispositivo que o testador está usando não está na lista de dispositivos provisionados para o .ipa que eles desejam baixar, mostraremos a mensagem "Os desenvolvedores estão trabalhando em uma versão para seu dispositivo".
Depois de saber quais dispositivos você deseja usar para testar:
- Registre os dispositivos em sua conta de desenvolvedor da Apple.
- Adicione-os ao seu perfil de provisionamento.
- Gere um novo perfil de provisionamento.
- Baixe o perfil de provisionamento.
- Crie seu aplicativo com esse perfil.
Quando outro novo dispositivo aparecer, como o dispositivo com UDID 3 no diagrama, repita essas etapas. Isso pode ser inconveniente e você não quer alterar seu sistema de integração contínua ou pedir ao desenvolvedor para sempre continuar adicionando novos dispositivos ao perfil e lançando novas compilações. É aqui que entra a re-assinatura. Isso significa usar um build de aplicativo existente e assotá-lo novamente (assinar novamente) com um perfil de provisionamento diferente, para que você não precise criar um novo build.
O App Center ajuda você com esse processo e também pode automatizá-lo. Essas são as etapas manuais e automáticas mostradas no diagrama, provisionando o dispositivo com a UDID 3. O App Center ajuda você a registrar IDs de dispositivo do testador em sua conta de desenvolvedor da Apple, criar um novo perfil de provisionamento e assinar novamente o aplicativo com tudo isso no portal do App Center. O App Center requer acesso à sua conta de desenvolvedor da Apple para registrar os dispositivos.
Para adicionar dispositivos manualmente a uma versão existente, você pode usar Registrar dispositivos na página para um grupo de distribuição. Consulte Registro de dispositivo.
Para adicionar dispositivos automaticamente, ative Gerenciar dispositivos automaticamente nas configurações do grupo de distribuição. Essa opção só pode ser acessada por meio de um grupo de distribuição no nível do aplicativo e não está disponível por meio de um grupo global. Você pode acessar um grupo de distribuição no nível do aplicativo selecionando o aplicativo no App Center e clicando em Distribuir. Em Distribuir, clique em Grupos e clique no grupo específico que você deseja gerenciar. Você também pode optar por adicionar automaticamente dispositivos ao distribuir uma nova versão. Essa opção está na etapa Dispositivos no assistente para distribuir uma nova versão.
O App Center adiciona o novo dispositivo à lista no perfil de provisionamento e assina novamente seu aplicativo com esse perfil de provisionamento. Agora, o novo dispositivo também pode instalar o aplicativo. Estas são as etapas inferiores no diagrama.
Recursos de re-assinatura
Alguns itens a serem observados ao usar a nova assinatura no App Center:
- O gerenciamento automático de dispositivos em grupos funciona apenas para distribuição para grupos não públicos e não compartilhados.
- Se você estiver distribuindo para usuários individuais, registre seus dispositivos manualmente e assine novamente o aplicativo. Para usar as ferramentas mencionadas neste artigo, primeiro você deve adicionar os testadores a um grupo.
- Se você adicionar vários grupos à sua versão, configure cada grupo separadamente usando Gerenciar dispositivos automaticamente nas configurações do grupo.
- O gerenciamento de dispositivos só é necessário para aplicativos iOS assinados com um perfil de desenvolvedor ou ad hoc.
Pré-requisitos
Antes de usar os recursos de dispositivo do App Center, você deve:
- Tenha o certificado de produção usado para a assinatura original do aplicativo.
- Tenha as credenciais para sua conta de desenvolvedor da Apple que detém a função de Titular da Conta, Administração ou Gerenciador de Aplicativos.
- Use Gerenciar manualmente a assinatura em vez de Gerenciar automaticamente a assinatura ao distribuir o aplicativo do Xcode.
Registro de dispositivos
Registrar um dispositivo significa torná-lo parte da lista de dispositivos no portal do Desenvolvedor da Apple que podem ser incluídos em um perfil de provisionamento. Para registrar um dispositivo, selecione um grupo de distribuição com pelo menos um dispositivo que ainda não esteja provisionado e navegue até a guia Dispositivos. Você verá um dispositivo aqui com a status "não comprovada" e uma mensagem na parte superior dizendo que há dispositivos não comprovados. Siga estas etapas para registrar os dispositivos:
- Selecione o botão Registrar dispositivos .
- Uma caixa de diálogo solicita seu nome de usuário e senha usados no portal do Desenvolvedor da Apple.
- Depois de entrar com seu nome de usuário e senha da Apple, o App Center adiciona os dispositivos não confirmados à sua conta de desenvolvedor da Apple e ao perfil de provisionamento de versões.
- Opcionalmente, você pode carregar um arquivo .p12 para assinar novamente o aplicativo e distribuí-lo para os dispositivos recém-adicionados. Leia mais sobre como gerar um arquivo .p12.
Se você preferir manipular a recriação do aplicativo com o perfil de provisionamento atualizado separadamente, ainda poderá usar o App Center para registrar os dispositivos do testador automaticamente no portal do desenvolvedor da Apple sem a etapa de re-assinatura. Para fazer isso, deixe Assinar novamente meu aplicativo desmarcado e baixe o perfil de provisionamento atualizado com o botão na tela de revisão. Você também pode baixar o perfil de provisionamento por meio do Xcode ou do portal do Desenvolvedor da Apple.
Distribuir uma nova versão
Quando você distribui uma nova versão para um grupo que não tem o gerenciamento automático de dispositivos habilitado, uma etapa Dispositivos faz parte do assistente. A etapa verifica se você tem dispositivos não comprovados no grupo de distribuição; se isso acontecer, você poderá marcar caixa de seleção Registrar dispositivos e assinar novamente o aplicativo. Em seguida, o App Center executa três operações para você:
- Registre novas IDs de dispositivo no portal do Desenvolvedor da Apple.
- Adicione os dispositivos ao perfil de provisionamento e baixe-os.
- Assine novamente o binário carregado para que todos os testadores possam instalá-lo.
O fluxo requer o nome de usuário e a senha para o portal do Desenvolvedor da Apple e o certificado usado para assinar o aplicativo em tempo de compilação. Você fornece o certificado como um arquivo .p12 exportado. Leia mais sobre como gerar um arquivo .p12. Se você já tiver sua ID da Apple e o certificado salvos no App Center, poderá selecioná-lo nos menus suspensos.
Preocupações de privacidade sobre nome de usuário e senha
Quando você adiciona suas credenciais da Apple e um certificado de autenticação ao App Center, usamos uma conexão segura. O App Center armazena as informações em um cofre criptografado. Não é possível que nenhum usuário baixe ou recupere informações confidenciais do cofre.
Se você fornecer esse conjunto de credenciais e um certificado, ele estará disponível automaticamente para colaboradores de aplicativos, mas apenas para esse serviço específico. Por exemplo, digamos que o desenvolvedor X adicione credenciais e certificados ao grupo de distribuição "Testador". Em seguida, quando o desenvolvedor Y distribui uma nova versão para o grupo "Testador", o nome de usuário, a senha e o certificado de X são selecionados por padrão. O App Center os usará para o desenvolvedor Y. O App Center usa apenas sua ID da Apple durante a transação e não a usa para mais nada.
Limite de registro de dispositivo da Apple
Cada conta de desenvolvedor da Apple tem um número finito de pontos para dispositivos por tipo de dispositivo. A Apple trabalha com cinco tipos de dispositivo: iPad, iPhone, iPod, Apple TV e Apple Watch. Cada um deles tem uma limitação de 100 dispositivos. Imagine que você registre seis dispositivos, todos os quais são iPhones. Em seguida, você tem 94 IDs de dispositivo restantes para iPhones e ainda tem 100 restantes para cada um dos quatro outros tipos de dispositivo. Você só pode cancelar o registro de dispositivos uma vez por ano para recuperar esses slots.
Como gerar um arquivo .p12
Você pode armazenar um certificado de distribuição da Apple e uma chave privada em um arquivo do Exchange de Informações Privadas (.p12). Para fazer isso, você precisa de um certificado de produção da Apple armazenado em seu computador local. Se você não fizer isso, então você não terá a chave privada.
- Abra o aplicativo Acesso ao Conjunto de Chaves em seu Mac e selecione a categoria Meus Certificados à esquerda.
- Localize o certificado de distribuição correto e expanda-o para ver a chave privada correspondente. a. Se a chave privada não estiver lá, você deverá criar um novo certificado ou executar essas etapas no computador em que criou o certificado.
- Selecione o certificado ou a chave privada ou ambos. Em seguida, clique com o botão direito do mouse nos itens selecionados para obter o menu de contexto e selecione a ação que começa com Exportar.
- Selecione um local no disco para salvar o arquivo como um .p12. Escolha uma senha forte para o arquivo.
Como remover certificados e IDs da Apple do App Center
Você pode remover os certificados e as IDs da Apple do App Center nas contas de desenvolvedor.
- Selecione Configurações da Conta em sua imagem de perfil no canto superior direito.
- Selecione Contas de desenvolvedor.
- Remova o segredo usando os três pontos verticais no lado direito da tabela e, em seguida, Exclua o certificado.
- Verifique o nome do certificado e confirme sua ação irreversível selecionando Excluir mais uma vez.
Leia mais sobre como gerenciar sua ID e certificados da Apple.
Registrar dispositivos manualmente com a Apple
Se você estiver tentando distribuir diretamente para usuários fora do App Center, siga as etapas no site do Desenvolvedor da Apple sobre como distribuir para dispositivos registrados. As etapas descrevem como adicionar manualmente dispositivos à sua conta e assinar novamente seu aplicativo.
Erros conhecidos
Perfil não encontrado
Ao entrar na Apple por meio do App Center, marcar os perfis de provisionamento incluídos em seu aplicativo em relação àqueles em sua conta de desenvolvedor. Se qualquer perfil usado em um binário não for encontrado em sua conta de desenvolvedor da Apple, o App Center não poderá assinar novamente seu aplicativo. Para resolve isso, verifique se sua conta de desenvolvedor da Apple contém todos os perfis de provisionamento usados em seu aplicativo. Você pode marcar perfis de aplicativo na guia Geral das propriedades do projeto Xcode ou nas opções de Assinatura de Pacote do iOS no Visual Studio para Mac.
Observação
Ao tentar provisionar automaticamente um binário por meio do App Center, em alguns casos, os perfis de provisionamento gerados automaticamente pelo Xcode resultarão na falha do provisionamento automático com o seguinte erro: Perfil chamado 'equipe do iOS ...' não foi encontrado na conta. Para resolve o problema, crie e use o perfil de provisionamento criado manualmente.
Equipe não encontrada
Ao entrar na Apple por meio do App Center, as equipes incluídas em seus aplicativos são verificadas em relação às da sua conta de desenvolvedor. Se qualquer equipe usada no binário não for encontrada em sua conta de desenvolvedor da Apple, o App Center não poderá assinar novamente seu aplicativo. Para resolve isso, verifique se sua conta de desenvolvedor da Apple contém a equipe usada em seu aplicativo. Você pode marcar a equipe de aplicativos na guia Geral das propriedades do projeto Xcode ou as opções de Assinatura de Pacote do iOS no Visual Studio para Mac.
Contrato de licença atualizado
A Apple atualiza periodicamente seu contrato de licença. Para continuar usando o portal do Desenvolvedor da Apple, você deve ler e concordar com a licença atualizada.
- Entre no portal do Desenvolvedor da Apple.
- Siga as instruções fornecidas para aceitar o contrato de licença.
O App Center não pode ajudar com o conteúdo na licença ou o fluxo do contrato de licença.
Nosso testador não registrou a ID do dispositivo
Se um testador tiver selecionado acidentalmente eu já o registrei, siga estas etapas para registrar um dispositivo manualmente:
- Vá para https://install.appcenter.ms/register-device em seu dispositivo móvel.
- Selecione Registrar e siga as instruções na tela.