Requirements
Platform Requirementsโ
| Requirement | Version |
|---|---|
| iOS | 15.0+ |
| Xcode | 15.0+ |
| Swift | 5.9+ |
| NCKit (recommended) | 1.2.1+ |
| Device architecture | arm64 |
| Simulator architectures | arm64, x86_64 (via ios-arm64_x86_64-simulator) |
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 host | Architecture | Supported (1.2.1+) |
|---|---|---|
| Apple Silicon Mac | arm64 | Yes |
| Intel Mac | x86_64 | Yes |
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:
| Framework | Usage |
|---|---|
AVFoundation | Audio file decoding, format conversion, AVAudioConverter |
Accelerate | SIMD math operations in the DSP pipeline |
Foundation | File 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.