Collar

Collar is a library which simplifies analytics debugging by showing events, screen views and user properties of your app as they happen.

Requirements

• Swift 5.1
• Xcode 14.0
• iOS 15.0

Installation

CocoaPods

Collar is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'Collar'

SwiftPM

If you are using the SwiftPM as your dependencies manager, add this to the dependencies in your Package.swift file:

dependencies: [
    .package(url: "https://github.com/infinum/ios-collar.git")
]

Usage

1. In your analytics manager add support for analytics collecting via Collar:

import Collar

// Events
AnalyticsCollectionManager.shared.log(event: "some_event", parameters: [
    "param1": "value1",
    "param2": "value2"
])

// User properties
AnalyticsCollectionManager.shared.setUserProperty("some_value", forName: "user_property_key")

// Screen views
AnalyticsCollectionManager.shared.track(screenName: "Home", screenClass: "HomeViewController")

IMPORTANT: Collar does NOT send out analytics data to remote services. This is left for the developer to solve in their own codebase, with Collar being simply a reflection of the current state of analytics data.

2. At the point where you want to display collected logs, you can just put the following line:

/// UIKit
AnalyticsCollectionManager.shared.showLogs(from: viewController)

/// SwiftUI
Button(action: { isPresented = true }) { ... }
    .collarLogSheet(isPresented: $isPresented)

Important

Please make sure that AnalyticsCollectionManager is not used in production builds. Best option would be not to include Collar in you production targets/configurations at all, for example:

pod 'Collar', :configurations => ['Development-release', 'Development-debug']

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Author

Filip Gulan, filip.gulan@infinum.com

Credits

Maintained and sponsored by Infinum.

License

Collar is available under the MIT license. See the LICENSE file for more info.