Provisionamento automático para aplicativos iOS

O provisionamento automático é a abordagem recomendada para implantar um aplicativo iOS .NET Multi-Platform App UI (.NET MAUI) em um dispositivo. Com essa abordagem, o Visual Studio cria e gerencia automaticamente identificações de assinatura, IDs de aplicativo e perfis de provisionamento. Antes de iniciar o processo de provisionamento automático, verifique se adicionou sua conta de desenvolvedor Apple ao Visual Studio. Para obter mais informações, consulte Gerenciamento de contas da Apple.

Depois de adicionar sua conta de desenvolvedor da Apple ao Visual Studio, você poderá usar qualquer equipe associada. Certificados, IDs de aplicativo e perfis podem ser criados contra a equipe. O ID da equipe também é usado para criar um prefixo para o ID do aplicativo que será incluído no perfil de provisionamento, o que permite que a Apple verifique se um aplicativo pode ser implantado em um dispositivo.

Importante

Antes de começar, certifique-se de que aceitou todos os contratos de licença de utilizador na sua Conta de Programador Apple e App Store Connect.

Habilitar o provisionamento automático

Depois de adicionar sua conta de desenvolvedor Apple ao Visual Studio, você precisará habilitar o provisionamento automático para o projeto de aplicativo .NET MAUI.

Visual Studio

1. 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 Assinatura de pacote do iOS > e verifique se Provisionamentoautomático está selecionado na lista suspensa Esquema:

   

2. Nas configurações de Assinatura de Pacote , clique no hiperlink Configurar Provisionamento Automático.

3. Na caixa de diálogo Configurar provisionamento automático, selecione sua equipe. O Visual Studio tentará provisionar automaticamente seu projeto e indicará se o processo foi concluído com êxito:

   

   Se o provisionamento automático falhar, a caixa de diálogo Configurar provisionamento automático exibirá o motivo do erro.

4. Na caixa de diálogo Configurar provisionamento automático, clique no botão Ok para descartar a caixa de diálogo.

Visual Studio para Mac

Observação

O Visual Studio para Mac está programado para ser desativado até 31 de agosto de 2024, de acordo com a Política de Ciclo de Vida Moderno da Microsoft. O Visual Studio para Mac 17.6 continuará a ter suporte até 31 de agosto de 2024, com atualizações de manutenção para problemas de segurança e plataformas atualizadas da Apple. Para obter mais informações, incluindo opções alternativas para desenvolver em um Mac, consulte O que está acontecendo com o Visual Studio para Mac?.

1. Na janela Solução, clique duas vezes no arquivo Info.plist na pasta Plataformas > iOS do seu projeto de aplicativo .NET MAUI para abri-lo no editor.

2. No editor Info.plist, altere do modo de exibição Origem para o modo de exibição Aplicativo:

   

3. Na seção Assinatura do modo de exibição Aplicativo, selecione Provisionamento Automático e selecione sua equipe na lista suspensa Equipe. O Visual Studio para Mac tentará provisionar automaticamente seu projeto e indicará se o processo foi concluído com êxito:

   

   Se o provisionamento automático falhar, a janela Assinatura automática exibirá o motivo do erro.

4. Feche o arquivo Info.plist .

Implantar no dispositivo

Depois de configurar o provisionamento em seu projeto de aplicativo .NET MAUI, o aplicativo pode ser implantado em um dispositivo.

Visual Studio

1. No Visual Studio, verifique se o IDE está emparelhado a um host Mac Build. Para obter mais informações, consulte Emparelhar com Mac para desenvolvimento iOS.

2. Certifique-se de que o dispositivo iOS está ligado ao anfitrião de construção do Mac através de USB ou Wi-Fi. Para obter mais informações sobre a implantação sem fio, consulte Implantação sem fio para aplicativos iOS do .NET MAUI.

3. Na barra de ferramentas do Visual Studio, use o menu suspenso Destino de depuração para selecionar Dispositivos remotos do iOS e, em seguida, o dispositivo conectado ao host de compilação do Mac:

   

4. Na barra de ferramentas do Visual Studio, pressione o botão verde Iniciar para iniciar o aplicativo em seu dispositivo remoto:

   

Observação

Uma abordagem alternativa para implantar um aplicativo iOS .NET MAUI em um dispositivo é usar a reinicialização a quente. A reinicialização a quente permite implantar um aplicativo .NET MAUI em um dispositivo iOS local de 64 bits, a partir do Visual Studio, sem a necessidade de um host de compilação do Mac. Para obter mais informações, consulte Implantar um aplicativo iOS usando a reinicialização ativa.

Visual Studio para Mac

Observação

O Visual Studio para Mac está programado para ser desativado até 31 de agosto de 2024, de acordo com a Política de Ciclo de Vida Moderno da Microsoft. O Visual Studio para Mac 17.6 continuará a ter suporte até 31 de agosto de 2024, com atualizações de manutenção para problemas de segurança e plataformas atualizadas da Apple. Para obter mais informações, incluindo opções alternativas para desenvolver em um Mac, consulte O que está acontecendo com o Visual Studio para Mac?.

1. Na janela Solução, clique duas vezes no arquivo Info.plist na pasta Plataformas > iOS do seu projeto de aplicativo .NET MAUI para abri-lo no editor.

2. No editor Info.plist, altere do modo de exibição Origem para o modo de exibição Aplicativo:

   

