Publicar um aplicativo iOS para distribuição interna
A distribuição interna permite que membros do Programa de Desenvolvedores da Apple para Empresas distribuam aplicativos internamente para outros membros da mesma organização. Ela tem as vantagens de não exigir uma análise da App Store e não ter nenhum limite de número de dispositivos nos quais um aplicativo pode ser instalado. No entanto, membros do Programa de Desenvolvedores Corporativos da Apple não têm acesso ao App Store Connect e, portanto, o licenciado é responsável por distribuir o aplicativo.
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 interna contém uma ID do aplicativo e um certificado de distribuição. 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 sua organização, se ainda não tiver um.
O processo para criar um perfil de provisionamento de distribuição interna é o seguinte:
- Crie um certificado de distribuição. Para obter mais informações, confira Criar um certificado de distribuição.
- 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 permite que seu aplicativo iOS do .NET MAUI seja assinado digitalmente para lançamento. Um perfil de provisionamento de distribuição interna contém uma ID do aplicativo e um certificado de distribuição.
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 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 do seu aplicativo no formato DNS 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 Registrar uma ID do aplicativo, insira os detalhes da implantação, se você os tiver, antes de clicar 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 de distribuição:
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 Interno 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 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 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 interna:
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, clique no botão Enterprise:
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.
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.
Os aplicativos internos podem ser distribuídos por meio de um site seguro ou por meio do MDM (gerenciamento de dispositivo móvel). Ambas as abordagens exigem que o aplicativo esteja preparado para distribuição, o que inclui a preparação de um manifesto. Para obter mais informações, consulte Distribuir aplicativos internamente proprietários para dispositivos da Apple em support.apple.com.
