Skip to content

客户端编译

Android、iOS 和 HarmonyOS 使用动态库调用 XQUIC 特性。

要在每个平台上从源代码构建动态库,首先需要准备相应的编译工具链。

你可以使用位于根目录下的 xqc_build.sh 脚本来构建动态库。如果公共依赖项尚未准备好,请参考入门指南

注意事项

注意:在编译前需指定对应的平台(如 IOS、android、harmony)的构建工具链环境变量,或者直接修改 xqc_build.sh 文件中的 CMAKE_TOOLCHAIN_FILEHMOS_CMAKE_TOOLCHAIN

参数

xqc_build.sh 脚本的参数如下所示:

  • <build_dir>: 编译过程中生成的临时文件存放目录。
  • <artifact_dir>: 编译输出文件存放目录。
  • <ssl_path>: OpenSSL 库路径,默认值为 ${pwd}/third_party/boringssl(如果没有指定的话)。

Android

在编译前下载并设置环境变量 ANDROID_NDK,这是 Android 平台的构建工具链。

bash
sh xqc_build.sh android <build_dir> <artifact_dir> <ssl_path>

iOS

在编译前下载并设置环境变量 IOS_CMAKE_TOOLCHAIN,这是 iOS 平台的构建工具链。

bash
sh xqc_build.sh ios <build_dir> <artifact_dir> <ssl_path>

HarmonyOS

在编译前下载并设置环境变量 HMOS_CMAKE_PATHHMOS_CMAKE_TOOLCHAIN,这是 HarmonyOS 平台的构建工具链。

bash
sh xqc_build.sh harmony <build_dir> <artifact_dir> <ssl_path>