Guia do repositório do Android SDK
Sobre o SDK da Braze para Android
O SDK da Braze para Android ajuda você a integrar ao seu aplicativo os recursos de envio de mensagens, análise de dados e engajamento de usuários da Braze.
Para começar, consulte os seguintes recursos:
Início rápido
Os snippets a seguir mostram a configuração mínima necessária para adicionar o SDK Android da Braze ao seu app.
// 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 saber mais sobre opções avançadas de integração, consulte o Guia do desenvolvedor da Braze.
Suporte a versões

O SDK da Braze para Android declara um minSdkVersion de API 21+, o que permite compilar o SDK em apps compatíveis a partir da API 21. Embora o SDK seja compilado para essas versões, a Braze não oferece suporte formal para versões de API abaixo da 25. Por isso, o SDK pode não funcionar como esperado em dispositivos que executam essas versões.
Se o seu app for compatível com essas versões, faça o seguinte:
- Confirme que a integração do SDK funciona como esperado em dispositivos físicos (não apenas em emuladores) para essas versões de API.
- Se não for possível confirmar o comportamento esperado, você deve chamar disableSDK ou deixar de inicializar o SDK nessas versões. Caso contrário, você pode causar efeitos colaterais indesejados ou queda de performance nos dispositivos dos seus usuários.
A tabela a seguir lista as versões mínimas compatíveis das ferramentas usadas pelo SDK da Braze para Android.
| Ferramenta | Versão mínima compatível |
|---|---|
| minSdk | 5.0+ / API 21+ (Lollipop e 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
A tabela a seguir descreve cada módulo do SDK da Braze para Android.
| Módulo | Descrição |
|---|---|
android-sdk-base |
A biblioteca base de análise de dados do SDK da Braze. |
android-sdk-ui |
A biblioteca de interface do usuário do SDK da Braze para mensagens no app, push, Content Cards e banners. |
android-sdk-location |
A biblioteca de local do SDK da Braze para local e geofences. |
android-sdk-jetpack-compose |
A biblioteca do SDK da Braze para suporte ao Jetpack Compose. |
droidboy |
Um app de exemplo que demonstra em detalhes como usar a Braze. |
android-sdk-unity |
Uma biblioteca que permite integrações do SDK da Braze no Unity. |
samples |
Uma pasta que contém apps de exemplo para várias opções de integração. |
Contato
Em caso de dúvidas, entre em contato com o suporte técnico da Braze.
Para obter detalhes sobre o repositório e projetos de exemplo, consulte https://github.com/braze-inc/braze-android-sdk.