You need to enable JavaScript to run this app.
导航
macOS 集成常见问题
最近更新时间:2023.12.24 10:56:56首次发布时间:2023.09.27 10:40:35

RTC SDK 找不到依赖库问题

在集成 RTC SDK 时,需要将 SDK 包引入到 app 中。若 SDK 包文件未放在默认目录下,会出现 RTC SDK 找不到依赖库(如 libbytenn、libbytevc0 等)的问题,从而引发卡死等问题。

名词解释

  • @rpath (runpath): 是一个保存着一个或多个路径的变量,告诉连接器到什么路径找库。
  • @executable_path: 表示可执行程序所在的目录。
  • @loader_path: 表示每一个被加载的 binary(包括 App, dylib, framework, plugin 等)所在的目录。

SDK 包文件推荐路径

APP 默认的 @rpathapp/Contents/Frameworks,RTC SDK 的 @rpath 为当前目录,建议 SDK 包文件统一放在默认目录。

特殊情况处理

如果由于一些原因无法将 SDK 包文件统一放在默认目录下,而是需要放在自定义目录下,则应修改 @rpath 进行 SDK 依赖重定向,保证 RTC SDK 能正常找到依赖库。

示例

  1. Custom Folder 中存放了 RTC SDK 的相关文件以及依赖库,现在高亮的 VolcEngineRTC 需要依赖于 libAGFX.dylib, libbytenn.dylib, libbytevc0.dylib, libeffect.dylib 文件。

  2. 在该文件路径下打开终端,通过命令 otool -L VolcEngineRTC 查看该可执行文件的依赖库及库路径。

  3. 依次使用命令 install_name_tool -change @rpath/libAGFX.dylib @loader_path/../../../libAGFX.dylib VolcEngineRTC 将依赖库的 @rpath 路径改成以 @loader_path 为基础的相对路径。

如何在 macOS 上安装 Qt?

  1. 下载 Qt 在线安装程序

  2. 打开安装程序,输入 Qt 账号及密码。如果你没有账号,请前往 Qt 官网注册。

  3. 设置你的安装路径。

  4. 选择要安装的 Qt 版本,建议选择最新版本,等待安装完成。

  5. 设置 Qt 环境变量。在终端运行 vim ~/.bash_profile,然后将以下内容复制到文件开头,保存退出后运行 source ~/.bash_profile 使环境变量生效。

    export QTDIR=/Users/Username/QT/6.5.2/macos # 设置成自己的安装路径
    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$QTDIR/lib
    export PATH=$PATH:$QTDIR/bin
    

    你可以在终端中运行 qmake --version 检查安装情况,如果显示之前安装的 Qt 版本,则表示安装成功。