### 搭建 ONNX Runtime 运行时环境 C++ 开发配置教程 #### 1. 安装 Visual Studio 为了开发基于 Windows 的 C++ 应用程序，建议安装最新版本的 Microsoft Visual Studio (推荐使用 Visual Studio 2022 或更高版本)[^1]。在安装过程中，请确保勾选以下组件： - **C++ 工作负载** - **Windows 10 SDK** 这些工具对于编译和链接 ONNX Runtime 所需的库文件至关重要。 --- #### 2. 下载并安装 ONNX Runtime 可以从官方 GitHub 页面下载预构建的二进制文件或自行编译源代码。以下是两种方法： ##### 方法一：使用预构建的二进制包 访问 [ONNX Runtime Releases](https://github.com/microsoft/onnxruntime/releases)，找到最新的稳定版 release 并下载适用于 Windows 的 `onnxruntime-win-x64-*` 文件夹压缩包。解压后会得到如下目录结构： - `include/`: 包含头文件。 - `lib/`: 包含静态库 `.lib` 和动态库 `.dll`。 ##### 方法二：通过 vcpkg 自动管理依赖项 如果希望简化依赖管理和更新流程，可以利用 `vcpkg` 来安装 ONNX Runtime： ```bash git clone https://github.com/Microsoft/vcpkg.git cd vcpkg ./bootstrap-vcpkg.sh # Linux/macOS, 对于 Windows 使用 bootstrap-vcpkg.bat ./vcpkg install onnxruntime:x64-windows ``` 完成安装后，在项目中集成 `vcpkg` 提供的路径即可自动加载所需库[^2]。 --- #### 3. 配置 Visual Studio 项目 创建一个新的 C++ 控制台应用程序，并按照以下步骤设置项目属性： ##### 设置包含路径 (`Include Directories`) 导航至项目的“属性”对话框 -> “C/C++” -> “常规”，将 ONNX Runtime 头文件所在的路径添加到“附加包含目录”。例如： ``` D:\path\to\onnxruntime\include ``` ##### 设置库路径 (`Library Directories`) 同样在“属性”对话框中定位到“链接器” -> “常规”，将动态库所在路径加入“附加库目录”。例如： ``` D:\path\to\onnxruntime\lib ``` ##### 添加依赖库 (`Input Libraries`) 转到“链接器” -> “输入”，向“附加依赖项”追加以下内容（具体名称可能因版本而异）： ``` onnxruntime.lib ``` --- #### 4. 编写测试代码 下面是一个简单的示例代码片段，展示如何加载 ONNX 模型并执行推理操作： ```cpp #include <iostream> #include "onnxruntime_cxx_api.h" int main() { Ort::Env env(ORT_LOGGING_LEVEL_WARNING, "test"); // 创建 ORT 环境对象 Ort::SessionOptions session_options; try { std::string model_path = "./model/yolov8.onnx"; // 替换为实际模型路径 Ort::Session session(env, model_path.c_str(), session_options); // 加载模型 const char* input_names[] = {session.GetInputNameAllocated(0, nullptr).get()}; const char* output_names[] = {session.GetOutputNameAllocated(0, nullptr).get()}; size_t num_inputs = session.GetInputCount(); size_t num_outputs = session.GetOutputCount(); std::cout << "Number of inputs: " << num_inputs << "\n"; std::cout << "Number of outputs: " << num_outputs << "\n"; // TODO: 准备输入张量数据... // TODO: 调用 Run 推理函数... } catch (const Ort::Exception& e) { std::cerr << "Error during inference: " << e.what() << '\n'; } return 0; } ``` 上述代码展示了基本的初始化逻辑以及如何获取模型的输入输出信息。 --- #### 5. 构建与运行 确认所有配置无误后，点击“生成解决方案”按钮来编译项目。成功之后，启动调试模式验证功能是否正常工作。注意，若采用动态链接方式，则需要将对应平台架构下的 DLL 文件放置在同一目录下或者系统 PATH 中。 --- ###