RealSense SDK macOS 安装:3 步快速编译 librealsense,跑通第一帧深度流
2026/9/18 23:21:33 网站建设 项目流程

RealSense SDK macOS 安装:3 步快速编译 librealsense,跑通第一帧深度流

【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense

围绕 RealSense SDK macOS 安装,本文带你把相机接上 Mac,跑通第一帧深度流。RealSense SDK(librealsense,即本仓库源码)是 Intel 深度相机的官方开发包,负责读取彩色、深度与运动数据。下面从环境自检、三步编译、排错到应用打包,一次讲清。

动手前:四件工具逐一点验

这一节你只做一件事:打开"终端",逐项确认四样工具都就位。

  • macOS 10.14 或更新——官方支持的最低系统版本,低于它编译链会直接拒收
  • Xcode 6.0+ 或 Command Line Tools——提供 clang 编译工具链,缺了它什么都编不了
  • Homebrew(建议保持最新版)——macOS 上装依赖包的主渠道
  • CMake 3.8+——整个编译流程的调度器,版本低了配置阶段就报错

macOS 编译 librealsense:三步时间线 ⏳

这一节按顺序敲三组命令:装依赖、配置、编译,走完主流程。

第一步,装依赖。必装三项:

brew install cmake libusb pkg-config

libusb 是 USB 通信库,相机数据从 USB 口进来就靠它。Vulkan SDK 与 OpenSSL 属可选项,用到图形加速或加密校验时再装即可。

第二步,配置 CMake。构建逻辑由 CMakeLists.txt 驱动,参数保持推荐值即可:

mkdir build && cd build sudo xcode-select --reset cmake .. -DBUILD_EXAMPLES=true -DBUILD_WITH_OPENMP=false -DHWM_OVER_XU=false

第三步,编译:

make -j2

排错速查:两条对症命令

遇到 RealSense libusb 报错或 OpenSSL 缺失,先对号入座,再敲命令。

看到的报错根因一行命令解决
ld: library not found for -lusb-1.0Homebrew 把 libusb 放在 /usr/local/lib,链接器默认搜不到/bin/launchctl setenv LIBRARY_PATH /usr/local/lib
Could NOT find OpenSSLCMake 不知道 Homebrew 版 OpenSSL 的前缀路径export OPENSSL_ROOT_DIR=`brew --prefix openssl`

第二条只对当前终端会话生效,重开窗口后要重新执行。

让应用真正加载到库:改一行链接、拷两份 dylib

这一节解决"编译好了,应用却报找不到库"的最后一公里。

先说为什么必须做:librealsense2.dylib 内部写死了编译时的绝对路径(如 /usr/local/opt/libusb/...),一旦换机器或打进应用包,这个路径就不存在,运行直接失败。所以要做两件事。

其一,修链接路径:

install_name_tool -change /usr/local/opt/libusb/lib/libusb-1.0.0.dylib @rpath/libusb-1.0.0.dylib librealsense2.dylib

改完后引用变成 @rpath,由系统在运行时按应用内路径解析,不再绑定某台机器的目录。

其二,补齐依赖库:libusb-1.0.0.dyliblibrealsense2.dylib都复制进应用的 Frameworks 文件夹,随应用一起分发。

验收:三条勾选项确认落地 ✅

这一节用三个可勾选的检查项收尾,全勾上才算装好。

  • 设备被系统识别——运行 设备枚举工具,输出里能看到你的相机名
  • 示例程序出画面——跑 examples/ 下的 hello-realsense,窗口内出现实时画面
  • 深度数据流正常——深度帧随物体移动持续刷新,无卡顿黑屏

下一步

到这里,整套 RealSense SDK macOS 安装 流程走完。 下一步很具体:把 examples/ 里的示例逐个跑一遍,记下出画面时间与分辨率。 想深入再查 macOS 安装文档,别在配置上多花时间。

【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询