Installation

Requirements

iOS 18.0+ / macOS 15.0+
Swift 6.0+
Xcode 16+

The SDK has zero external dependencies.

Swift Package Manager

Xcode

Open your project in Xcode
Go to File > Add Package Dependencies
Enter the repository URL: https://github.com/grantiva/ios-sdk
Select Up to Next Major Version from 2.1.0
Add Grantiva to your app target

Package.swift

dependencies: [
    .package(url: "https://github.com/grantiva/ios-sdk", from: "2.1.0")
],
targets: [
    .target(
        name: "YourApp",
        dependencies: [
            .product(name: "Grantiva", package: "Grantiva")
        ]
    )
]

Initialize the SDK

import Grantiva

let grantiva = Grantiva(teamId: "YOUR_TEAM_ID")

Parameter	Type	Required	Description
`teamId`	`String`	Yes	Your Apple Developer Team ID
`apiKey`	`String?`	No	API key for simulator/development use

The SDK automatically reads your Bundle ID from Bundle.main.bundleIdentifier. Together with the Team ID, this identifies your app to the Grantiva backend — no API keys needed on-device.

API key mode (development only)

App Attest is not available in the iOS simulator. For development, pass an API key:

#if targetEnvironment(simulator)
let grantiva = Grantiva(teamId: "YOUR_TEAM_ID", apiKey: "your-dev-api-key")
#else
let grantiva = Grantiva(teamId: "YOUR_TEAM_ID")
#endif

In API key mode, the SDK skips real App Attest and returns a synthetic attestation result. Do not ship API keys in production builds.

App Attest capability

No special entitlements are required. App Attest is available on all iOS 14+ devices (real hardware only). The SDK checks availability at runtime and throws GrantivaError.deviceNotSupported if unavailable.

Note: While Apple introduced App Attest in iOS 14, the Grantiva SDK requires iOS 18.0+.

Getting Started

iOS SDK

CLI

Concepts

Push

Dashboard

Requirements

Swift Package Manager

Xcode

Package.swift

Initialize the SDK

API key mode (development only)

App Attest capability

​Requirements

​Swift Package Manager

​Xcode

​Package.swift

​Initialize the SDK

​API key mode (development only)

​App Attest capability

Requirements

Swift Package Manager

Xcode

Package.swift

Initialize the SDK

API key mode (development only)

App Attest capability