Android SDK - تهيئة الـ SDK

خيارات التهيئة لطريقة الباني (constructor) الخاصة بمتتبّع Android

Android SDK ⁠-⁠ تهيئة الـ SDK

سيقوم السطر التالي بتثبيت المتتبّع، ومعه الـ SDK لتتمكّن من الاستفادة من جميع ميزات المتتبّع.

أضِفه في ملف 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")
}

عند إنشاء مثيل من متتبّع 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")
			})

		// ...
	}
}

راجع كيفية تنقية البيانات في عمليات إعادة التشغيل على Android لمزيد من التفاصيل.

  • crashes: Bool يفعّل crashlytics.
  • analytics: Bool يفعّل تتبّع التحليلات لطرق العرض (views) المعلَّمة.
  • performances: Bool يفعّل مستمِع الأداء.
  • logs: Bool يفعّل مستمِع السجلّات.
  • screen: Bool يفعّل مسجّل الشاشة.
  • wifiOnly: Bool يجبر المتتبّع على البدء فقط إذا كان لدى المستخدم اتصال wifi.

إذا كانت لديك أي أسئلة حول هذه العملية، فلا تتردّد في التواصل معنا على Slack الخاص بنا أو الاطّلاع على المنتدى لدينا.