Guía del repositorio del Android SDK
Acerca del SDK de Android de Braze
El SDK de Android de Braze te ayuda a integrar en tu aplicación las capacidades de mensajería, análisis y participación de usuarios de Braze.
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 Braze Android SDK a tu aplicación.
// 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");
Para obtener más información sobre las opciones avanzadas de integración, 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 compilar el SDK en aplicaciones compatibles desde la API 21. Aunque el SDK compila para esas versiones, Braze no ofrece soporte oficial para versiones de API inferiores a la 25, y es posible que el SDK no funcione como se espera en dispositivos con esas versiones.
Si tu aplicación es compatible con esas versiones, haz lo siguiente:
- Valida 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 validar el comportamiento esperado, debes llamar a disableSDK u omitir la inicialización del SDK en esas versiones. De lo contrario, podrías provocar 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 que utiliza el SDK de Android de Braze.
| Herramienta | Versión mínima compatible |
|---|---|
| minSdk | 5.0+ / API 21+ (Lollipop y posteriores) |
| targetSdk | 37 |
| Kotlin | org.jetbrains.kotlin:kotlin-stdlib:2.4.21 |
| Firebase Cloud Messaging | 25.1.1 |
| Font Awesome | 4.3.0 |
Módulos
En la siguiente tabla se describe cada módulo del SDK de Braze para Android.
| Módulo | Descripción |
|---|---|
android-sdk-base |
La biblioteca de análisis base 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 la compatibilidad con Jetpack Compose. |
droidboy |
Una aplicación de ejemplo que muestra en profundidad cómo usar Braze. |
android-sdk-unity |
Una biblioteca que habilita las 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 obtener detalles del repositorio y proyectos de ejemplo, consulta https://github.com/braze-inc/braze-android-sdk.