Android SDK - تهيئة الـ SDK
التثبيت
Section titled التثبيتسيقوم السطر التالي بتثبيت المتتبّع، ومعه الـ 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:v1.1.7")
}
التهيئة
Section titled التهيئةعند إنشاء مثيل من متتبّع OpenReplay، هناك عدة خيارات تهيئة يمكنك توفيرها لتخصيص العديد من جوانب التسجيل وتجربة التسجيل. يجب أن تضبط خيار projectKey في الباني (constructor). يمكنك الحصول على هذه القيمة من لوحة تحكم OpenReplay الخاصة بك ضمن ‘Preferences > Projects’.
إضافة شيفرة التتبّع
Section titled إضافة شيفرة التتبّعأضِف الشيفرة التالية إلى ملف MainActivity.kt الخاص بك:
// MainActivity.kt
import com.openreplay.tracker.OpenReplay
//...
class MainActivity : AppCompatActivity() {
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 تنقية البياناتراجع كيفية تنقية البيانات في عمليات إعادة التشغيل على Android لمزيد من التفاصيل.
خيارات التهيئة
Section titled خيارات التهيئةcrashes: Boolيفعّل crashlytics.analytics: Boolيفعّل تتبّع التحليلات لطرق العرض (views) المعلَّمة.performances: Boolيفعّل مستمِع الأداء.logs: Boolيفعّل مستمِع السجلّات.screen: Boolيفعّل مسجّل الشاشة.wifiOnly: Boolيجبر المتتبّع على البدء فقط إذا كان لدى المستخدم اتصال wifi.
هل لديك أسئلة؟
Section titled هل لديك أسئلة؟إذا كانت لديك أي أسئلة حول هذه العملية، فلا تتردّد في التواصل معنا على Slack الخاص بنا أو الاطّلاع على المنتدى لدينا.