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

Résolution

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

Prérequis : Vous devez disposer d’un projet Firebase et d’une application Android valide enregistrée auprès de Firebase. Pour obtenir des instructions, consultez la page Étape 1 : Créer un projet Firebase et enregistrer votre application sur le site Web de Firebase. Vous devez également disposer d’informations d’identification valides provenant de Firebase Cloud Messaging (FCM), y compris d’une information d’identification de jeton du projet FCM.

Récupérer les informations d'identification de jeton de votre projet FCM

Procédez comme suit :

1. Ouvrez la console Firebase, puis choisissez votre projet.
2. Dans le volet de navigation, choisissez l'icône d’engrenage, puis sélectionnez Paramètres du projet.
3. Sélectionnez l’onglet Comptes de service.
4. Sélectionnez Générer une nouvelle clé privée pour télécharger le fichier de clé privée au format JSON afin de créer une application de plate-forme Android dotée d'une authentification basée sur des jetons.

Créer l'application de plate-forme Android

Lorsque vous créez une nouvelle application de plate-forme, choisissez l'authentification basée sur des jetons pour permettre à Amazon SNS d'utiliser l'API HTTP v1 Google FCM. Si votre application de plate-forme utilise l'ancienne API FCM obsolète, mettez-la à niveau pour utiliser l'authentification basée sur des jetons. Pour plus d'informations, consultez la page Migrer d’anciennes API FCM vers HTTP v1 sur le site Web de Firebase.

Vous pouvez utiliser la console Amazon SNS, l'interface de ligne de commande AWS (AWS CLI) ou l'API Amazon SNS pour créer l'application de plate-forme.

Utilisez la console Amazon SNS.

Pour utiliser la console Amazon SNS, consultez la section Création d'une application de plate-forme.

Pour Plate-forme de notifications push, sélectionnez Firebase Cloud Messaging (FCM). Pour Méthode d'authentification, sélectionnez Jeton. Puis, sélectionnez Choisir un fichier pour charger le fichier de clé privée au format JSON.

Utiliser l’interface de ligne de commande AWS

Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de ligne de commande AWS, consultez la section Résoudre les erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.

Procédez comme suit :

1. Votre fichier doit être au format chaîne et vous ne pouvez pas utiliser de caractères spéciaux. Pour formater le fichier, exécutez la commande suivante à partir du répertoire dans lequel se trouve votre fichier de clé privée au format JSON :

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

   Remarque : Remplacez private_key_JSON_file par le nom de votre fichier de clé privée.

2. Exécutez la commande create-platform-application à partir du répertoire dans lequel se trouve votre fichier clé :

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

   Remarque : Remplacez Your_Application_Name par le nom de votre propre application.
   L'ARN de votre application de plate-forme apparaît dans la sortie de la commande.
   Exemple :

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

3. À titre de bonne pratique, configurez les notifications d’événement et la journalisation du statut de livraison.

Utiliser une API Amazon SNS

Utilisez l'opération d'API CreatePlatformApplication.

Envoyer des notifications push

Pour utiliser l'application de plate-forme Android afin d'envoyer des notifications push, consultez la section Notifications push mobiles.

Informations connexes

Comment puis-je créer une application de plateforme APNs pour l’envoi de notifications push dans Amazon SNS à l’aide de l’AWS CLI ?

Ajout de jetons d’appareil ou d’ID de d’enregistrement

Publication sur un appareil mobile

Publication dans une rubrique

Codes de réponse de la plateforme