Skip to main content

Installation

The iOS SDK ships as a Swift Package. Add it in Xcode or in your Package.swift.

Requirements​

  • iOS 14 or later deployment target
  • Xcode 15+ (Swift 5.9 tools)
  • Two Apple dependencies resolve automatically from public repositories: swift-certificates and swift-crypto.

Add the package (Xcode)​

  1. File → Add Package Dependencies…
  2. Paste the Swift Package URL Wi-DAS gave you: 
    <widas-sdk-ios package URL>
  3. Set the rule to Up to Next Minor from 0.1.0. The SDK is pre-1.0, so each 0.y bump can carry breaking changes until 1.0.0.
  4. Add the WiDAS library product to your app target.

Add the package (Package.swift)​

dependencies: [
    // Use the package URL Wi-DAS provides.
    .package(url: "<widas-sdk-ios package URL>", from: "0.1.0"),
],
targets: [
    .target(
        name: "YourApp",
        dependencies: [
            .product(name: "WiDAS", package: "widas-sdk-ios"),
        ]
    ),
]

Import​

import WiDAS
Fetching it isn't the same as being able to use it

The package is public, so anyone can add it, but fetching it grants no access. Issuance is gated by App Attest and your registration with Wi-DAS. An unregistered app that calls connect() gets attestationRejected / entitlementMissing back. Work through Setup and get registered before you expect a successful connect().

Versioning​

The SDK is on 0.1.x for now, moving to 1.0.0 once the on-device flow is confirmed. Because of SPM's 0.y.z rules, from: "0.1.0" resolves >= 0.1.0 < 0.2.0. Release notes live in the SDK repo's CHANGELOG.md.

Next: Setup.