Guide du dépôt du SDK Android
À propos du SDK Android de Braze
Le SDK Android de Braze vous aide à intégrer dans votre application les fonctionnalités d’envoi de messages, d’analyse et d’engagement des utilisateurs de Braze.
Pour commencer, consultez les ressources suivantes :
Démarrage rapide
Les extraits de code suivants présentent la configuration minimale requise pour ajouter le SDK Android de Braze à votre application.
// build.gradle
// ...
repositories {
mavenCentral()
}
// ...
dependencies {
`implementation 'com.braze:android-sdk-ui:45.0.+'`
`implementation 'com.braze:android-sdk-location:45.0.+'`
}
// ...
<!-- res/values/braze.xml -->
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string translatable="false" name="com_braze_api_key">YOUR_APP_IDENTIFIER_API_KEY</string>
<string translatable="false" name="com_braze_custom_endpoint">YOUR_CUSTOM_ENDPOINT_OR_CLUSTER</string>
</resources>
Braze.getInstance(context).changeUser("Jane Doe");
Pour en savoir plus sur les options d’intégration avancées, consultez le Guide du développeur Braze.
Versions prises en charge

Le SDK Android de Braze déclare un minSdkVersion de niveau API 21+, ce qui permet au SDK de se compiler dans des applications prenant en charge le niveau API 21 au minimum. Bien que le SDK se compile pour ces versions, Braze n’assure pas de prise en charge officielle des niveaux API inférieurs à 25, et le SDK peut ne pas fonctionner comme prévu sur les appareils qui exécutent ces versions.
Si votre application prend en charge ces versions, procédez comme suit :
- Vérifiez que votre intégration SDK fonctionne comme prévu sur des appareils physiques (et pas uniquement sur des émulateurs) pour ces niveaux API.
- Si vous ne pouvez pas valider le comportement attendu, vous devez soit appeler disableSDK, soit ne pas initialiser le SDK sur ces versions. Sinon, vous risquez de provoquer des effets secondaires indésirables ou une dégradation des performances sur les appareils de vos utilisateurs.
Le tableau suivant répertorie les versions minimales prises en charge pour les outils utilisés par le SDK Android de Braze.
| Outil | Version minimale prise en charge |
|---|---|
| minSdk | 5.0+ / API 21+ (Lollipop et versions ultérieures) |
| targetSdk | 37 |
| Kotlin | org.jetbrains.kotlin:kotlin-stdlib:2.2.20 |
| Firebase Cloud Messaging | 25.1.1 |
| Font Awesome | 4.3.0 |
Modules
Le tableau suivant décrit chaque module du SDK Android de Braze.
| Module | Description |
|---|---|
android-sdk-base |
La bibliothèque d’analyse de base du SDK Braze. |
android-sdk-ui |
La bibliothèque d’interface utilisateur du SDK Braze pour les messages in-app, les notifications push, les Content Cards et les bannières. |
android-sdk-location |
La bibliothèque de localisation du SDK Braze pour la localisation et le géorepérage. |
android-sdk-jetpack-compose |
La bibliothèque du SDK Braze pour la prise en charge de Jetpack Compose. |
droidboy |
Un exemple d’application qui montre en détail comment utiliser Braze. |
android-sdk-unity |
Une bibliothèque qui permet les intégrations SDK Braze sur Unity. |
samples |
Un dossier qui contient des exemples d’applications pour diverses options d’intégration. |
Contact
Pour toute question, contactez le support technique de Braze.
Pour en savoir plus sur le dépôt et les exemples de projets, consultez https://github.com/braze-inc/braze-android-sdk.