Partilhar via

Recursos do Mac Catalyst

  • Artigo

No Mac Catalyst .NET Multi-platform App UI (.NET MAUI), os aplicativos são executados em uma área restrita que fornece um conjunto de regras que limitam o acesso entre o aplicativo e os recursos do sistema ou dados do usuário. A Apple fornece recursos, também conhecidos como serviços de aplicativos, como um meio de estender a funcionalidade e ampliar o escopo do que os aplicativos Mac Catalyst podem fazer. Para obter mais informações sobre recursos, consulte Recursos em developer.apple.com.

Os recursos são adicionados ao perfil de provisionamento do aplicativo e usados ao assinar o código do aplicativo. O perfil de provisionamento deve conter uma ID do aplicativo, que corresponda ao identificador de pacote do seu aplicativo, com os recursos necessários habilitados. O perfil de provisionamento deve ser criado na sua conta de desenvolvedor Apple.

As capacidades estão intimamente relacionadas com o conceito de direitos. Ambos solicitam a expansão da área restrita em que seu aplicativo é executado, para oferecer recursos adicionais. Normalmente, os direitos são adicionados ao desenvolver seu aplicativo, enquanto os recursos geralmente são adicionados ao assinar o código do aplicativo para distribuição. Para obter mais informações sobre direitos, consulte Direitos.

Adicionar funcionalidades à sua conta de programador Apple

Os recursos podem ser adicionados ao perfil de provisionamento do seu aplicativo na sua Conta de desenvolvedor Apple. Esse é um processo de várias etapas que requer a criação de um certificado de assinatura, ID do aplicativo e perfil de provisionamento.

Ao adicionar um novo recurso ao seu perfil de provisionamento, você também deve adicionar o mesmo recurso ao arquivo Entitlements.plist do seu aplicativo e garantir que o aplicativo consuma esse arquivo. Para obter mais informações, consulte Direitos. Também pode ser necessário definir chaves de privacidade no Info.plist, para determinados recursos.

Criar um certificado de assinatura

A criação de um perfil de provisionamento requer que você tenha criado anteriormente um certificado de assinatura. O tipo de certificado de assinatura depende do canal de distribuição pretendido para seu aplicativo:

Criar uma ID de Aplicativo com um serviço de aplicativo

Uma ID de Aplicativo é semelhante a uma cadeia de caracteres DNS reverso, que identifica exclusivamente um aplicativo e é necessária para identificar o aplicativo que você está distribuindo. A ID do aplicativo deve ser idêntica ao identificador de pacote do seu aplicativo.

Importante

O identificador de pacote para um aplicativo .NET MAUI é armazenado no arquivo de projeto como a propriedade 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 MAUI Shared > General . O campo ID do aplicativo lista o identificador do pacote.
  • No Visual Studio para Mac, na janela Solução, clique com o botão direito do mouse em seu projeto de aplicativo .NET MAUI e selecione Propriedades. Em seguida, na janela Propriedades do projeto, selecione a guia Criar > informações do aplicativo. O campo ID do aplicativo lista o identificador do pacote.

Quando o valor do campo ID do aplicativo for atualizado, o valor do identificador de pacote no Info.plist será atualizado automaticamente.

Há dois tipos de ID do aplicativo - explícito e curinga. Uma ID de Aplicativo explícita é exclusiva de um único aplicativo e normalmente assume a forma com.domainname.myid. Uma ID de aplicativo explícita permite a instalação de um aplicativo, com um identificador de pacote correspondente, em um dispositivo. IDs de aplicativo explícitos são necessários para aplicativos que habilitam recursos específicos do aplicativo.

