Publicar um aplicativo iOS para distribuição ad hoc
A distribuição ad hoc é usada principalmente para testar aplicativos em um amplo grupo de pessoas e está disponível para o Programa de Desenvolvedores da Apple e para o Programa de Desenvolvedores da Apple para Empresas. Outro caso de uso para a distribuição ad hoc é distribuição dentro de uma empresa quando o App Store Connect não for uma opção.
A distribuição ad hoc tem a vantagem de não exigir a aprovação da App Store, e os aplicativos são instalados com o Apple Configurator. No entanto, é limitado a 100 dispositivos por ano de assinatura, tanto para desenvolvimento quanto para distribuição, e os dispositivos devem ser adicionados à sua Conta de Desenvolvedor da Apple.
A distribuição de um aplicativo iOS requer que o aplicativo seja provisionado usando um perfil de provisão. Perfis de provisionamento são arquivos que contêm informações de assinatura de código, bem como a identidade do aplicativo e seu mecanismo de distribuição pretendido.
Para distribuir um aplicativo iOS da interface do usuário de aplicativo multiplataforma do .NET (.NET MAUI), você precisará criar um perfil de provisão de distribuição específico para ele. Este perfil permite que o aplicativo seja assinado digitalmente para lançamento para que ele possa ser instalado em um dispositivo iOS. Um perfil de provisionamento de distribuição ad hoc contém uma ID do aplicativo, um certificado de distribuição e uma lista dos dispositivos que podem instalar o aplicativo. Você pode usar a mesma ID do Aplicativo usada ao implantar seu aplicativo em um dispositivo para teste. No entanto, você precisará criar um certificado de distribuição para identificar a si mesmo ou sua organização, se ainda não tiver um.
O processo para criar um perfil de provisionamento de distribuição ad hoc é o seguinte:
- Crie um certificado de distribuição. Para obter mais informações, confira Criar um certificado de distribuição.
- Adicionar dispositivos à sua conta de desenvolvedor da Apple. Para mais informações, confira Adicionar um dispositivo.
- Crie uma ID do Aplicativo. Para obter mais informações, confira Criar uma ID do aplicativo.
- Crie um perfil de provisão. Para obter mais informações, confira Criar um perfil de provisão.
Criar um certificado de distribuição
Um certificado de distribuição é usado para confirmar a sua identidade. Antes de criar um certificado de distribuição, você deve garantir que você tenha adicionado a sua Conta de desenvolvedor da Apple ao Visual Studio. Para obter mais informações, confira Gerenciamento de contas da Apple.
Você só precisa criar um certificado de distribuição se ainda não tiver um. O certificado de distribuição deve ser criado usando a ID da Apple para sua Conta de desenvolvedor da Apple.
Para criar um certificado de distribuição no Visual Studio:
- No Visual Studio, acesse Ferramentas > Opções > Xamarin > Contas da Apple.
- Na caixa de diálogo Contas de Desenvolvedor da Apple, selecione uma equipe e clique no botão Exibir Detalhes....
- Na caixa de diálogo Detalhes, clique em Criar certificado e selecione Distribuição do iOS. Uma nova identidade de assinatura será criada e será sincronizada com a Apple, desde que você tenha as permissões corretas.
Importante
A chave privada e o certificado que compõem sua identidade de assinatura também serão exportados para o Keychain Access no host de build do Mac, desde que o IDE esteja emparelhado com ele. Para obter mais informações, consulte Emparelhar com Mac para desenvolvimento para iOS.
Entendendo pares de chaves de certificado
Um perfil de distribuição contém certificados, suas chaves associadas e todos os perfis de provisionamento associados à sua Conta de desenvolvedor da Apple. Há duas versões do perfil de distribuição: uma existe em sua Conta de desenvolvedor da Apple e a outra reside em um computador local. A diferença entre eles é o tipo de chaves que eles contêm: o perfil em sua Conta de desenvolvedor da Apple contém todas as chaves públicas associadas aos seus certificados, enquanto a cópia em seu computador local contém todas as chaves privadas. Para que os certificados sejam válidos, os pares de chave devem corresponder.
Aviso
Perder o certificado e as chaves associadas pode ser incrivelmente disruptivo, pois exigirá a revogação de certificados existentes e a recriação de perfis de provisionamento.
Criar um perfil de distribuição
Um perfil de provisionamento de distribuição ad hoc permite que seu aplicativo iOS do .NET MAUI seja assinado digitalmente para lançamento, para que ele possa ser instalado em dispositivos iOS específicos. Um perfil de provisionamento de distribuição ad hoc contém uma ID do aplicativo, um certificado de distribuição e uma lista dos dispositivos que podem instalar o aplicativo. Os dispositivos aos quais você deseja dar suporte devem estar executando uma versão do iOS que o Xcode aceite.
Adicionar um dispositivo
Ao criar um perfil de provisionamento, o perfil deve incluir quais dispositivos podem executar o aplicativo. Antes de selecionar um dispositivo a ser adicionado a um perfil de provisionamento, primeiro adicione o dispositivo à sua conta de desenvolvedor da Apple. Você pode adicionar o dispositivo da seguinte forma:
Conecte o dispositivo a ser provisionado ao Mac local com um cabo USB.
Abra Xcode e navegue até Janela > Dispositivos e Simuladores.
Em Xcode, selecione a guia Dispositivos e depois o dispositivo na lista de dispositivos conectados.
Em Xcode, copie o valor do Identificador para a área de transferência:
Em um navegador da Web, vá para a seção Dispositivos da sua Conta de desenvolvedor da Apple e clique no botão +.
Na página Registrar um novo dispositivo, defina a Plataforma correta e dê um nome para o novo dispositivo. Em seguida, cole o identificador da área de transferência no campo Identificação do dispositivo (UDID) e clique em Continuar:
Na página Registrar novo dispositivo, revise as informações e clique em Registrar.
Repita as etapas anteriores para qualquer dispositivo iOS em que queira implantar um aplicativo iOS do .NET MAUI.
Criar uma ID do Aplicativo
Uma ID do Aplicativo é necessária para identificar o aplicativo que você está distribuindo. Uma ID do Aplicativo é semelhante a uma cadeia de caracteres DNS reversa, que identifica exclusivamente um aplicativo e deve ser idêntica ao identificador de pacote do aplicativo. Você pode usar a mesma ID do Aplicativo usada ao implantar seu aplicativo em um dispositivo para teste.
Há dois tipos de ID do Aplicativo:
- Curinga. Uma ID do Aplicativo curinga permite que você use uma única ID do Aplicativo para corresponder a vários aplicativos, e normalmente usa o formato
com.domainname.*. Uma ID do Aplicativo curinga pode ser usada para distribuir vários aplicativos e deve ser usada para aplicativos que não habilitam recursos específicos do aplicativo. - Explícita. Uma ID do Aplicativo explícita é exclusiva de um único aplicativo e normalmente usa o formato
com.domainname.myid. Uma ID do Aplicativo explícita permite a distribuição de um aplicativo, com um identificador de pacote correspondente. IDs do Aplicativo explícitas normalmente são usadas para aplicativos que habilitam recursos específicos do aplicativo, como Apple Pay ou Game Center. Para obter mais informações sobre recursos, confira Recursos.
Para criar uma nova ID do Aplicativo:
Em sua Conta de desenvolvedor da Apple, navegue até Certificados, IDs e Perfis.
Na página Certificados, Identificadores e Perfis, selecione a guia Identificadores.
Na página Identificadores, clique no botão + para criar uma nova ID do Aplicativo.
Na página Registrar um novo identificador, selecione o botão de opção IDs do Aplicativo antes de clicar no botão Continuar:
Na página Registrar um novo identificador, selecione Aplicativo antes de clicar no botão Continuar:
Na página Registrar uma ID do Aplicativo, insira uma descrição e selecione o botão de opção de ID do Pacote Explícito ou Curinga. Em seguida, insira a ID do Pacote para o seu aplicativo no formato DS inverso:
Importante
A ID do Pacote inserida deve corresponder ao Identificador de pacote no arquivo Info.plist em seu projeto de aplicativo.
O identificador de pacote para um aplicativo do .NET MAUI é armazenado no arquivo de projeto como a propriedade da ID do Aplicativo. No Visual Studio, no Gerenciador de Soluções, clique com o botão direito do mouse em seu projeto de aplicativo .NET MAUI e selecione Propriedades. Em seguida, navegue até a guia Geral > Compartilhado MAUI. O campo ID do Aplicativo lista o identificador do pacote.
Quando o valor do campo ID do Aplicativo for atualizado, o valor do Identificador do pacote no arquivo Info.plist será atualizado automaticamente.
Na página Registrar uma ID do Aplicativo, selecione todos os recursos usados pelo aplicativo. Todos os recursos devem ser configurados nesta página e no arquivo Entitlements.plist em seu projeto de aplicativo. Para obter mais informações, confira Recursos e Direitos.
Na página Registrar uma ID do Aplicativo, clique no botão Continuar.
Na página Confirmar sua ID do Aplicativo, clique no botão Registrar.
Criar um perfil de provisão
Depois que a ID do Aplicativo tiver sido criada, você deverá criar um perfil de provisão de distribuição. Este perfil permite que o aplicativo seja assinado digitalmente para lançamento para que ele possa ser instalado em um dispositivo iOS.
Para criar um perfil de provisionamento para distribuição ad hoc:
Na página Certificados, Identificadores e Perfis da sua Conta de Desenvolvedor da Apple, selecione a guia Perfis.
Na guia Perfis, clique no botão + para criar um novo perfil.
Na página Registrar um novo perfil de provisionamento, clique no botão de opção Ad hoc antes de clicar no botão Continuar:
Na página Gerar um perfil de provisão, na lista suspensa ID do aplicativo, selecione a ID do aplicativo que você criou anteriormente e escolha se você quer criar um perfil offline antes de clicar no botão Continuar:
Na página Gerar um perfil de provisão, selecione o botão de opção que corresponde ao certificado de distribuição antes de clicar no botão Continuar:
Na página Gerar perfil de provisionamento, selecione os dispositivos nos quais o aplicativo será instalado e clique no botão Continuar.
Na página Gerar um perfil de provisão, insira um nome para o perfil de provisão antes de clicar no botão Gerar:
Observação
Anote o nome do perfil de provisão, pois ele será necessário ao assinar o seu aplicativo.
Na página Gerar um perfil de provisão, opcionalmente, clique no botão Baixar para baixar o seu perfil de provisão.
Observação
Não é necessário baixar oseu perfil de provisão agora. Em vez disso, você fará isso no Visual Studio.
Baixar perfis de provisionamento no Visual Studio
Depois de criar um perfil de provisionamento de distribuição em sua conta de desenvolvedor da Apple, o Visual Studio poderá baixá-lo para ele ficar disponível para assinar o seu aplicativo.
- No Visual Studio, acesse Ferramentas > Opções > Xamarin > Contas da Apple.
- Na caixa de diálogo Contas de desenvolvedor da Apple, selecione a sua equipe e clique em Exibir detalhes.
- Na caixa de diálogo Detalhes, verifique se o novo perfil aparece na lista Perfis de provisão. Talvez seja necessário reiniciar o Visual Studio para atualizar a lista.
- Na caixa de diálogo Detalhes, clique em Baixar todos os perfis.
Os perfis de provisionamento são baixados no Windows e exportados para o host de build do Mac se o IDE estiver emparelhado com ele. Para obter mais informações, consulte Emparelhar com Mac para desenvolvimento para iOS.
Publicar o aplicativo
O Visual Studio pode publicar um aplicativo iOS do .NET MAUI para distribuição ad hoc:
No Visual Studio, certifique-se de que o IDE esteja emparelhado com um host de build do Mac. Para obter mais informações, consulte Emparelhar com Mac para desenvolvimento para iOS.
Na barra de ferramentas do Visual Studio, use a lista suspensa Destino de depuração para selecionar Dispositivos remotos iOS e, em seguida, Dispositivo remoto:
Na barra de ferramentas do Visual Studio, use a lista suspensa Configuração de soluções para alterar da configuração de depuração para a configuração de versão:
No Gerenciador de Soluções, clique com o botão direito do mouse no projeto do aplicativo .NET MAUI e selecione Propriedades. Em seguida, navegue até a guia Assinatura de pacote do iOS e certifique-se de que Esquema esteja definido como Provisionamento Manual, a Identidade de assinatura esteja definida como Distribuição (Automática) e o Perfil de provisão esteja definido como Automático:
Essas configurações garantirão que o Visual Studio selecione o perfil de provisão correto com base no identificador de pacote no Info.plist (que é idêntico ao valor da propriedade ID do Aplicativo em seu arquivo de projeto). Como alternativa, defina a Identidade de assinatura como o certificado de distribuição apropriado e o Perfil de provisão como o perfil que você criou em sua conta de desenvolvedor da Apple.
No Gerenciador de Soluções, clique com o botão direito do mouse no projeto do aplicativo .NET MAUI e selecione Publicar...:
O Gerenciador de arquivos será aberto e o Visual Studio começará a arquivar o pacote do aplicativo:
O processo de arquivamento assina o aplicativo com os perfis de certificado e provisionamento especificados na guia Assinatura de pacote do iOS para a configuração da solução selecionada.
No Gerenciador de arquivos, depois que o arquivamento for concluído com êxito, certifique-se de que o arquivo esteja selecionado e selecione o botão Distribuir... para iniciar o processo de empacotamento do aplicativo para distribuição:
A caixa de diálogo Distribuir – selecionar canal será exibida.
Na caixa de diálogo Distribuir - Selecionar canal, selecione o botão Ad Hoc:
Na caixa de diálogo Distribuição – identidade de assinatura, selecione sua identidade de assinatura e perfil de provisão:
Observação
Você deve usar a identidade de assinatura e o perfil de provisão que foram criados para o seu aplicativo e o canal de distribuição selecionado.
Na caixa de diálogo Distribuir – Identidade de assinatura, clique no botão Salvar como e insira um nome de arquivo. Em seguida, o aplicativo será assinado novamente e publicado em um arquivo .ipa no sistema de arquivos.
O aplicativo pode então ser distribuído usando o Apple Configurator. Para obter mais informações, consulte o guia do usuário do Apple Configurator em support.apple.com.
Para obter informações sobre como publicar um aplicativo iOS usando a interface de linha de comando (CLI), confira Publicar um aplicativo iOS usando a linha de comando.
