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

Lecture de 4 minute(s)

Je souhaite créer une application de plateforme dans Amazon Simple Notification Service (Amazon SNS) afin d’envoyer des notifications push à des appareils Android.

Brève description

Si vous souhaitez créer une application de plateforme dans Amazon SNS afin d’envoyer des notifications push aux appareils Android, effectuez l’une des opérations suivantes :

Créez une application de plateforme Android à l’aide de la console Amazon SNS.
Exécutez la commande create-platform-application de l’interface de la ligne de commande AWS (AWS CLI) pour créer une application de plateforme Android.

Résolution

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

Conditions préalables

Vous devez disposer d’un projet Firebase et d’une application Android valide enregistrée auprès de Firebase. Pour obtenir des instructions, consultez Étape 1 : créez un projet Firebase et enregistrez votre application dans la documentation Firebase.

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

Remarque : actuellement, Amazon SNS ne prend pas en charge l’API FCM (v1). Pour accéder à la clé du serveur, utilisez l’API FCM (ancienne version).

Récupération de la clé API de votre projet FCM (clé de serveur)

1. Dans la console Firebase, choisissez votre projet.

2. Dans le volet de navigation de gauche, sélectionnez l’icône représentant un engrenage. Choisissez ensuite Paramètres du projet.

3. Choisissez l’onglet Cloud Messaging.

4. Sous Project credentials, recherchez Server key. Ce jeton est la clé API de votre projet FCM. Copiez-le dans votre presse-papiers.

Création d’une application de plateforme Android à l’aide de la console Amazon SNS

1. Ouvrez la console Amazon SNS.

2. Dans le volet de navigation gauche, choisissez Mobile. Ensuite, choisissez Notifications push.

3. Sur la page Notifications push mobiles, à côté de Applications de plateforme, choisissez Créer une application de plate-forme.

4. Sur la page Créer une application de plateforme, sous Informations, effectuez ces étapes :
Dans Nom de l’application, entrez le nom de votre application.
Pour Plateforme de notification push, choisissez Firebase Cloud Messaging (FCM).
Dans Informations d’identification Firebase Cloud Messaging, pour la clé API, entrez la clé API de votre projet FCM (clé de serveur).

5. (Bonne pratique) Configurez les Notifications d’événements et la Journalisation du statut de diffusion.

6. Choisissez Créer une application de plateforme.

Exécutez la commande de l’AWS CLI create-platform-application pour créer une application de plateforme Android

Remarque : si des erreurs surviennent lors de l'exécution des commandes de l'AWS CLI, assurez-vous que vous utilisez la version la plus récente de l'AWS CLI.

1. Copiez et collez ce qui suit dans un éditeur de texte. Ensuite, enregistrez-le dans un 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. Veillez à exécuter la commande dans le répertoire où se trouve votre fichier FCMAPIKey.json.

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

Le nom Amazon resource name (ARN) de votre application de plateforme apparaît dans la sortie de commande.

Exemple de sortie de 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énements et la Journalisation du statut de diffusion.

Remarque : pour envoyer des notifications push à l’aide d’une application de plateforme Android, suivez les instructions indiquées dans Notifications push mobiles.

Pour en savoir plus, consultez CreatePlatformApplication dans la documentation de référence de l’API Amazon SNS.