۱. وابستگی را اضافه کن

بسته را به dependencies ماژول اپ اضافه کن.

dependencies {
    implementation("ir.ashkarhq:ashkar-kotlin:0.1.0")
}

۲. آشکار را به اپ وصل کن

client را هنگام شروع اپ بساز و handler خطاهای مدیریت‌نشده را فعال کن.

import android.app.Application
import ir.ashkarhq.sdk.AshkarClient
import ir.ashkarhq.sdk.AshkarConfig
import ir.ashkarhq.sdk.addAndroidContext
import ir.ashkarhq.sdk.installUncaughtExceptionHandler

class App : Application() {
    lateinit var ashkar: AshkarClient
        private set

    override fun onCreate() {
        super.onCreate()
        ashkar = AshkarClient(
            AshkarConfig(
                projectKey = BuildConfig.ASHKAR_PROJECT_KEY,
                endpoint = "https://app.ashkarhq.ir",
                environment = "production",
                release = "android@1.0.0",
            ),
        )
        ashkar.addAndroidContext(applicationContext)
        ashkar.installUncaughtExceptionHandler()
    }
}

۳. یک خطای آزمایشی بفرست

یک پیام آزمایشی بفرست و برای کامل شدن ارسال کمی فرصت بده.

import ir.ashkarhq.sdk.AshkarClient
import kotlin.time.Duration.Companion.seconds

fun sendAshkarTest(ashkar: AshkarClient) {
    val eventId = ashkar.captureMessage("Ashkar Android test")
    check(ashkar.flush(2.seconds)) {
        "Ashkar test event was not sent"
    }
    println(eventId)
}

۴. نتیجه را در Issues ببین

در پروژه دنبال «Ashkar Android test» بگرد. پس از آن خطاهای مدیریت‌نشده‌ی اپ هم خودکار ثبت می‌شوند.