Registo de dispositivos e nova assinatura de aplicações

Nesta página, você pode ler sobre as etapas a serem seguidas ao distribuir um aplicativo iOS para testadores específicos. Saiba o que é o registro, o provisionamento e a reassinatura de aplicativos de dispositivos. Você também pode aprender a usar a funcionalidade do App Center para tornar esse processo o mais indolor possível. Finalmente, existem soluções para alguns problemas comuns que você pode encontrar.

Assinatura de aplicativos, nova assinatura e provisionamento de dispositivos

Os programadores assinam aplicações para fins de segurança, conforme exigido pela Apple durante a distribuição. O requisito é o mesmo para a distribuição através do Xcode, App Center ou 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 aplicativos.

O diagrama a seguir exibe todo o fluxo de reassinatura do aplicativo no App Center. Vamos analisar essas etapas com mais detalhes.

A reassinatura do 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 Tester 1 e do Tester 2. Para fazer isso, assine seu aplicativo com um perfil de provisionamento ad hoc . Esse perfil de provisionamento tem uma lista de identificadores exclusivos de dispositivo (UDIDs). Somente os dispositivos que estão nessa lista são "provisionados" ou capazes de instalar o .ipa. O App Center pode detetar se um dispositivo está provisionado, porque conhecemos o UDID do dispositivo desde quando o testador registrou seu dispositivo pela primeira vez no App Center. Se detetarmos 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 testes:

1. Registe os dispositivos na sua conta de programador Apple.
2. Adicione-os ao seu perfil de provisionamento.
3. Gere um novo perfil de provisionamento.
4. Baixe o perfil de provisionamento.
5. Crie seu aplicativo com esse perfil.

Quando outro novo dispositivo aparecer, como o dispositivo com UDID 3 no diagrama, repita estas etapas. Isso pode ser inconveniente, e você não quer mudar 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 renovação do contrato. Isso significa pegar uma compilação de aplicativo existente e assiná-la novamente (assinar novamente) com um perfil de provisionamento diferente, para que você não precise criar uma nova compilação.

O App Center ajuda você com esse processo e também pode automatizá-lo. Estas são as etapas manuais e automáticas mostradas no diagrama, provisionando o dispositivo com UDID 3. O App Center ajuda-o a registar IDs de dispositivos de teste na sua conta de programador Apple, a criar um novo perfil de aprovisionamento e a assinar novamente a aplicação a partir do portal do App Center. O App Center requer acesso à sua conta de programador Apple para registar os dispositivos.

Para adicionar dispositivos manualmente a uma versão existente, você pode usar Registrar dispositivos na página de um grupo de distribuição. Consulte Registo de dispositivos.

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, em seguida, clique no grupo específico que pretende gerir. Você também pode optar por adicionar dispositivos automaticamente ao distribuir uma nova versão. Esta 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. Estes são os passos inferiores no diagrama.

Capacidades de reassinatura

Alguns aspetos a ter em conta quando reinicia sessão 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, você deve primeiro 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 poder usar os recursos do dispositivo do App Center, você deve:

1. Disponha do certificado de produção utilizado na assinatura inicial da aplicação.
2. Tenha as credenciais da sua conta de programador Apple que detém a função de Titular da Conta, Administrador ou Gestor de Aplicações.
3. Use Gerenciar assinatura manualmente em vez de Gerenciar assinatura automaticamente ao distribuir o aplicativo do Xcode.

Registo 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 o status "não provisionado" e uma mensagem na parte superior dizendo que há dispositivos não provisionados. Siga estes passos para registar os dispositivos:

1. Selecione o botão Registrar dispositivos .
2. Uma caixa de diálogo solicita seu nome de usuário e senha usados no portal do desenvolvedor da Apple.
3. Depois de iniciar sessão com o seu nome de utilizador e palavra-passe Apple, o App Center adiciona os dispositivos não provisionados à sua conta de programador Apple e ao perfil de provisionamento de versões.
4. 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 preferir lidar com a reconstrução do seu aplicativo com o perfil de provisionamento atualizado separadamente, você ainda pode usar o App Center para registrar os dispositivos do testador automaticamente no portal do desenvolvedor da Apple sem a etapa de nova assinatura. Para fazer isso, deixe a opção Assinar novamente meu aplicativo desmarcada 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 através 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 provisionados no grupo de distribuição; se isso acontecer, você pode marcar a caixa de seleção Registrar dispositivos e assinar novamente o aplicativo . Em seguida, o App Center executa três operações para você:

1. Registe novos IDs de dispositivos no portal do programador Apple.
2. Adicione os dispositivos ao perfil de provisionamento e baixe-o.
3. 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 do portal do desenvolvedor da Apple e o certificado usado para assinar o aplicativo no momento da compilação. Você fornece o certificado como um arquivo .p12 exportado. Leia mais sobre como gerar um arquivo .p12. Se já tiver o seu ID Apple e certificado guardados no App Center, pode escolhê-lo nos menus pendentes.

