iOS SDK

https://center.abrova.ir/abrova/abrova-trace-ios-sdk.git

dependencies: [
    .package(url: "https://center.abrova.ir/abrova/abrova-trace-ios-sdk.git", from: "0.2.4")
]

pod 'AbrovaTrace', :git => 'https://center.abrova.ir/abrova/abrova-trace-ios-sdk.git', :tag => '0.2.4'

pod install

import UIKit
import AbrovaTrace

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        let config = AbrovaTraceConfigBuilder(apiKey: "ab_live_YOUR_API_KEY")
            .environment("production")
            .release(Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String)
            .debug(false)
            .captureUncaughtExceptions(true)
            .captureSignalCrashes(true)
            .captureAnr(true)
            .anrTimeoutMs(5000)
            .build()

        AbrovaTrace.shared.initialize(config: config)

        return true
    }

    func applicationWillTerminate(_ application: UIApplication) {
        AbrovaTrace.shared.close()  // Optional: the SDK also does this on terminate
    }
}

import SwiftUI
import AbrovaTrace

@main
struct MyApp: App {
    init() {
        let config = AbrovaTraceConfigBuilder(apiKey: "ab_live_YOUR_API_KEY")
            .environment("production")
            .release(Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String)
            .debug(false)
            .captureUncaughtExceptions(true)
            .captureSignalCrashes(true)
            .build()

        AbrovaTrace.shared.initialize(config: config)
    }

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

do {
    try riskyOperation()
} catch {
    AbrovaTrace.shared.captureError(error)
}

AbrovaTrace.shared.captureError(
    error,
    message: "Failed to load user profile",
    extra: ["user_id": userId, "screen": "ProfileView"],
    tags: ["feature": "user_profile"]
)

// Info message
AbrovaTrace.shared.captureMessage("User completed onboarding", level: .info)

// Warning message
AbrovaTrace.shared.captureMessage("API rate limit approaching", level: .warning)

// Error message with extra data
AbrovaTrace.shared.captureMessage(
    "Payment failed",
    level: .error,
    extra: ["amount": 99.99]
)

// User action
AbrovaTrace.shared.addUserBreadcrumb("Added item to cart", data: ["product_id": "abc"])

// Navigation
AbrovaTrace.shared.addNavigationBreadcrumb(from: "HomeView", to: "ProductDetailView")

// HTTP request
AbrovaTrace.shared.addHttpBreadcrumb(
    method: "POST",
    url: "https://api.example.com/orders",
    statusCode: 201,
    duration: 0.342  // seconds (TimeInterval)
)

// Custom breadcrumb
AbrovaTrace.shared.addBreadcrumb("Order placed", type: .info, data: [
    "order_id": "12345",
    "total": 99.99
])

// Registers AbrovaTraceURLProtocol globally (URLSession.shared and default-configured sessions)
AbrovaTrace.shared.enablePerformanceTracking()

// Requests are now tracked automatically
let (data, response) = try await URLSession.shared.data(from: url)

// Create a tracked URLSession
let config = AbrovaTrace.shared.performanceSessionConfiguration()
// Equivalent to:
// config.protocolClasses = [AbrovaTraceURLProtocol.self] + (config.protocolClasses ?? [])
let session = URLSession(configuration: config)

// Requests through this session are tracked
let task = session.dataTask(with: url) { data, response, error in
    // Handle response
}
task.resume()

// Enable performance tracking globally
AbrovaTrace.shared.enablePerformanceTracking()

// All URLSession requests are now tracked with timing data
let (data, response) = try await URLSession.shared.data(from: url)
// Method, URL, status code, and duration are automatically reported

import Alamofire

// Create a session with AbrovaTrace tracking
let configuration = URLSessionConfiguration.default
configuration.protocolClasses = [AbrovaTraceURLProtocol.self] + (configuration.protocolClasses ?? [])

let session = Session(configuration: configuration)

// All requests through this session are tracked
session.request("https://api.example.com/users").response { response in
    // Handle response
}

// Async (iOS 13+); use PerformanceTracker.track(_:) for synchronous work
let result = try await PerformanceTracker.trackAsync("load_user_profile") {
    let user = try await fetchUser()
    try await cacheUser(user)
    return user
}

// Or time it manually
let tracker = PerformanceTracker(operation: "image_processing")
// ... do work
tracker.finish(status: .ok)

// HTTP request span
AbrovaTrace.shared.reportPerformanceSpan(
    PerformanceSpan.fromHttpRequest(
        method: "GET",
        url: "https://api.example.com/products",
        statusCode: 200,
        durationMs: 245,
        startTime: Date().addingTimeInterval(-0.245)
    )
)

// Database query span
AbrovaTrace.shared.reportPerformanceSpan(
    PerformanceSpan.forDbQuery(
        queryType: "SELECT",
        tableName: "products",
        durationMs: 15,
        startTime: Date().addingTimeInterval(-0.015),
        rowsAffected: 50
    )
)

// Custom operation span
AbrovaTrace.shared.reportPerformanceSpan(
    PerformanceSpan.custom(
        operation: "image_processing",
        durationMs: 1250,
        startTime: Date().addingTimeInterval(-1.25),
        tags: ["format": "png"]
    )
)

// Enable logging after initialization
AbrovaTrace.shared.enableLogging(sourceId: "my-ios-app")

AbrovaTrace.shared.info("User login successful", metadata: ["user_id": "user_123"])

# For debug builds (simulator)
~/Library/Developer/Xcode/DerivedData/YourApp-*/Build/Products/Debug-iphonesimulator/YourApp.app.dSYM

# For release/archive builds
~/Library/Developer/Xcode/Archives/*.xcarchive/dSYMs/

# Zip the .dSYM bundle
cd ~/Library/Developer/Xcode/DerivedData/YourApp-*/Build/Products/Debug-iphonesimulator/
zip -r YourApp.dSYM.zip YourApp.app.dSYM

// Set individual extras
AbrovaTrace.shared.setExtra("organizationId", value: "org-123")
AbrovaTrace.shared.setExtra("feature", value: "checkout-v2")

// Set multiple at once
AbrovaTrace.shared.setExtras([
    "organizationId": "org-123",
    "feature": "checkout-v2",
    "experiment": "new-flow"
])

// Clear when no longer needed (e.g. on logout)
AbrovaTrace.shared.clearExtras()

AbrovaTrace.shared.setTag("team", value: "payments")
AbrovaTrace.shared.setTag("region", value: "us-east")

AbrovaTrace.shared.setTags(["team": "payments", "version": "2.1"])

AbrovaTrace.shared.clearTags()

import SwiftUI
import AbrovaTrace

@main
struct MyApp: App {

