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' }
		}
}

أضِف الاعتمادية (dependency) في ملف 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 يُفعّل تتبّع التحليلات لطرق العرض المُعلَّمة.
  • performances: Bool يُفعّل مُستمِع الأداء.
  • logs: Bool يُفعّل مُستمِع السجلّات (logs).
  • screen: Bool يُفعّل مُسجِّل الشاشة.
  • wifiOnly: Bool يُجبر المتعقّب على البدء فقط إذا كان لدى المستخدم اتصال wifi.

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