3. Na seção Informações de Implantação do modo de exibição Aplicativo, defina o destino de implantação como a versão iOS mínima com suporte para seu aplicativo, usando o menu suspenso Destino de implantação:

   

   Importante

   O valor de destino de implantação deve ser idêntico ao valor mínimo da versão do iOS definido na caixa de diálogo Propriedades do projeto na guia Criar > plataformas de destino.

4. Certifique-se de que o dispositivo iOS está ligado ao Mac através de USB ou Wi-Fi. Para obter mais informações sobre a implantação sem fio, consulte Implantação sem fio para aplicativos iOS do .NET MAUI.

5. Na barra de ferramentas do Visual Studio para Mac, verifique se o destino de depuração está definido para o dispositivo iOS conectado e pressione o botão Reproduzir para iniciar o aplicativo no dispositivo.

Executar provisionamento automático

Quando o provisionamento automático estiver habilitado, o Visual Studio executará novamente o processo de provisionamento automático, se necessário, quando qualquer uma das seguintes situações ocorrer:

• Um dispositivo iOS está conectado ao Mac. Isso verifica automaticamente se o dispositivo está registrado em sua conta de desenvolvedor Apple. Se não estiver, ele irá adicioná-lo e gerar um novo perfil de provisionamento que o contenha.
• A ID do pacote do seu aplicativo é alterada. Isso atualiza a ID do Aplicativo e, portanto, um novo perfil de provisionamento contendo essa ID do Aplicativo é criado.
• Um recurso com suporte está habilitado no arquivo Entitlements.plist . Esse recurso será adicionado à ID do Aplicativo e um novo perfil de provisionamento com a ID do Aplicativo atualizada será gerado. Nem todas as funcionalidades são compatíveis no momento. Para obter mais informações sobre recursos, consulte Recursos.

IDs de Aplicativo Curinga

Por padrão, o provisionamento automático tentará criar e usar uma ID de Aplicativo curinga e um perfil de provisionamento em vez de uma ID de Aplicativo explícita com base no identificador de pacote do aplicativo. Os IDs de aplicativos curinga reduzem o número de perfis e IDs a serem mantidos em sua conta de desenvolvedor da Apple. Para obter mais informações sobre IDs de aplicativo curinga, consulte Criar um perfil de provisionamento de desenvolvimento.

Em alguns casos, os direitos do aplicativo exigem uma ID do Aplicativo explícita. Os seguintes direitos não dão suporte a IDs de Aplicativo curinga:

• Grupos de Aplicativos
• Domínios associados
• Apple Pay
• Game Center
• HealthKit
• HomeKit
• Ponto de acesso
• Compra no aplicativo
• Múltiplos caminhos
• NFC
• VPN pessoal
• Notificações por Push
• Configuração de Acessório sem Fio

Se seu aplicativo usar um desses direitos, o Visual Studio tentará criar uma ID de Aplicativo explícita.

Solucionar problemas

Pode levar várias horas para que uma nova conta de desenvolvedor da Apple seja aprovada. Você não poderá habilitar o provisionamento automático até que a conta seja aprovada.

Se o processo de provisionamento automático falhar com a mensagem Authentication Service Is Unavailablede erro, entre no App Store Connect ou na sua conta de desenvolvedor da Apple para verificar se você aceitou os contratos de serviço mais recentes.

O certificado não pode ser encontrado no conjunto de chaves local

Se você usar várias máquinas para desenvolvimento, você receberá a seguinte mensagem de erro ao tentar configurar o provisionamento automático em uma máquina: "Houve um erro ao tentar provisionar automaticamente o projeto: 'Certificado: Desenvolvimento Apple: Criar via API (ID da chave)' já existe, mas não pode ser encontrado no Conjunto de chaves local. Ele pode ter sido criado em outra máquina de desenvolvimento. Importe o certificado e a chave privada dessa máquina ou revogue-a e tente criar automaticamente uma nova.'":

Isso pode ocorrer porque o provisionamento automático não elimina a necessidade de copiar certificados manualmente entre máquinas, quando você estiver usando várias máquinas para desenvolvimento. Isso ocorre porque a chave privada que cria um certificado só existe na máquina que criou o certificado.

Para descobrir se um certificado necessário está faltando em sua máquina de desenvolvimento, no Visual Studio, vá para Opções de ferramentas > Xamarin > Apple Accounts>. Em seguida, na caixa de diálogo Contas de desenvolvedor da Apple, selecione uma equipe e clique no botão Exibir detalhes...

Se o certificado necessário não estiver instalado na máquina, a janela Detalhes mostrará um status "Não nas chaves" para o certificado. Nesse cenário, o certificado específico deve ser exportado do computador que o criou, no formato .p12 e, em seguida, importado para o Visual Studio com o botão Importar certificado .

Observação

• Para copiar um certificado de um Mac para outro Mac, exporte-o do Acesso às Chaves no Mac que criou o certificado e, em seguida, importe-o para o Acesso às Chaves no outro Mac.
• Para copiar um certificado de um Mac para um computador Windows, exporte o certificado do Acesso às Chaves no Mac e, em seguida, na máquina Windows, importe-o para o Visual Studio com o botão Importar Certificado .
• Não é possível copiar um certificado que foi criado pelo Visual Studio em uma máquina Windows, para outra máquina, porque ele é protegido por senha.

Depois que o certificado tiver sido importado, o Visual Studio mostrará seu status como "Válido":

Em seguida, deve ser possível para o Visual Studio provisionar automaticamente seu projeto.