Guía del repositorio del Android SDK
Acerca del SDK de Android de Braze
El SDK de Android de Braze te ayuda a integrar las funcionalidades 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:43.2.+'`
`implementation 'com.braze:android-sdk-location:43.2.+'`
}
// ...
<!-- 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 más información sobre 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 que el SDK se compile en aplicaciones compatibles desde la API 21. Aunque el SDK se compila para esas versiones, Braze no ofrece soporte formal para versiones de API inferiores a 25, y es posible que el SDK no funcione como se espera en dispositivos que ejecuten 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 emuladores) para esas versiones de API.
- Si no puedes validar el comportamiento esperado, debes llamar a disableSDK o bien omitir la inicialización del 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 para 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 del SDK de 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 demuestra 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 del repositorio y proyectos de ejemplo, consulta https://github.com/braze-inc/braze-android-sdk.