دليل Apple (iOS / macOS) مع AllStak

التقط الأعطال والأخطاء والأداء من تطبيق iOS أو macOS أو tvOS عبر حزمة AllStak Apple SDK.

المستودع المصدر:
AllStak/allstak-apple
مسار README:
README.md
إصدار الـ SDK:
0.2.0
مصدر التثبيت:
Swift Package Manager / CocoaPods
آخر تحقّق:
2026-05-31

التثبيت

أضف عبر Swift Package Manager أو CocoaPods.

// Swift Package Manager
.package(url: "https://github.com/AllStak/allstak-apple.git", from: "0.2.0")

// CocoaPods
pod 'AllStak', '~> 0.2'

الإعداد

ابدأ AllStak مرّة واحدة مبكرًا عند الإقلاع.

import AllStak

AllStak.start(
    apiKey: "astk_live_xxxxxxxx",
    environment: "production",
    release: "1.4.2"
)

مثال أساسي

تتبّع الأعطال وتعليق التطبيق والجلسات مفعّل افتراضيًا بعد start().

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

التقط الأخطاء والرسائل.

do { try risky() } catch { AllStak.capture(error) }
AllStak.capture(message: "checkout failed", level: "warning")

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

تُجهَّز طلبات URLSession الصادرة تلقائيًا افتراضيًا (تسجّل breadcrumbs مُنقّاة لـ HTTP وتُرفق traceparent و baggage بمعيار W3C). للإلغاء استخدم enableAutoHttpInstrumentation: false.

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

  • استدعِ AllStak.start مرّة واحدة عند الإقلاع.
  • اضبط environment و release.
  • ارفع ملفات dSYM (Scripts/allstak-upload-dsyms.sh) لرموز أعطال مقروءة.