Configuração do macOS

Os aplicativos macOS recebem notificações push através do serviço de Notificação Push da Apple (APNs), o mesmo canal de entrega que o iOS utiliza. Configure a plataforma macOS no Pushwoosh com uma conexão baseada em certificado (.p12) ou baseada em token (.p8) para o APNs.

Nota

Certifique-se de que seu aplicativo macOS tenha a capacidade de Notificações Push ativada e um App ID registrado no Portal do Desenvolvedor da Apple antes de começar. Leia mais na documentação do desenvolvedor da Apple.

Configuração baseada em certificado

Crie o certificado .p12

As etapas de Keychain, Portal do Desenvolvedor da Apple e exportação correspondem ao fluxo de certificado do iOS. Siga esse guia e use o seu App ID do macOS quando a Apple solicitar que você escolha um:

1. Gere um arquivo de solicitação de certificado no Acesso às Chaves (Keychain Access).
2. Crie um certificado APNs no Portal do Desenvolvedor da Apple. Ao selecionar um App ID, escolha o ID para o seu aplicativo macOS, não o do iOS.
3. Exporte a chave privada como .p12 do Acesso às Chaves (Keychain Access).

Você precisará do arquivo .p12 e da senha da chave privada na próxima seção.

Configure a plataforma macOS no Pushwoosh

1. No seu projeto Pushwoosh, vá para Settings → Configure Platforms.
2. Clique em Connect ao lado de macOS na seção Desktop platforms.

3. Em Configuration mode for macOS, selecione Certificate-based manual configuration.
4. Clique em Next.

5. Em Certificate-based configuration for macOS, preencha o formulário:
   • Certificate file (.p12): carregue o arquivo .p12 que você exportou do Acesso às Chaves.
   • Private key password: insira a senha que você definiu ao exportar o arquivo .p12.
   • Gateway: selecione Sandbox para desenvolvimento ou Production para aplicativos em produção.

6. Clique em Configure para completar a configuração.

Configuração baseada em token

Você pode configurar a plataforma macOS com autenticação baseada em token para uma comunicação mais rápida com o APNs.

Nota

Para saber mais, confira os documentos do Desenvolvedor da Apple.

Obtenha uma chave de assinatura da Apple

A criação da chave APNs é a mesma que para o iOS. Siga Obtenha uma Chave de Criptografia e um ID de Chave da Apple no guia baseado em token do iOS.

Você precisará do Key ID e do arquivo .p8 na próxima seção. Você pode reutilizar a mesma chave APNs que já usa para o iOS, se tiver uma.

Configure a plataforma macOS no Pushwoosh

1. No seu projeto Pushwoosh, vá para Settings → Configure Platforms.
2. Clique em Connect ao lado de macOS na seção Desktop platforms.

3. Em Configuration mode for macOS, selecione Token-based configuration.
4. Clique em Next.

5. Em Token-based configuration for macOS, preencha o formulário:
   • Key ID: cole o Key ID de 10 caracteres da Apple.
   • Team ID: insira o ID da sua Equipe de Desenvolvedor da Apple da seção Membership da sua conta de Desenvolvedor da Apple.
   • Bundle ID: insira o Bundle ID do seu aplicativo macOS de Certificates, Identifiers & Profiles.
   • Auth Key (.p8): carregue o arquivo de chave de assinatura .p8 que você baixou da Apple.
   • Gateway: selecione Sandbox para desenvolvimento ou Production para aplicativos em produção.

6. Clique em Configure para completar a configuração.

Dica

Para verificar se a plataforma macOS foi configurada com sucesso, envie um push de teste ou direcione uma mensagem para um dispositivo específico. Para obter orientações, consulte a página Teste sua integração.