Swift installation - ClarioDesk

Add the package

In Xcode: File → Add Package Dependencies… and enter https://github.com/clariodesk/clariodesk-swift. Or in Package.swift:

dependencies: [
  .package(url: "https://github.com/clariodesk/clariodesk-swift", from: "0.1.1"),
],
targets: [
  .target(
    name: "MyApp",
    dependencies: [
      .product(name: "ClarioDesk", package: "clariodesk-swift"),
      // Only if you use the prebuilt screens:
      .product(name: "ClarioDeskUI", package: "clariodesk-swift"),
    ]
  ),
]

The two products

Product	What it is
`ClarioDesk`	The headless core: the `ClarioDesk` facade, `AsyncStream` reads, device key, realtime, outbox. One third-party dependency (SwiftCentrifuge).
`ClarioDeskUI`	The prebuilt SwiftUI screens (`ClarioDeskWidgets`), theme, and strings. Depends on the core.

A headless host links only ClarioDesk and Swift dead-strips the UI — you never ship screens you don’t present.

Platform requirements

Requirement	Value
iOS	16.0+
Swift	Package is Swift 6; consumable from Swift 5.x hosts
Hardware key	Secure Enclave (P-256); software fallback where the SEP is unavailable (e.g. the simulator)

Host prerequisites

Keychain

The SDK stores the device id, device-key blob, and offline outbox in the Keychain. Any code-signed app has this by default — which is every real app.

An unsigned build can’t write the Keychain (errSecMissingEntitlement, OSStatus -34018). This only bites ad-hoc/CI builds without a signing identity; add a keychain-access-groups entitlement there (the package’s example app shows how).

Camera usage string

Add NSCameraUsageDescription to your Info.plist only if you use the prebuilt UI’s camera attach affordance:

<key>NSCameraUsageDescription</key>
<string>Take a photo to attach to your support messages.</string>

The photo picker (PhotosPicker) and the document picker need no usage strings on iOS 16+.

Push

The standard APNs capability plus a one-line token forward — see the push guide. No Firebase.

Verify

import ClarioDesk

ClarioDesk.initialize(.init(apiKey: "pk_live_…"))
// Fire-and-forget: every subsequent call awaits the shared bootstrap, so
// nothing races. Next, wire identity. See the lifecycle guide.

Next: lifecycle integration

Wire the four host events that touch the SDK.

​Add the package

​The two products

​Platform requirements

​Host prerequisites

​Keychain

​Camera usage string

​Push

​Verify

Next: lifecycle integration

Add the package

The two products

Platform requirements

Host prerequisites

Keychain

Camera usage string

Push

Verify