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

خيارات الإعداد للدالة البانية الخاصة بمتتبّع 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: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 لمزيد من التفاصيل.

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

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