    init() {
        let config = AbrovaTraceConfigBuilder(apiKey: "ab_live_your_api_key")
            .environment("production")
            .build()
        AbrovaTrace.shared.initialize(config: config)
    }

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

import UIKit
import AbrovaTrace

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        let config = AbrovaTraceConfigBuilder(apiKey: "ab_live_YOUR_API_KEY")
            .environment("production")
            .release(Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String)
            .debug(false)
            .captureUncaughtExceptions(true)
            .captureSignalCrashes(true)
            .captureAnr(true)
            .build()

        AbrovaTrace.shared.initialize(config: config)
        AbrovaTrace.shared.enablePerformanceTracking()

        return true
    }

    func applicationWillTerminate(_ application: UIApplication) {
        AbrovaTrace.shared.close()
    }
}

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        AbrovaTrace.shared.setUserId("user_123")
        AbrovaTrace.shared.addNavigationBreadcrumb(from: "Launch", to: "HomeView")
    }

    func handlePurchase() {
        AbrovaTrace.shared.addUserBreadcrumb("Initiated purchase", data: ["product": "Premium"])

        do {
            try processPurchase()
            AbrovaTrace.shared.captureMessage("Purchase successful", level: .info, extra: [
                "amount": 99.99
            ])
        } catch {
            AbrovaTrace.shared.captureError(
                error,
                message: "Purchase failed",
                extra: ["user_id": "user_123", "screen": "HomeView"]
            )
        }
    }

    func processPurchase() throws { /* ... */ }
}