Como faço para criar uma aplicação da plataforma Android no Amazon SNS para notificações push?

Breve descrição

Para criar uma aplicação de plataforma no Amazon SNS para enviar notificações push para dispositivos Android, faça o seguinte:

• Use o console do Amazon SNS para criar uma aplicação da plataforma Android.
• Execute o comando create-platform-application da AWS Command Line Interface (AWS CLI) para criar uma aplicação da plataforma Android.

Resolução

Observação: as notificações push do Amazon SNS não estão disponíveis em todas as regiões da AWS. Para obter mais informações, consulte Supported Regions for mobile applications.

Pré-requisitos

Você precisa ter um projeto do Firebase e uma aplicação Android válida registrada no Firebase. Para obter instruções, consulte Etapa 1: criar um projeto do Firebase e registrar o app na documentação do Firebase.

Você também precisa ter credenciais válidas do Firebase Cloud Messaging (FCM), incluindo uma chave de API do projeto FCM válida (chave do servidor). Para obter mais informações, consulte Firebase Cloud Messaging na documentação do Firebase.

Observação: atualmente, o Amazon SNS não oferece suporte à API FCM (v1). Para acessar a chave do servidor, use a API FCM (antiga).

Para recuperar a chave de API do seu projeto FCM (chave do servidor)

1.No console do Firebase, escolha o seu projeto.

2.No painel de navegação esquerdo, escolha o ícone de engrenagem. Em seguida, escolha Project settings.

3.Escolha a guia Cloud Messaging.

4.Em Project credentials, encontre a Server key. Esse token é a chave de API do seu projeto FCM. Copie para sua prancheta.

Usar o console do Amazon SNS para criar um aplicativo da plataforma Android

1.Abra o console do Amazon SNS.

2.No painel de navegação esquerdo, escolha Dispositivo móvel. Em seguida, escolha Notificações push.

3.Na página Notificações push móveis, ao lado de **Aplicações de plataforma **, escolha **Criar aplicação de plataforma **.

4.Na página **Criar aplicação de plataforma **, em Detalhes, faça o seguinte:
Em Nome da aplicação, insira o nome da sua aplicação.
Para plataforma de notificação push, escolha Firebase Cloud Messaging (FCM).
Em Credenciais do Firebase Cloud Messaging, em Chave de API, insira a chave de API do seu projeto FCM (chave do servidor).

5.(Prática recomendada) Configure notificações de eventos e registro do status de entrega.

6.Escolha Criar aplicação de plataforma.

Executar o comando create-platform-application AWS CLI para criar uma aplicação da plataforma Android

Observação: se você receber erros ao executar comandos da AWS CLI, certifique-se de estar usando a versão mais recente da AWS CLI.

1.Copie e cole o seguinte em um editor de texto. Em seguida, salve-o como um arquivo JSON chamado FCMAPIKey.json:

Importante: substitua Your_FCM_API_Key pela sua chave de API FCM (chave do servidor).

{
    "PlatformCredential": "Your_FCM_API_Key"
}

2.Execute o seguinte comando create-platform-application da AWS CLI:

Importante: substitua Your_Application_Name pelo nome da aplicação. Certifique-se de executar o comando no mesmo diretório em que seu arquivo FCMAPIKey.json está localizado.

aws sns create-platform-application --name Your_Application_Name --platform GCM --attributes file://FCMAPIKey.json

O nome de recurso da Amazon (ARN) sua aplicação de plataforma aparece na saída do comando.

Exemplo de saída do comando create-platform-application

{
    "PlatformApplicationArn": "arn:aws:sns:us-east-1:XXXXXXXXXXXX:app/GCM/Your_Application_Name"
}

3.(Prática recomendada) Configure notificações de eventos e registro do status de entrega.

Observação: para enviar notificações push usando a aplicação da plataforma Android, siga as instruções em Notificações push móveis.

Para obter mais informações, consulte CreatePlatformApplication na Referência de API do Amazon SNS.

Informações relacionadas

Como faço para criar uma aplicação de plataforma do APNs para enviar notificações por push no Amazon SNS usando a AWS CLI?

Adding device tokens or registration IDs

Publishing to a mobile device

Publishing to a topic

Platform response codes