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-configlibusb 是 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.0 | Homebrew 把 libusb 放在 /usr/local/lib,链接器默认搜不到 | /bin/launchctl setenv LIBRARY_PATH /usr/local/lib |
Could NOT find OpenSSL | CMake 不知道 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.dylib与librealsense2.dylib都复制进应用的 Frameworks 文件夹,随应用一起分发。
验收:三条勾选项确认落地 ✅
这一节用三个可勾选的检查项收尾,全勾上才算装好。
- 设备被系统识别——运行 设备枚举工具,输出里能看到你的相机名
- 示例程序出画面——跑 examples/ 下的 hello-realsense,窗口内出现实时画面
- 深度数据流正常——深度帧随物体移动持续刷新,无卡顿黑屏
下一步
到这里,整套 RealSense SDK macOS 安装 流程走完。 下一步很具体:把 examples/ 里的示例逐个跑一遍,记下出画面时间与分辨率。 想深入再查 macOS 安装文档,别在配置上多花时间。
【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考