获取和编译

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

预编译 SDK

当前 GitHub Release 为 v1.2.4，下方提供 Windows、Linux、Android、Apple 和 HarmonyOS 的原生 SDK。Python 包当前为 1.2.4.post3，包含 Windows x64 wheel；Android AAR 仍为 1.2.4.post1。两者的原生 SDK 同为 1.2.4，安装方式见下方说明。

表中的 CUDA / Ubuntu 版本来自发布文件名，部署时仍需检查库的实际依赖。HarmonyOS 包内包含 arm64 原生 SDK、HAR 工程和配套的 Node-API 库，导入方式见 HarmonyOS 接入。Windows x64 CPU 可使用预编译 C/C++ SDK、通过 PyPI 安装 Python 包，或从源码构建。CoreML 与独立桌面 Java 的构建方式见下方对应章节。

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

Apple SDK 产物

CPU 版本直接下载 inspireface-apple-1.2.4.zip。一个包同时覆盖 macOS Intel / Apple Silicon、iOS arm64 真机以及 arm64 / x86_64 模拟器，包含示例使用的 Objective-C、Swift Framework 和 C/C++ 头文件、库。

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。

包内 macOS 库的最低版本为 arm64 14.0、x86_64 15.0；iOS 真机最低为 11.0，模拟器分别为 arm64 14.0、x86_64 11.0。CoreML 版本需要本地构建，并搭配兼容的 CoreML 模型资源包；自定义构建见 iOS 和 macOS。

Python 与 Android 包

PyPI 上的 Python 包已更新为 1.2.4.post3，包含 1.2.4 CPU 原生库，直接安装即可：

python -m pip install inspireface opencv-python

已有安装使用 python -m pip install --upgrade inspireface 升级。此版本提供以下 py3-none wheel，按 Python 进程的架构选择：

Windows 使用 64 位 Python，运行时需要 Visual C++ x64 Redistributable。wheel 已包含 CPU 推理用的 libInspireFace.dll，安装时无需本地编译器。模型加载与 DLL 排查见 Windows 接入。

下载文件及校验值见 PyPI 文件列表。需要替换原生库或制作 wheel 时，参照 Python 打包与原生库替换。

Android 使用完整的 1.2.4.post1 AAR，依赖为 com.github.HyperInspire:inspireface-android-sdk:v1.2.4.post1，保留版本前的 v。包内含 Android 封装、完整 Java API、模型与 R8 规则，支持 arm64-v8a、armeabi-v7a 和 x86_64，最低 Android API 24；每个 ABI 只有一份 libInspireFace.so。原生版本查询返回 1.2.4，C API level 为 2。

仓库地址与 Gradle 配置见 Android 接入。需要本地构建时，Android 构建说明如何生成 JAR、原生库并放入应用；使用 AAR 时无需额外添加这些文件。

Java SDK

Java 版通过 JNI 提供 C API 对应的功能，不依赖 Android。使用包含 command/build_java.sh 的 Develop 源码构建，安装目录 build/java-sdk/install/Java/ 中包含兼容 Java 8 的 inspireface.jar、当前目标的原生库、Java 源文件和示例。

JAR 可跨目标使用，原生库按运行 JVM 的系统和架构选择，并与 JAR 保持配套。当前接入使用本地 JAR；构建步骤见 Java 打包，完整调用示例见 Java 接入。

单独下载模型包

原生 SDK、JVM 包和 Python wheel 运行时还需要模型资源包。Android 1.2.4.post1 AAR 已附带 Pikachu 与 Megatron，可直接按 Android 初始化步骤使用；替换模型时再准备外部资源包。通过模型发布页下载：CPU 使用 Pikachu 或 Megatron，TensorRT 使用 Megatron_TRT，Rockchip 使用与 SoC 对应的 Gundam 文件。完整对应关系和加载方法见模型选择。

选择构建章节