شروع سریع اندروید

۱. پروژه و کلید Ingestion بسازید

در app.didban.cloud یک پروژه بسازید. سپس در تنظیمات پروژه، بخش API Keys، کلید «Ingestion Key» بسازید و مقدار کامل آن را همان زمان کپی کنید.

۲. مخزن و وابستگی را اضافه کنید

در فایل تنظیمات پروژه، مخزن عمومی دیدبان را به repositoryهای وابستگی اضافه کنید:

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven(url = "https://repo.didban.cloud")
    }
}

سپس وابستگی runtime را در ماژول application اضافه کنید:

dependencies {
    implementation("cloud.didban:didban-android:0.2.0")
}

SDK حداقل minSdk 23 نیاز دارد و مجوز android.permission.INTERNET را در manifest کتابخانه اعلام می‌کند.

۳. SDK را در Application راه‌اندازی کنید

در ابتدای onCreate کلاس Application خود، SDK را با کلید Ingestion راه‌اندازی کنید. API میزبان به‌صورت پیش‌فرض تنظیم شده است.

import android.app.Application
import dev.didban.android.Didban

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        Didban.init(context = this, apiKey = "didban_ing_your_key")
    }
}

اگر کلاس Application سفارشی دارید، آن را در AndroidManifest.xml معرفی کنید.

۴. اولین کرش را بررسی کنید

یک مسیر آزمایشی فقط برای توسعه ایجاد کنید که خطای مدیریت‌نشده پرتاب کند:

fun triggerTestCrash() {
    error("My first Didban crash")
}

1. اپلیکیشن خاتمه می‌یابد؛ این رفتار طبیعی است.
2. دیدبان رخداد را قبل از واگذاری کرش، در فضای خصوصی برنامه ذخیره می‌کند.
3. اپلیکیشن را دوباره باز کنید. آپلود در اجرای بعدی و به‌صورت پس‌زمینه انجام می‌شود.
4. در داشبورد، پروژه را انتخاب و Issues را باز کنید.

گام بعدی

برای جزئیات راه‌اندازی، به صفحه Initialization؛ و برای R8 و بارگذاری خودکار mapping، به Production Setup بروید.