راه‌اندازی دیدبان در iOS

نحوه مقداردهی اولیه Didban در SwiftUI و UIKit با استفاده از Swift.

راه‌اندازی در اپلیکیشن‌های SwiftUI

در برنامه‌های مدرن SwiftUI، متد Didban.initialize را در سازنده (init) ساختار اصلی App فراخوانی کنید:

MyApp.swiftswift
import SwiftUI
import Didban

@main
struct MyApp: App {
    init() {
        // Initialize Didban as early as possible during app launch
        Didban.initialize(apiKey: "didban_ing_your_project_key")
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

راه‌اندازی در اپلیکیشن‌های UIKit

برای پروژه‌های مبتنی بر UIKit، دیدبان را در متد didFinishLaunchingWithOptions راه‌اندازی نمایید:

AppDelegate.swiftswift
import UIKit
import Didban

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        Didban.initialize(apiKey: "didban_ing_your_project_key")
        return true
    }
}

فرایند راه‌اندازی دیدبان چه اقداماتی انجام می‌دهد؟

  • ثبت هندلرهای سیگنال POSIX: سیگنال‌های SIGSEGV، SIGBUS، SIGILL، SIGABRT، SIGFPE و SIGTRAP را با هوک اختصاصی C ثبت می‌کند.
  • رهگیری استثناهای Objective-C: استثناهای NSException را با NSSetUncaughtExceptionHandler ثبت و پشتیبانی می‌کند.
  • بازیابی کرش‌های قبلی دیسک: فایل‌های تام‌استون کرش‌های قبلی را از فضای امن برنامه خوانده و برای ارسال غیرهمگام صف‌بندی می‌کند.
  • شروع تله‌متری سشن: سشن فعال پیش‌زمینه را ثبت کرده و شنونده‌های چرخه حیات UIKit را فعال می‌سازد.
  • راه‌اندازی ارسال لاگ‌های زنده (Live App Logs): بافر حلقوی ۲۰۰ موردی را فعال کرده و زمان‌بندی ارسال دسته‌ای لاگ‌ها (هر ۱۵ ثانیه یا ورود به پس‌زمینه) را تنظیم می‌کند.

هشدار امنیتی کلیدهای پروژه

هشدار امنیتی

فقط از کلید INGEST درون اپلیکیشن iOS استفاده کنید! کلیدهای با پیشوند didban_ing_ فقط مجوز ثبت خطا دارند. هرگز کلیدهای BUILD (با پیشوند didban_build_) را در کدهای کلاینت یا باندل Xcode قرار ندهید.