Skip to main content
Code samples

Manual XCFramework Integration

Use this method when you distribute NCKit through an internal artifact registry (Artifactory, Nexus, Sonatype), an MDM system, or any scenario where SPM/CocoaPods can't access the GitHub repository.

Download​

Get NCKit.xcframework.zip from GitHub Releases.

Verify the download integrity with the published SHA-256 checksum:

shasum -a 256 NCKit.xcframework.zip
# Compare with checksum in release notes

Integration Steps​

  1. Unzip the archive:

    unzip NCKit.xcframework.zip

  2. Drag NCKit.xcframework into your Xcode project navigator (under your project root, not inside a target)

  3. In the Add to targets dialog, check your app target

  4. In your target's General → Frameworks, Libraries, and Embedded Content:

    • Confirm NCKit.xcframework appears
    • Set it to Embed & Sign

  5. Verify linked frameworks in Build Phases → Link Binary with Libraries:

    • AVFoundation.framework
    • Accelerate.framework

  6. Build and run on a device or Apple Silicon simulator

Exclude Intel Simulator (Intel Mac)​

EXCLUDED_ARCHS[sdk=iphonesimulator*] = x86_64

Version Tracking​

When updating NCKit manually:

  1. Remove the old NCKit.xcframework from your project
  2. Drag in the new version
  3. Clean derived data: Product → Clean Build Folder
  4. Rebuild

Checksum Verification (SPM-style)​

swift package compute-checksum NCKit.xcframework.zip
Package.swift
.binaryTarget(
    name: "NCKit",
    url: "https://your-artifact-registry.com/NCKit/1.0.1/NCKit.xcframework.zip",
    checksum: "PASTE_CHECKSUM_HERE"
)