Android SDK - 初始化 SDK
下面这行命令将为您安装追踪器以及随附的 SDK,让您能够使用追踪器的所有功能。
Gradle 配置
Section titled Gradle 配置将其添加到根目录的 build.gradle 文件中 repositories 的末尾:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
mavenCentral()
maven { url 'https://jitpack.io' }
}
}
在应用的 build.gradle 文件中添加依赖项:
dependencies {
implementation("com.github.openreplay:android:Tag")
}
在实例化 OpenReplay 的追踪器时,您可以提供多个配置选项来自定义录制及录制体验的诸多方面。您必须在构造方法中设置 projectKey 选项。您可以在 OpenReplay 仪表盘的 ‘Preferences > Projects’ 下获取该值。
添加追踪代码
Section titled 添加追踪代码将以下代码添加到您的 MainActivity.kt 文件中:
// MainActivity.kt
import com.openreplay.tracker.OpenReplay
//...
class MainActivity : TrackingActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
// not required if you're using our SaaS version
OpenReplay.serverURL = "https://your.instance.com/ingest"
// check out our SDK docs to see available options
OpenReplay.start(
applicationContext,
"projectkey",
OpenReplay.Options.defaults(),
onStarted = {
println("OpenReplay Started")
})
// ...
}
}
设置触摸监听器
Section titled 设置触摸监听器// MainActivity.kt
import com.openreplay.tracker.listeners.TrackingActivity
// ...
class MainActivity : TrackingActivity() {
// ...
}
有关更多详情,请参阅如何在 Android 回放中对数据进行脱敏。
初始化选项
Section titled 初始化选项crashes: Bool启用崩溃分析(crashlytics)。analytics: Bool启用对已标记视图的分析追踪。performances: Bool启用性能监听器。logs: Bool启用日志监听器。screen: Bool启用屏幕录制器。wifiOnly: Bool强制追踪器仅在用户拥有 wifi 连接时启动。