Comment puis-je créer une application de plateforme Android dans Amazon SNS pour les notifications push ?

Lecture de 4 minute(s)

Je veux créer une application de plateforme dans Amazon Simple Notification Service (Amazon SNS) pour envoyer des notifications push à des appareils Android. Comment puis-je fair la configuration ?

Brève description

Pour créer une application de plateforme dans Amazon SNS afin d'envoyer des notifications push aux appareils Android, vous pouvez procéder de l'une des manières suivantes :

Utilisez la console Amazon SNS pour créer une application de plateforme Android.
Exécutez la commande AWS Command Line Interface (AWS CLI) create-platform-application pour créer une application de plateforme Android.

Solution

Remarque : les notifications push Amazon SNS ne sont pas disponibles dans toutes les régions AWS. Pour plus d'informations, consultez Régions prises en charge pour les applications mobiles.

Prérequis

Vous devez avoir un projet Firebase et une application Android valide enregistrée avec Firebase. Pour obtenir des instructions, consultez Étape 1 : créer un projet Firebase et enregistrer votre application dans la documentation Firebase.

Vous devez également disposer d'informations d'identification valides de Firebase Cloud Messaging (FCM), y compris une clé API de projet FCM valide (clé de serveur). Pour plus d'informations, consultez Firebase Cloud Messaging dans la documentation Firebase.

Pour récupérer la clé API de votre projet FCM (clé serveur)

1. Dans la console Firebase, sélectionnez le projet.

2. Dans le panneau de navigation de gauche, choisissez l'icône d'engrenage. Choissisez ensuite Project settings (Paramètres du projet).

3. Choisissez l'onglet Cloud Messaging.

4. Sous Project credentials (Informations d'identification du projet), recherchez la clé de serveur. Ce jeton est la clé API de votre projet FCM. Copiez-le dans votre presse-papiers.

Pour utiliser la console Amazon SNS afin de créer une application de plateforme Android

1. Ouvrez la console Amazon SNS.

2. Dans le panneau de navigation de gauche, sélectionnez Metrics (Métriques). Ensuite, choisissez Push notifications (Notifications Push).

3. Sur la page Mobile push notifications (Notifications push mobiles), en regard de Platform applications(Applications de plateforme), choisissez Create platform application Créer une application de plateforme (Créer une application de plateforme).

4. Sur la page Create platform application (Créer une application de plateforme), sous Details (Informations), procédez comme suit :
Pour Application name (Nom de l'application), saisissez le nom de l'application.
Pour Push notification platform (Plateforme de notification push), choisissez Firebase Cloud Messaging (FCM).
Sous Firebase Cloud Messaging Credentials (Informations d'identification Firebase Cloud Messaging), pour API key (clé API), saisissez la clé API de votre projet FCM (clé du serveur).

5. (Bonne pratique) Configurez les notifications d'événement et la journalisation de l'état de distribution.

6. Choisissez Create platform application (Créer une application de plateforme).

Pour exécuter la commande AWS CLI create-platform-application afin de créer une application de plateforme Android

Remarque : si vous recevez des erreurs lors de l'exécution de commandes AWS CLI, vérifiez que vous utilisez la version la plus récente d'AWS CLI.

1. Copiez et collez ce qui suit dans un éditeur de texte et enregistrez-le en tant que fichier JSON nommé FCMAPIKey.json :

Important : remplacez Your_FCM_API_Key par votre clé API FCM (clé de serveur).

{
 "PlatformCredential": "Your_FCM_API_Key"
}

2. Exécutez la commande AWS CLI create-platform-application suivante :

Important : remplacez Your_Application_Name par le nom de votre application. Assurez-vous d'exécuter la commande dans le même répertoire où se trouve votre fichier FCMAPIKey.json.

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

L'Amazon Resource Name (ARN) de votre application de plateforme apparaît dans la sortie de la commande.

Exemple de sortie de la commande create-platform-application

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

3. (Bonne pratique) Configurez les notifications d'événement et la journalisation de l'état de distribution.

Remarque : pour envoyer des notifications push à l'aide de l'application de plateforme Android, suivez les instructions de Mobile push notifications (Notifications push mobiles).

Pour plus d'informations, consultez CreatePlatformApplication dans la référence d'API Amazon SNS.