获取和编译

平台、后端和接口版本符合要求时，可以直接使用预编译 SDK。需要新接口、更换工具链或调整推理后端时，再从源码构建。本章先介绍原生库的编译，再说明如何用于应用或打包进 Python 环境。

预编译 SDK

下面按 2026 年 9 月 29 日的 GitHub Releases 整理。目前公开的原生 SDK 最新版本为 v1.2.3，下载链接固定到该版本，便于接入时选用一致的产物。

表中的 CUDA / Ubuntu 版本来自发布文件名，部署时仍需检查库依赖。这个发布版本没有独立的 HarmonyOS、Windows 或 CoreML 压缩包；HarmonyOS 和 Apple 平台的源码构建方式见下方对应章节。本章暂不提供 Windows 构建步骤。

按应用进程选择架构和 C 运行库。64 位设备上的应用也可能是 32 位进程。使用同一压缩包中的头文件和库；静态 Framework、GPU / NPU 库的链接方式见对应平台章节。

Apple SDK 产物

1.2.4 源码加入了 Objective-C、Swift 接口、iOS 模拟器构建和配套的 XCFramework。上面的 v1.2.3 下载包仍采用旧产物结构；运行本文档的 Apple 示例时，请按 Develop 版本的获取方式拉取源码并构建。

InspireFace.framework 包含 C 与 Objective-C 接口，InspireFaceSwift.framework 提供 Swift 配置类型和限定作用域的缓冲区辅助方法。两个 Framework 应来自同一次构建。打包结果还包含各平台合并后的 Framework、原生 SDK 目录，以及用于核对架构和最低系统版本的元数据。

真机与模拟器的构建见 iOS，Intel、Apple Silicon 与通用架构的构建见 macOS。iOS Framework 是静态库，macOS Framework 是动态库，在 Xcode 中采用不同的嵌入设置。新版 iOS Framework 已合入推理依赖，应用 target 无需再添加 MNN.framework。

Apple 发布工作流生成的 CPU 压缩包名为 inspireface-apple-<version>.zip；截至上述检查日期，发布页还没有该文件。CoreML 产物可以通过同一构建脚本在本地生成，运行时需搭配兼容的 CoreML 模型资源包。

Python 与 Android 包

python -m pip install inspireface opencv-python

需要替换原生库或制作 wheel 时，参照 Python 打包与原生库替换。

Android 示例使用 JitPack 依赖 com.github.HyperInspire:inspireface-android-sdk:1.2.0，仓库地址和 Gradle 配置见 Android 接入。Android 原生构建生成 JNI 库；将 Java 类与原生库组成 AAR 的步骤见 Android 构建。

单独下载模型包

SDK 和 Python wheel 运行时还需要模型资源包。通过模型发布页下载：CPU 使用 Pikachu 或 Megatron，TensorRT 使用 Megatron_TRT，Rockchip 使用与 SoC 对应的 Gundam 文件。完整对应关系和加载方法见模型选择。

选择构建章节