Swift SDK for Aptabase

Instrument your apps with Aptabase, a privacy-first analytics platform for desktop, mobile and web apps.


Option 1: Swift Package Manager

Add the following lines to your Package.swift file:

let package = Package(
    dependencies: [
        .package(name: "Aptabase", url: "https://github.com/aptabase/aptabase-swift.git", branch: "main"), // Add the package
    targets: [
            name: "YourTargetName",
            dependencies: ["Aptabase"] // Add as a dependency

Option 2: Adding package dependencies with Xcode

Use this guide to add aptabase-swift to your project. Use https://github.com/aptabase/aptabase-swift.git for the url when Xcode asks.


First you need to get your App Key from Aptabase, you can find it in the Instructions menu on the left side menu.

Initialized the SDK as early as possible in your app, for example:

import SwiftUI
import Aptabase

struct ExampleApp: App {
    init() {
        Aptabase.initialize(appKey: "<YOUR_APP_KEY>"); // ? this is where you enter your App Key
    var body: some Scene {
        WindowGroup {

Afterwards you can start tracking events with trackEvent:

import Aptabase

Aptabase.trackEvent("connect_click"); // An event with no properties
Aptabase.trackEvent("play_music", with: ["name": "Here comes the sun"]) // An event with a custom property

A few important notes:

  1. The SDK will automatically enhance the event with some useful information, like the OS, the app version, and other things.
  2. You’re in control of what gets sent to Aptabase. This SDK does not automatically track any events, you need to call trackEvent manually.
    • Because of this, it’s generally recommended to at least track an event at startup
  3. The trackEvent function is a non-blocking operation as it runs on the background.
  4. Only strings and numbers values are allowed on custom properties


View Github