Guía del repositorio del Android SDK
Acerca de Braze Android SDK
Braze Android SDK te ayuda a integrar las funciones de mensajería, análisis y participación de usuarios de Braze en tu aplicación.
Para empezar, consulta los siguientes recursos:
Inicio rápido
Los siguientes fragmentos de código muestran la configuración mínima necesaria para añadir el SDK de Braze para Android a tu aplicación.
// build.gradle
// ...
repositories {
mavenCentral()
}
// ...
dependencies {
`implementation 'com.braze:android-sdk-ui:44.0.+'`
`implementation 'com.braze:android-sdk-location:44.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");
Para obtener más información sobre las opciones de integración avanzada, consulta la Guía para desarrolladores de Braze.
Compatibilidad de versiones

El SDK de Android de Braze declara un minSdkVersion de API 21+, lo que permite que el SDK se compile en aplicaciones compatibles desde API 21. Aunque el SDK compila para esas versiones, Braze no proporciona soporte formal para versiones de API inferiores a 25, y el SDK puede no funcionar como se espera en dispositivos que ejecuten esas versiones.
Si tu aplicación es compatible con esas versiones, haz lo siguiente:
- Verifica que tu integración del SDK funcione como se espera en dispositivos físicos (no solo en emuladores) para esas versiones de API.
- Si no puedes verificar el comportamiento esperado, debes llamar a disableSDK o no inicializar el SDK en esas versiones. De lo contrario, podrías causar efectos secundarios no deseados o un rendimiento degradado en los dispositivos de tus usuarios.
La siguiente tabla enumera las versiones mínimas compatibles de las herramientas utilizadas por el SDK de Android de Braze.
| Herramienta | Versión mínima compatible |
|---|---|
| minSdk | 5.0+ / API 21+ (Lollipop y superior) |
| targetSdk | 37 |
| Kotlin | org.jetbrains.kotlin:kotlin-stdlib:2.2.20 |
| Firebase Cloud Messaging | 25.1.1 |
| Font Awesome | 4.3.0 |
Módulos
La siguiente tabla describe cada módulo en el SDK Android de Braze.
| Módulo | Descripción |
|---|---|
android-sdk-base |
La biblioteca base de análisis del SDK de Braze. |
android-sdk-ui |
La biblioteca de interfaz de usuario del SDK de Braze para mensajes dentro de la aplicación, push, Content Cards y banners. |
android-sdk-location |
La biblioteca de ubicación del SDK de Braze para ubicación y geovallas. |
android-sdk-jetpack-compose |
La biblioteca del SDK de Braze para compatibilidad con Jetpack Compose. |
droidboy |
Una aplicación de ejemplo que muestra cómo usar Braze en profundidad. |
android-sdk-unity |
Una biblioteca que habilita integraciones del SDK de Braze en Unity. |
samples |
Una carpeta que contiene aplicaciones de ejemplo para varias opciones de integración. |
Contacto
Si tienes preguntas, contacta con el soporte técnico de Braze.
Para más detalles sobre el repositorio y proyectos de ejemplo, consulta https://github.com/braze-inc/braze-android-sdk.