OpenHarmony 6.1（API23）端侧 AI Native C++ 交叉编译工具链配置与验证手册

1. SDK 下载与完整性校验

使用官方华为云镜像源直接下载 OpenHarmony 6.1 (API 23) SDK，并通过 SHA256 校验确保安装包完整无损。

# 1. 创建工作目录并进入
mkdir -p /root/ohos-sdk-api23-6.1/linux && cd /root/ohos-sdk-api23-6.1/linux

# 2. 从华为云镜像拉取 6.1 Release SDK 安装包（-O 直接重命名，避免 URL 乱码）
wget -O ohos-sdk-windows_linux-public.tar.gz "https://repo.huaweicloud.com/openharmony/os/6.1-Release/ohos-sdk-windows_linux-public.tar.gz"

# 3. 校验文件哈希值
sha256sum ohos-sdk-windows_linux-public.tar.gz

预期哈希输出：
b833b75a64ee46bbd7880921abbb49b733ec5c8171b6684c9b524d57f624cee0 ohos-sdk-windows_linux-public.tar.gz

2. 核心部署流程

1. 解压工具包: 提取 Native 工具链.
   解压 SDK 内部的 Native 工具包至目标目录，自动生成包含 Clang 编译器的完整目录结构：

# 静默解压 Native 工具包至 ohos-sdk-linux 目录
unzip -q native-linux-x64-6.1.0.31-Release.zip -d ohos-sdk-linux

2. 工具链完整性校验: 验证 Clang 与 Sysroot.
   验证编译核心文件是否存在，并核查编译器目标架构与版本信息：

# 检查 Clang 与 Sysroot 依赖目录
ls ohos-sdk-linux/native/llvm/bin/clang
ls -d ohos-sdk-linux/native/sysroot

# 检查 Clang 编译器版本
ohos-sdk-linux/native/llvm/bin/clang --target=aarch64-linux-ohos --version

预期校验结果：

• 编译器版本：OHOS (dev) clang version 15.0.4
• 编译 Target：aarch64-unknown-linux-ohos

3. 配置永久环境变量: 写入 ~/.bashrc.
   配置 OHOS_SDK_HOME 环境变量，方便在任意目录下调用 Native 工具链：

# 1. 持久化配置写入 bashrc
echo 'export OHOS_SDK_HOME=/root/ohos-sdk-api23-6.1/linux/ohos-sdk-linux' >> ~/.bashrc

# 2. 刷新配置
source ~/.bashrc

# 3. 确认生效
echo $OHOS_SDK_HOME

3. 环境交叉编译实测验收

通过内联编译一段简单的 C 语言程序，测试 Clang 编译器与 OHOS Musl C 标准库的链接机制是否正常：

# 执行 AArch64 架构内联编译测试
echo 'int main(){return 0;}' | \
  $OHOS_SDK_HOME/native/llvm/bin/clang \
    --target=aarch64-linux-ohos \
    --sysroot=$OHOS_SDK_HOME/native/sysroot \
    -x c - -o /tmp/hello_ohos && file /tmp/hello_ohos

实测正确输出：

/tmp/hello_ohos: ELF 64-bit LSB pie executable, ARM aarch64, version 1 (SYSV), dynamically linked, interpreter /lib/ld-musl-aarch64.so.1, with debug_info, not stripped

验收结论： 成功生成适用于 OpenHarmony AArch64 架构的可执行文件，且动态链接器指向 OHOS 标准 musl-aarch64 库，证明 Linux Native 交叉编译环境已完全就绪。

附录：官方资源与版本适配