编译Rust crate tinyaudio for Android时出现链接错误

核心原因 #

aaudio是Android 8.0（API 26）引入的音频库，NDK中该库的位置和链接方式需正确配置；unwind库是NDK自带的栈展开组件，需确保构建脚本能正确定位。

具体解决步骤 #

1. 锁定目标Android API级别 #

tinyaudio的Android后端依赖aaudio，必须保证构建目标API级别≥26：

• 在项目Cargo.toml中添加配置：

  [package.metadata.android]
  min_sdk_version = 26
  target_sdk_version = 33
  

• 或使用cargo ndk构建时指定API级别：

  cargo ndk -t arm64-v8a -p 26 build --release
  

2. 验证NDK库文件存在性 #

进入NDK路径（例如$NDK_HOME/platforms/android-26/arch-arm64/usr/lib/），确认libaaudio.so和libunwind.so存在：

• 若NDK 22.1中缺失文件，建议切换到NDK 25.x及以上稳定版本（旧版NDK的库布局可能不兼容）
• 注意：不同架构（arm64-v8a、armeabi-v7a等）的库文件存放在对应arch-xxx目录下

3. 配置Rust构建脚本（build.rs） #

在项目build.rs中显式指定链接器的库搜索路径：

use std::env;
use std::path::Path;

fn main() {
    let ndk_home = env::var("NDK_HOME").expect("NDK_HOME must be set");
    let target_arch = env::var("CARGO_CFG_TARGET_ARCH").unwrap();
    
    let arch_dir = match target_arch.as_str() {
        "aarch64" => "arch-arm64",
        "arm" => "arch-arm",
        "x86_64" => "arch-x86_64",
        "x86" => "arch-x86",
        _ => panic!("Unsupported target architecture"),
    };
    
    let lib_path = Path::new(&ndk_home)
        .join("platforms")
        .join("android-26")
        .join(arch_dir)
        .join("usr")
        .join("lib");
    
    println!("cargo:rustc-link-search=native={}", lib_path.display());
    println!("cargo:rustc-link-lib=aaudio");
    println!("cargo:rustc-link-lib=unwind");
}

4. 确认环境变量生效 #

在PowerShell中验证环境变量路径正确性：

echo $env:NDK_HOME
echo $env:ANDROID_HOME

确保路径指向正确的NDK目录，且目录真实存在。使用cargo ndk时，优先识别ANDROID_NDK_HOME变量。

5. 清理缓存后重新构建 #

清理旧构建缓存避免残留问题：

cargo clean
cargo ndk -t arm64-v8a -p 26 build --release

额外排查点 #

• 若使用cross工具链交叉编译，需在Cross.toml中正确配置NDK路径和目标API级别
• 升级tinyaudio到最新稳定版，旧版本可能存在Android平台链接配置缺陷

内容的提问来源于stack exchange，提问作者Dan S.