iOS (Swift) — التثبيت

المتطلبات

iOS 13+‎
Xcode 15+‎، Swift 5.9+‎
Swift Package Manager أو CocoaPods

هذه هي حزمة Swift الأصلية (native) للتطبيقات التي لا تستخدم Flutter إطلاقاً. إذا كان تطبيقك مبنياً بـ Flutter، استخدم Flutter SDK بدلاً من ذلك — فهو يغطّي iOS وAndroid وWeb من حزمة واحدة.

1. أضف الحزمة (Package)

في Xcode: File → Add Package Dependencies… وأدخل رابط Git الخاص بالحزمة، أو أضفها مباشرة إلى ملف Package.swift:

Package.swift

dependencies: [
    .package(url: "https://github.com/lerixDev/lerix_ios", from: "1.1.0")
]

ثم أضف Lerix كاعتمادية (dependency) لهدف تطبيقك (app target).

أو عبر CocoaPods

Podfile

pod 'Lerix', '~> 1.1'

شغّل pod install وافتح ملف .xcworkspace الناتج.

2. هيّئ الـ SDK

استدعِ Lerix.initialize() في أقرب وقت ممكن — داخل application(_:didFinishLaunchingWithOptions:) في AppDelegate. هذا يسجّل تطبيقك/جهازك مع الخادم (backend) ويفعّل الإبلاغ التلقائي عن الأعطال (crash reporting).

AppDelegate.swift

import UIKit
import Lerix

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        Lerix.initialize(
            apiKey: "your-api-key",
            projectId: "your-project-id",
            debugMode: true
        )
        return true
    }
}

ستجد مفتاح الـ API ومعرّف المشروع في لوحة تحكم Lerix ضمن إعدادات المشروع (Project Settings).

إذا كان تطبيقك يستخدم دورة حياة SwiftUI الخاصة بـ App بدلاً من AppDelegate التقليدي، أرفق واحداً باستخدام @UIApplicationDelegateAdaptor:

@main
struct MyApp: App {
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

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

المعاملات (Parameters)

المعامل	النوع	مطلوب	الوصف
`apiKey`	`String`	نعم	مفتاح API الخاص بمشروعك من لوحة التحكم
`projectId`	`String`	نعم	معرّف مشروعك (slug) من لوحة التحكم
`url`	`String`	لا	رابط الخادم الأساسي. الافتراضي هو `https://api.lerix.dev/v1` — غيّره فقط إذا كنت تستضيف الخادم بنفسك
`debugMode`	`Bool`	لا	طباعة سجلّات طلبات/استجابات الـ SDK في الـ console (الافتراضي: `false`)
`enableCrashReporting`	`Bool`	لا	تثبيت معالج الأعطال التلقائي (الافتراضي: `true`) — راجع تتبع الأخطاء
`onError`	`((Error) -> Void)?`	لا	يُستدعى إذا فشلت التهيئة نفسها (مثلاً تعذّر الوصول للشبكة)

3. تحقّق من التكامل

أرسل خطأً تجريبياً للتأكّد من أن كل شيء يعمل:

Lerix.throwError("Test error", stack: Thread.callStackSymbols)

ثم افتح لوحة التحكم — يجب أن يظهر الخطأ خلال ثوانٍ.

كل شيء جاهز! تابع إلى تتبع الأخطاء لإرسال أخطاء مخصّصة وتفعيل الإبلاغ التلقائي عن الأعطال، أو إلى الإشعارات لتفعيل الإشعارات.

البدء

أطر العمل

الوحدات

المطورون

iOS (Swift) — التثبيت

المتطلبات

1. أضف الحزمة (Package)

أو عبر CocoaPods

2. هيّئ الـ SDK

المعاملات (Parameters)

3. تحقّق من التكامل

​المتطلبات

​1. أضف الحزمة (Package)

​أو عبر CocoaPods

​2. هيّئ الـ SDK

​المعاملات (Parameters)

​3. تحقّق من التكامل

المتطلبات

1. أضف الحزمة (Package)

أو عبر CocoaPods

2. هيّئ الـ SDK

المعاملات (Parameters)

3. تحقّق من التكامل