Android SDK集成
引用的這篇文章介紹了如何將Android SDK集成到你的Android或FireOS應用程序。安裝釺SDK將提供基本的分析功能和工作您可以吸引用戶的應用信息。
為獲得最佳性能在Android上12,我們建議升級到釺Android SDK v13.1.2 +盡快。有關更多信息,請參見我們的Android 12升級指南。
步驟1:釺庫集成
釺Android SDK可以沒有UI組件被集成。然而,卡片內容和應用消息將無法正常工作,除非你通過自定義數據的UI僅僅你的設計。此外,推送通知將不會工作,因為我們將處理UI庫的代碼。重要的是要注意,這些UI元素是開源和完全可定製的。我們強烈建議這些功能的集成。指的是內容的卡片和應用消息文檔的列表使用每個渠道或工具的好處。
基本的集成
訪問釺的消息傳遞功能,您必須將UI庫集成。看到下麵的Android工作室方向UI庫根據您的IDE集成:
添加釺依賴
添加android-sdk-ui
依賴你的應用的build.gradle
。
如果您正在使用任何位置或釺Geofence功能,還包括android-sdk-location
在你的應用程序的build.gradle
。
如果您正在使用一個非Android SDK(例如,顫振、科爾多瓦、團結,等等),SDK已經有了android-sdk-ui
依賴正確版本的Android SDK。不要手動更新版本。
1 2 3 4
依賴關係{實現“com.braze: android-sdk-ui: +”實現“com.braze: android-sdk-location: +”}
下麵的示例顯示依賴在你的位置build.gradle
。注意,在這個例子中使用的版本使用一個舊版本。訪問釺Android SDK版本最新的版本的Android SDK釺。
執行Gradle同步
一定要執行Gradle構建您的項目和將同步依賴性增加。
步驟2:配置在braze.xml釺SDK
截至2019年12月,自定義端點不再給出,如果你有一個預先存在的自定義端點,您可以繼續使用它。有關更多細節,請參考我們的可用端點列表。
現在庫集成,您必須創建一個braze.xml
文件在您的項目res /值
文件夾中。如果你是在一個特定的數據集群或預先存在的自定義端點,您需要指定的端點braze.xml
文件。
該文件的內容應該類似於下麵的代碼片段。確保替代YOUR_APP_IDENTIFIER_API_KEY
標識符中發現的管理設置釺儀表板的頁麵。在登錄dashboard.braze.com找到你的集群地址。
1 2 3 4 5
< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><資源><字符串name =“com_braze_api_key”>YOUR_APP_IDENTIFIER_API_KEY< /字符串><字符串可翻譯的=“假”name =“com_braze_custom_endpoint”>YOUR_CUSTOM_ENDPOINT_OR_CLUSTER< /字符串>< /資源>
步驟3:向AndroidManifest.xml添加所需的權限
現在您已經添加你的API密匙,你需要添加以下權限AndroidManifest.xml
:
1 2
< uses-permissionandroid: name =“android.permission.INTERNET”/ >< uses-permissionandroid: name =“android.permission.ACCESS_NETWORK_STATE”/ >
與發布的Android M, Android從一個安裝時轉向了一個運行時的權限模型。然而,這兩個權限是正常的權限,如果應用程序清單中列出的自動。欲了解更多信息,請訪問Android許可文件。
第四步:跟蹤用戶會話Android
活動的生命周期回調的集成
調用openSession ()
,closeSession ()
,ensureSubscribedToInAppMessageEvents ()
,InAppMessageManager
登記是可選自動處理的。
注冊活動生命周期回調
將下麵的代碼添加到onCreate ()
你的方法應用程序
類:
1 2 3 4 5 6 7
公共類MyApplication擴展應用程序{@Override公共無效onCreate(){超級。onCreate();registerActivityLifecycleCallbacks(新BrazeActivityLifecycleCallbackListener(sessionHandlingEnabled,inAppMessagingRegistrationEnabled));}}
1 2 3 4 5 6
類MyApplication:應用程序(){覆蓋有趣的onCreate(){超級。onCreate()registerActivityLifecycleCallbacks(BrazeActivityLifecycleCallbackListener(sessionHandlingEnabled,inAppMessagingRegistrationEnabled))}}
第一個參數指示偵聽器來處理openSession ()
和closeSession ()
調用。第二個參數指示偵聽器來處理registerInAppMessageManager ()
和unregisterInAppMessageManager ()
調用。
看到我們的KDoc為更多的信息。注意,任何非標準手冊會話集成並不完全支持。
第五步:實現位置跟蹤
如果你想使釺位置收集、更新braze.xml
文件包括com_braze_enable_location_collection
並確保其值設置為真正的
:
1
< boolname =“com_braze_enable_location_collection”>真正的< / bool >
從釺3.6.0 Android SDK版本,釺位置集合在默認情況下是禁用的。
SDK集成完成
釺現在可以收集指定的數據從您的應用程序和你應該完成了基本的集成。