Skip to main content
Code samples

Requirements

Platform Requirementsโ€‹

RequirementVersion
iOS15.0+
Xcode15.0+
Swift5.9+
NCKit (recommended)1.2.1+
Device architecturearm64
Simulator architecturesarm64, x86_64 (via ios-arm64_x86_64-simulator)
Intel Mac simulator (1.2.1+)

From NCKit 1.2.1, the XCFramework includes an ios-arm64_x86_64-simulator slice. Intel Mac simulators run natively on x86_64 without Rosetta. Use 1.2.1 or newer โ€” see v1.2.1 changelog.

Architecture Detailsโ€‹

NCKit.xcframework/                        # 1.2.1+
โ”œโ”€โ”€ ios-arm64/ # Physical iOS devices (iPhone, iPad)
โ”‚ โ””โ”€โ”€ NCKit.framework/
โ””โ”€โ”€ ios-arm64_x86_64-simulator/ # iOS Simulator (Apple Silicon + Intel)
โ””โ”€โ”€ NCKit.framework/

The ios-arm64_x86_64-simulator slice is a universal simulator binary:

Simulator hostArchitectureSupported (1.2.1+)
Apple Silicon Macarm64Yes
Intel Macx86_64Yes
Older releases (before 1.2.1)

Releases before 1.2.1 shipped ios-arm64-simulator only. Intel Mac simulators required Rosetta or a physical device. See Simulator troubleshooting.

Dependenciesโ€‹

NCKit has no external Swift dependencies. The following Apple frameworks are used internally:

FrameworkUsage
AVFoundationAudio file decoding, format conversion, AVAudioConverter
AccelerateSIMD math operations in the DSP pipeline
FoundationFile system, Bundle, URL handling

These are linked automatically via the podspec and xcframework metadata. No manual linking required for SPM or CocoaPods users.

Model Fileโ€‹

NCKit bundles NCKit_model.tar.gz inside NCKit.xcframework. The model is approximately 8.5 MB and is embedded in both device and simulator slices.

NCKitModelLocator.modelTarGzURL() handles extracting the model to a writable path at runtime.

See How to Use.