Come faccio a creare un'applicazione per la piattaforma Android in Amazon SNS per le notifiche push?

Risoluzione

Le notifiche push di Amazon SNS non sono disponibili in tutte le regioni AWS. Per ulteriori informazioni, consulta Supported Regions for mobile applications (Regioni supportate per applicazioni per dispositivi mobili).

Prerequisiti: devi disporre di un progetto Firebase e di un'app Android valida registrata con Firebase. Per istruzioni, consulta Passaggio 1: crea un progetto Firebase e registra la tua app sul sito web di Firebase. Devi inoltre disporre di credenziali valide da Firebase Cloud Messaging (FCM), inclusa una credenziale token del progetto FCM.

Recupero delle credenziali token del progetto FCM

Completa i seguenti passaggi:

1. Apri la console Firebase, quindi scegli il progetto.
2. Nel pannello di navigazione, seleziona l'icona a forma di ingranaggio, quindi scegli Impostazioni del progetto.
3. Scegli la scheda Account del servizio.
4. Scegli Genera nuova chiave privata per scaricare il file della chiave privata in formato JSON per creare un'applicazione della piattaforma Android con autenticazione basata su token.

Creazione dell'applicazione della piattaforma Android

Quando crei una nuova applicazione di piattaforma, scegli l'autenticazione basata su token per consentire ad Amazon SNS di utilizzare l'API FCM HTTP v1 di Google. Se disponi di un'applicazione di piattaforma che utilizza l'API FCM legacy obsoleta, aggiorna l'applicazione per utilizzare l'autenticazione basata su token. Per ulteriori informazioni, consulta Migrate from legacy FCM APIs to HTTP v1 (Migrazione dalle API FCM legacy a HTTP v1) sul sito web di Firebase.

Puoi utilizzare la console Amazon SNS, l'interfaccia della linea di comando AWS (AWS CLI) o l'API Amazon SNS per creare l'applicazione di piattaforma.

Utilizzo della console Amazon SNS

Per utilizzare la console Amazon SNS, consulta Creating a platform application (Creazione di un'applicazione di piattaforma).

Per Piattaforma di notifiche push, seleziona Firebase Cloud Messaging (FCM). Per Metodo di autenticazione, scegli Token. Quindi, seleziona Scegli file per caricare il file della chiave privata in formato JSON.

Utilizzo dell'interfaccia della linea di comando AWS

Nota: se ricevi messaggi di errore quando esegui i comandi dell'interfaccia della linea di comando AWS, consulta Troubleshooting errors for the AWS CLI (Risoluzione degli errori per l'interfaccia della linea di comando AWS. Inoltre, assicurati di utilizzare la versione più recente dell'interfaccia della linea di comando AWS.

Completa i seguenti passaggi:

1. Il file deve essere in formato stringa e non si possono usare caratteri speciali. Per formattare il file, esegui il comando seguente dalla stessa directory in cui si trova il file della chiave privata in formato JSON:

   SERVICE_JSON=`jq @json <<< cat "private_key_JSON_file"`

   Nota: sostituisci private\ _key\ _JSON\ _file con il nome del file della chiave privata.

2. Esegui il comando create-platform-application dalla stessa directory in cui si trova il file della chiave:

   aws sns create-platform-application --name Your_Application_Name --platform GCM --attributes PlatformCredential=$SERVICE_JSON

   Nota: sostituisci Your_Application_Name con il nome della tua applicazione.
   L'ARN dell'applicazione della piattaforma viene visualizzato nell'output del comando.
   Esempio:

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

3. Come best practice, si consiglia di configurare le notifiche eventi e la registrazione dello stato della consegna.

Utilizzo di un'API Amazon SNS

Utilizza l'operazione API CreatePlatformApplication.

Invio di notifiche push

Per utilizzare l'applicazione della piattaforma Android per inviare notifiche push, consulta Mobile push notifications (Notifiche push per dispositivi mobili.

Informazioni correlate

Come posso creare un'applicazione della piattaforma APNs per l'invio di notifiche push in Amazon SNS utilizzando l'AWS CLI?

Adding device tokens or registration IDs

Publishing to a mobile device

Publishing to a topic

Platform response codes