Preocupações de privacidade sobre nome de utilizador e palavra-passe

Quando adiciona as suas credenciais Apple e um certificado de assinatura ao App Center, utilizamos uma ligação segura. O App Center armazena as informações em um cofre criptografado. Não é possível para qualquer usuário baixar ou recuperar informações confidenciais do cofre.

Se você fornecer esse conjunto de credenciais e um certificado, ele estará automaticamente disponível para os colaboradores do aplicativo, mas apenas para esse serviço específico. Como exemplo, digamos que o desenvolvedor X adiciona credenciais e certificados ao grupo de distribuição "Tester". 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 irá usá-los para o desenvolvedor Y. O App Center só usa seu ID Apple durante a transação e não o usa para mais nada.

Limite de registo de dispositivos Apple

Cada conta de desenvolvedor da Apple tem um número finito de vagas para dispositivos, limitado por tipo de dispositivo. A Apple funciona com cinco tipos de dispositivos: iPad, iPhone, iPod, Apple TV e Apple Watch. Cada um deles tem uma limitação de 100 dispositivos. Imagine que você registra seis dispositivos, todos iPhones. Em seguida, você tem 94 IDs de dispositivo restantes para iPhones e ainda tem 100 restantes para cada um dos outros quatro tipos de dispositivos. Só pode cancelar o registo de dispositivos uma vez por ano para recuperar essas vagas.

Como gerar um arquivo .p12

Você pode armazenar um certificado de distribuição da Apple e uma chave privada em um arquivo de troca de informações privadas (.p12). Para fazer isso, você precisa de um certificado de produção da Apple armazenado em sua máquina local. Se não o fizer, não terá a chave privada.

1. Abra a aplicação Acesso às Chaves no Mac e selecione a categoria Os Meus Certificados à esquerda.
2. Encontre 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 estas etapas na máquina onde criou o certificado.
3. Selecione o certificado ou a chave privada ou ambos. Em seguida, clique com o botão direito do mouse no(s) item(ns) selecionado(s) para obter o menu de contexto e selecione a ação que começa com Exportar.
4. Selecione um local no disco para salvar o arquivo como .p12. Escolha uma senha forte para o arquivo.

Como remover certificados e IDs Apple do App Center

Pode remover os certificados e os IDs Apple do App Center nas contas de programador.

1. Selecione Configurações da conta abaixo da sua foto de perfil no canto superior direito.
2. Selecione Contas de desenvolvedor.
3. Remova o segredo usando os três pontos verticais no lado direito da tabela e, em seguida, Excluir certificado.
4. Verifique o nome do certificado e confirme sua ação irreversível selecionando Excluir mais uma vez.

Leia mais sobre como gerir o seu ID Apple e certificados.

Registar manualmente dispositivos com a Apple

Se estiver a tentar distribuir diretamente a utilizadores fora do App Center, pode seguir os passos a partir do Web site do Apple Developer sobre como distribuir para dispositivos registados. As etapas descrevem como adicionar dispositivos manualmente à sua conta e assinar novamente seu aplicativo.

Erros conhecidos

Perfil não encontrado

Ao iniciar sessão na Apple através do App Center, verificamos o(s) perfil(s) de aprovisionamento incluído(s) na sua aplicação em comparação com os da sua conta de programador. Se algum perfil usado em um binário não for encontrado na sua conta de desenvolvedor da Apple, o App Center não poderá assinar novamente seu aplicativo. Para resolver este problema, certifique-se de que a sua conta de programador Apple contém todos os perfis de aprovisionamento utilizados na sua aplicação. Você pode verificar os perfis de aplicativo na guia Geral das propriedades do seu projeto Xcode ou nas opções de assinatura de pacote do iOS no Visual Studio para Mac.

Equipa não encontrada

Ao iniciar sessão na Apple através do App Center, as equipas incluídas nas suas aplicações são comparadas com as da sua conta de programador. Se alguma equipa utilizada no binário não for encontrada na sua conta de programador Apple, o App Center não poderá voltar a assinar a sua aplicação. Para resolver este problema, certifique-se de que a sua conta de programador Apple contém a equipa utilizada na sua aplicação. Você pode verificar a equipe de aplicativos na guia Geral das propriedades do seu 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 o seu contrato de licença. Para continuar a usar o portal do desenvolvedor da Apple, você deve ler e concordar com a licença atualizada.

1. Inicie sessão no portal do programador Apple.
2. Siga as instruções fornecidas para aceitar o contrato de licença.

O App Center não pode ajudar com o conteúdo da licença ou o fluxo do contrato de licença.

Nosso testador não registrou o ID do dispositivo

Se um testador acidentalmente selecionou Eu já o registei, siga estes passos para registar um dispositivo manualmente:

1. Aceda a https://install.appcenter.ms/register-device no seu dispositivo móvel.
2. Selecione Registrar e siga as instruções na tela.