دليل Android (Kotlin) مع AllStak

التقط الأعطال والأخطاء وANRs والأداء من تطبيق Android عبر حزمة AllStak Android SDK.

المستودع المصدر:
AllStak/allstak-android
مسار README:
README.md
إصدار الـ SDK:
0.2.0
مصدر التثبيت:
Maven (sa.allstak)
آخر تحقّق:
2026-05-31

التثبيت

أضف اعتمادية Gradle (ووحدتا OkHttp و Timber اختياريتان).

dependencies {
    implementation("sa.allstak:allstak-android:0.2.0")
    // optional:
    implementation("sa.allstak:allstak-android-okhttp:0.2.0")
    implementation("sa.allstak:allstak-android-timber:0.2.0")
}

الإعداد

هيّئ صراحةً في Application، أو استخدم بيانات meta في الـ manifest بلا شيفرة (تهيئة تلقائية عبر androidx.startup).

AllStak.init(this) {
    apiKey = "ask_live_xxx"
    environment = "production"
    release = "1.4.0+42"
}

مثال أساسي

بديل بلا شيفرة — أضف بيانات meta إلى AndroidManifest.xml.

<application>
    <meta-data android:name="sa.allstak.android.API_KEY" android:value="ask_live_xxx" />
    <meta-data android:name="sa.allstak.android.ENVIRONMENT" android:value="production" />
</application>

التقاط الأخطاء

تُلتقط الأعطال تلقائيًا (enableUncaughtExceptionHandler). والتقط الأخطاء المُعالَجة يدويًا.

AllStak.captureException(e, metadata = mapOf("orderId" to "ORD-123"))
AllStak.captureMessage("Checkout started", level = "info")

تتبّع الطلبات

استخدم وحدة allstak-android-okhttp لتجهيز OkHttp — installAllStak() على الباني، أو AllStakOkHttp.client()، أو AllStakOkHttp.instrument(existingClient). تحقن ترويسات التتبّع (traceparent، x-allstak-trace-id).

val client = OkHttpClient.Builder()
    .installAllStak()
    .build()

أفضل الممارسات

  • استخدم بيانات meta في الـ manifest أو AllStak.init في Application.
  • أضف وحدة OkHttp لتتبّع نداءات الشبكة.
  • يُكتشف release تلقائيًا من versionName+versionCode عند حذفه.
ابدأ مجاناً كل الأدلّة