安装

支持平台

TQUIC基于Rust语言开发，目前支持Linux、MacOS、FreeBSD、iOS、Android平台，后续版本将支持其他平台。

环境准备

• rust 1.70+
• git 2.0+
• gcc 9.3+
• cmake 3.22+

编译

Linux

执行如下命令进行编译：

git clone https://github.com/tencent/tquic --recursive
cd tquic

cargo build --release --all

提示

参数--release指定cargo编译优化版本，编译结果位于./target/release/ 目录，而不是默认的./target/debug/目录。 参数--all指定cargo编译TQUIC协议库及示例工具

如果要启用C语言接口，请在cargo build命令后添加参数-F ffi：

cargo build --release -F ffi

MacOS

执行如下命令进行编译：

git clone https://github.com/tencent/tquic --recursive
cd tquic

cargo build --release --all

提示

参数--release指定cargo编译优化版本，编译结果位于./target/release/ 目录，而不是默认的./target/debug/目录。 参数--all指定cargo编译TQUIC协议库及示例工具

如果要启用C语言接口，请在cargo build命令后添加参数-F ffi：

cargo build --release -F ffi

FreeBSD

要编译FreeBSD平台的TQUIC库，你需要额外安装如下依赖：

sudo pkg install -y gmake

执行如下命令进行编译：

git clone https://github.com/tencent/tquic --recursive
cd tquic

cargo build --release --all

提示

参数--release指定cargo编译优化版本，编译结果位于./target/release/ 目录，而不是默认的./target/debug/目录。 参数--all指定cargo编译TQUIC协议库及示例工具

如果要启用C语言接口，请在cargo build命令后添加参数-F ffi：

cargo build --release -F ffi

Android

要编译Android平台的TQUIC库，你需要额外安装如下依赖：

• 安装Android NDK并设置环境变量ANDROID_NDK_HOME

# 将环境变量ANDROID_NDK_HOME设置为NDK安装路径
export ANDROID_NDK_HOME=/path/to/android-ndk

• 安装Rust Android工具链和cargo-ndk

# 安装Rust Android工具链
rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android

# 安装cargo-ndk以便简单编译Android库
cargo install cargo-ndk

执行如下命令进行编译：

git clone https://github.com/tencent/tquic --recursive
cd tquic

# 必须指定选项-t <architecture> 和-p <NDK version>
cargo ndk -t arm64-v8a -p 21 -- build --features ffi --release

提示

参数--release指定cargo编译优化版本，编译结果位于./target/release/ 目录，而不是默认的./target/debug/目录。 参数--features ffi指定cargo编译C接口库

iOS

要编译iOS平台的TQUIC库，你需要额外安装如下依赖：

• 安装Xcode和Xcode命令行工具

# 安装Xcode命令行工具 
xcode-select --install

• 安装Rust iOS工具链和cargo-lipo

# 安装Rust iOS工具链
rustup target add aarch64-apple-ios x86_64-apple-ios
 
# 安装cargo-lipo以便自动创建iOS通用库
cargo install cargo-lipo

执行如下命令进行编译：

git clone https://github.com/tencent/tquic --recursive
cd tquic

cargo lipo --features ffi --release

提示

参数--release指定cargo编译优化版本，编译结果位于./target/release/ 目录，而不是默认的./target/debug/目录。 参数--features ffi指定cargo编译C接口库

运行测试用例

执行如下命令来运行单元测试：

cargo test

进一步了解

• 如何使用示例客户端/服务端工具
• 如何使用TQUIC API

遇到问题?

• 请参考常见安装问题 。
• 您可以在GitHub issues提问寻求帮助。