Lyra多平台构建指南：Linux、Android、Mac、Windows全攻略

Lyra是一款极低比特率的语音压缩编解码器，专为高效语音传输设计。本指南将详细介绍如何在Linux、Android、Mac和Windows四大主流平台上构建Lyra项目，帮助开发者快速部署这一强大的语音压缩技术。

📋 准备工作

在开始构建前，请确保您的系统已安装以下工具：

• Bazel构建系统
• Git版本控制工具
• 对应平台的SDK（如Android NDK）

首先克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/lyra3/lyra
cd lyra

🐧 Linux平台构建

Linux是Lyra开发的主要平台，构建步骤如下：

1. 安装依赖：

sudo apt-get install build-essential python3

2. 执行构建：

bazel build -c opt lyra/cli_example:encoder_main
bazel build -c opt lyra/cli_example:decoder_main

3. 验证构建结果： 构建完成后，可在bazel-bin/lyra/cli_example/目录下找到encoder_main和decoder_main可执行文件。

🤖 Android平台构建

Lyra提供了完整的Android示例项目，构建步骤如下：

1. 配置Android环境： 确保已安装Android SDK和NDK，并设置ANDROID_HOME环境变量。

2. 执行构建：

bazel build -c opt lyra/android_example:lyra_android_example --config=android_arm64 --copt=-DBENCHMARK

3. 构建命令行工具（可选）：

bazel build -c opt lyra/cli_example:encoder_main --config=android_arm64
bazel build -c opt lyra/cli_example:decoder_main --config=android_arm64

Android示例项目位于lyra/android_example/目录，包含完整的Activity和资源文件。

🍎 Mac平台构建

Mac平台构建与Linux类似，但需要注意以下几点：

1. 安装Xcode命令行工具：

xcode-select --install

2. 使用Bazel构建：

bazel build -c opt lyra/cli_example:encoder_main
bazel build -c opt lyra/cli_example:decoder_main

🖥️ Windows平台构建

Windows平台需要使用Bazel的Windows版本和MSVC编译器：

1. 安装依赖：

• 安装Visual Studio 2019或更高版本
• 安装Bazel for Windows

2. 执行构建：

bazel build -c opt lyra/cli_example:encoder_main
bazel build -c opt lyra/cli_example:decoder_main

🧪 测试构建结果

构建完成后，建议使用项目提供的测试数据进行验证：

# 使用编码器编码测试音频
./bazel-bin/lyra/cli_example/encoder_main \
  --model_path=lyra/model_coeffs \
  --input_path=lyra/testdata/sample1_16kHz.wav \
  --output_path=encoded.lyra

# 使用解码器解码
./bazel-bin/lyra/cli_example/decoder_main \
  --model_path=lyra/model_coeffs \
  --input_path=encoded.lyra \
  --output_path=decoded.wav

测试数据位于lyra/testdata/目录，包含多种采样率的音频文件和编码示例。

📚 项目结构解析

Lyra项目主要包含以下关键目录：

• lyra/cli_example/：命令行工具示例
• lyra/android_example/：Android应用示例
• lyra/model_coeffs/：模型系数文件
• lyra/testing/：测试相关代码

构建配置文件：

• WORKSPACE：项目依赖配置
• BUILD：根目录构建规则
• toolchain/cc_toolchain_config.bzl：工具链配置

通过本指南，您可以在各种平台上轻松构建Lyra项目，体验其高效的语音压缩能力。如需深入了解Lyra的工作原理，请参考项目源代码和技术文档。