Passer au contenu principal
Le SDK mobile OneSignal active les notifications push, les messages in-app et les Live Activities dans vos applications iOS, Android, Huawei et Amazon. La configuration comprend deux étapes :
  1. Configurer les identifiants de plateforme — connectez vos identifiants FCM, APNs, HMS ou ADM à OneSignal
  2. Intégrer le SDK — installez le SDK OneSignal pour votre plateforme et initialisez-le dans votre application
Pour les sites web, consultez Configuration du Web SDK.

​
Configurer les identifiants de plateforme

Chaque plateforme nécessite ses propres identifiants push. Configurez les identifiants pour chaque plateforme prise en charge par votre application avant d’intégrer le SDK.

​
Configurer votre application OneSignal et votre plateforme

Configurez votre application OneSignal avec les plateformes que vous prenez en charge — Apple (APNs), Google (FCM), Huawei (HMS) et/ou Amazon (ADM).
Si votre organisation possède déjà un compte OneSignal, demandez à être invité à l’Organisation. Sinon, inscrivez-vous pour un compte gratuit pour commencer.
1

Créer ou sélectionner votre application

Créez une nouvelle application en cliquant sur New App/Website, ou ajoutez une plateforme à une application existante dans Settings > Push & In-App. Sélectionnez la ou les plateformes que vous souhaitez configurer et cliquez sur Next: Configure Your Platform.
Tableau de bord OneSignal montrant le flux de configuration de nouvelle application avec le nom de l'organisation, le nom de l'app et la sélection du canal
2

Configurer les identifiants de plateforme

Entrez les identifiants pour votre plateforme :Cliquez sur Save & Continue après avoir saisi vos identifiants.
3

Enregistrer votre App ID et installer le SDK

Votre App ID est affiché sur l’écran final. Copiez et enregistrez-le — vous en avez besoin lors de l’initialisation du SDK. Sélectionnez votre plateforme SDK, puis suivez le guide de configuration.
Tableau de bord OneSignal montrant l'App ID et l'option d'invitation d'équipe après la configuration

​
Intégrer le SDK

Android natif

Intégrez le SDK OneSignal dans les applications Android natives via FCM.

iOS natif

Intégrez le SDK OneSignal dans les applications iOS natives via APNs.

React Native et Expo

Configuration pour les environnements React Native et Expo.

Flutter

Configuration du SDK pour les applications Flutter utilisant Dart.

Unity

Configuration du SDK multiplateforme pour les applications mobiles basées sur Unity.

.NET MAUI

Intégrez le SDK OneSignal avec les applications .NET MAUI.

Huawei Android natif

Configuration du SDK pour les appareils Huawei utilisant les services push HMS.

Cordova, Ionic et Capacitor

Configuration pour les applications mobiles hybrides Cordova, Ionic et Capacitor.

​
Autres intégrations

FlutterFlow

Configuration SDK low-code pour les applications FlutterFlow.

Median.co

Guide d’intégration pour les applications Median.co (anciennement GoNative.io).

​
Versions du SDK

​
FAQ

​
Les SDK sont-ils requis ?

Non, mais ils sont fortement recommandés et open source sur GitHub. Vous pouvez intégrer OneSignal en utilisant uniquement la REST API, mais les SDK simplifient considérablement le processus, notamment pour la gestion des notifications push sur plusieurs plateformes.

​
Que puis-je faire sans le SDK ?

Vous pouvez utiliser les API suivantes directement :
Les messages in-app et les Live Activities nécessitent le SDK — ils ne peuvent pas être envoyés via l’API seule.

​
Pourquoi recommandez-vous d’utiliser les SDK ?

Les notifications push ont des exigences spécifiques à la plateforme que les SDK gèrent pour vous, notamment :
  • Obtention des tokens push sur Android, iOS, Huawei et web
  • Gestion du statut d’abonnement et des invites d’opt-in utilisateur
  • Affichage et traitement des notifications push sur le client
Les APNs d’Apple et le FCM de Google utilisent des formats de charge utile différents. Le SDK OneSignal analyse les charges utiles personnalisées pour afficher et suivre les messages avec précision. Gérer cela manuellement ajoute une complexité significative. En savoir plus : Build vs. Buy: What Goes Into Building a Push Notification Platform

​
Ai-je besoin d’applications OneSignal séparées pour iOS et Android ?

Non. Une seule application OneSignal prend en charge plusieurs plateformes — iOS, Android, Huawei, Amazon et web. Configurez les identifiants de chaque plateforme dans Settings > Push & In-App et ils partagent tous la même application, les mêmes utilisateurs et les mêmes segments.

​
Les appareils en Chine ou sur Huawei peuvent-ils recevoir des notifications push ?

Si l’appareil dispose de Google Play Services, il reçoit les notifications push via FCM. Si l’application a été téléchargée depuis le Huawei AppGallery (y compris les appareils Huawei non-HarmonyOS exécutant Android), elle reçoit les notifications via HMS — configurez le SDK Huawei pour l’activer. OneSignal utilise FCM par défaut pour les appareils qui prennent en charge à la fois HMS et FCM. Vous pouvez préférer HMS à FCM si nécessaire.