Uma ID de aplicativo explícita pode ser criada com as seguintes etapas:

  1. Em um navegador da Web, vá para a seção Identificadores da sua conta de desenvolvedor Apple e clique no + botão.

  2. Na página Registrar um novo identificador, selecione IDs de aplicativo e clique no botão Continuar.

  3. Na página Registrar um novo identificador, selecione o Tipo de aplicativo e clique no botão Continuar.

  4. Na página Registrar uma ID de Aplicativo, forneça uma Descrição e defina a ID do Pacote como Explícita. Em seguida, insira uma ID do aplicativo no formato com.domainname.myid:

    Screenshot of new App ID registration page with required fields populated.

  5. Na página Registrar uma ID de Aplicativo, habilite os recursos necessários nas guias Recursos e Serviços de Aplicativo:

    Screenshot of enabled capabilities.

  6. Na página Registrar uma ID de Aplicativo , clique no botão Continuar .

  7. Na página Confirmar sua ID do Aplicativo, revise as informações e clique no botão Registrar. Desde que o seu ID de aplicativo seja registrado com êxito, você retornará à seção Identificadores da sua Conta de desenvolvedor Apple.

  8. Na página Identificadores, clique no ID do aplicativo que você acabou de criar.

  9. Na página Editar sua Configuração de ID de Aplicativo, qualquer um dos recursos habilitados que exijam configuração adicional terá um botão Configurar :

    Screenshot of editing capabilities.

    Clique em qualquer botão Configurar para configurar seus recursos habilitados. Para obter mais informações, consulte Configurar recursos do aplicativo em developer.apple.com.

Criar um perfil de provisão

Depois de criar uma ID do Aplicativo, você deve criar um perfil de provisionamento para a ID do Aplicativo. O perfil de provisionamento criado também dependerá do canal de distribuição pretendido para seu aplicativo:

Baixar perfis de provisionamento

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?.

Depois de criar um perfil de provisionamento, ele deve ser baixado pelo Visual Studio para Mac:

  1. No Visual Studio para Mac, vá para Preferências > do Visual Studio > Publicando > a conta de desenvolvedor da Apple.
  2. Na janela Contas de desenvolvedor da Apple, selecione uma equipe e clique no botão Exibir detalhes...
  3. Na janela Detalhes, verifique se o novo perfil aparece na lista Perfis de Provisionamento. Talvez seja necessário reiniciar o Visual Studio para Mac para atualizar a lista.
  4. Na caixa de diálogo Detalhes, clique no botão Baixar Todos os Perfis.

O perfil de provisionamento estará disponível para uso.

Observação

Você também pode baixar seu perfil de provisionamento no Xcode. Para obter mais informações, consulte Baixar seu perfil de provisionamento no Xcode.

Definir propriedades de compilação no arquivo de projeto

O arquivo de projeto do seu aplicativo deve ser atualizado para usar o certificado de assinatura, o perfil de provisionamento e o arquivo de direitos. Isso pode ser obtido adicionando as seguintes propriedades de compilação a um em seu arquivo de <PropertyGroup> projeto:

Propriedade Valor
<CodesignKey> O nome da chave de assinatura de código. Defina como o nome do seu certificado de distribuição, conforme exibido em Acesso às Chaves.
<CodesignEntitlements> O caminho para o arquivo de direitos que especifica os direitos exigidos pelo aplicativo. Defina como Platforms\MacCatalyst\Entitlements.plist.
<CodesignProvision> O perfil de provisionamento a ser usado ao assinar o pacote de aplicativos.
<EnableCodeSigning> Defina como para que a true assinatura de código esteja habilitada.

O exemplo a seguir mostra um grupo de propriedades típico para criar e assinar seu aplicativo Mac Catalyst para distribuição da Mac App Store:

<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Release|net8.0-maccatalyst|AnyCPU'">
  <EnableCodeSigning>True</EnableCodeSigning>
  <CodesignKey>Apple Distribution: John Smith (AY2GDE9QM7)</CodesignKey>
  <CodesignProvision>MyMauiApp</CodesignProvision>
  <CodesignEntitlements>Platforms\MacCatalyst\Entitlements.plist</CodesignEntitlements>
</PropertyGroup>

Solucionar problemas

A lista a seguir detalha os problemas comuns que podem causar problemas ao desenvolver um aplicativo .NET MAUI Mac Catalyst que usa recursos:

  • Certifique-se de que o ID da Aplicação correto foi criado e registado na secção Identificadores da sua Conta de Programador Apple.
  • Verifique se o recurso foi adicionado à ID do aplicativo e se o recurso está configurado usando os valores corretos.
  • Verifique se o perfil de provisionamento foi instalado em sua máquina de desenvolvimento e se o arquivo Info.plist do aplicativo está usando um identificador de pacote idêntico à sua ID do aplicativo.
  • Verifique se o arquivo Entitlements.plist do aplicativo tem os direitos corretos habilitados.
  • Certifique-se de que todas as chaves de privacidade necessárias estejam definidas em Info.plist.
  • Verifique se o aplicativo consome o arquivo Entitlements.plist .