Skip to main content

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:

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

Integration Steps​

  1. Unzip the archive:

    Shell
    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 simulator (arm64 / x86_64 with NCKit 1.2.1+)

Simulator architectures (1.2.1+)​

The XCFramework includes ios-arm64_x86_64-simulator for Apple Silicon and Intel Mac simulators. See Requirements.

Exclude Intel Simulator (NCKit < 1.2.1 only)​

If you cannot upgrade past 1.2.0, exclude x86_64 for the simulator SDK:

text
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)​

Shell
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"
)