摘要：本文详细介绍了如何将高性能 GPU 加速视频/图像渲染库 libplacebo 适配到 鸿蒙PC 平台。文章将系统性地讲解如何利用 lycium_plusplus 构建框架，处理 Meson 构建系统的交叉编译流程，展示如何处理 fast_float 依赖管理、Meson 选项映射、CRLF 换行符问题以及 HNP 包生成的完整实践。

本文是软件鸿蒙化迁移实践系列文章之一，专注于 C/C++ 原生库的鸿蒙 PC 适配，为开发者提供完整的迁移指南。

AtomGit仓库地址：https://atomgit.com/weixin_62765017/ohos_libplacebo

欢迎加入开源鸿蒙PC社区：https://harmonypc.csdn.net/

项目信息说明

项目	说明
名称	libplacebo
开源协议	LGPL-2.1-or-later
源码版本	7.362
目标平台	鸿蒙 PC
依赖项	Meson, Ninja, fast_float
操作系统平台	WSL Ubuntu 24.04

一、背景介绍

1.0 功能与效果

libplacebo 在本实践中的预期能力如下：

功能：提供高性能的可重用 GPU 加速渲染原语，支持视频/图像的色彩空间转换、缩放、去噪、色调映射等核心功能。

效果：在鸿蒙 PC 上提供高效的 GPU 渲染能力，便于在鸿蒙应用开发中实现视频播放器、图像处理工具、媒体渲染引擎等场景的高性能渲染功能。

1.1 什么是 鸿蒙PC HNP 生态

HNP（Harmony Native Package）是 鸿蒙PC 的原生包格式，lycium 是增强型构建框架，支持自动下载源码、交叉编译（arm64-v8a、armeabi-v7a）、一键生成 HNP 包以及开源声明聚合（OAT.xml）。C/C++ 原生库的适配是鸿蒙系统生态建设中的重要一环。

1.2 为什么适配 C/C++ 原生库会有难度

常见挑战包括：

• 构建系统差异：libplacebo 使用 Meson + Ninja 构建系统，需要配置交叉编译工具链（aarch64-linux-ohos-clang/clang++）。
• Meson 选项映射：Meson 选项名称可能与预期不符，需要查看 meson_options.txt 确认正确选项。
• fast_float 依赖：libplacebo 需要 fast_float 头文件库进行快速浮点数解析，需要手动下载并放置到正确位置。
• 图形后端****兼容性：Vulkan、OpenGL、D3D11 等图形后端在鸿蒙系统上可能不支持，需要禁用。
• 头文件库管理：fast_float 是 header-only 库，需要完整的目录结构才能通过编译。
• 构建缓存问题：lycium 使用 hpk_build.csv 跟踪构建状态，需要正确清理缓存才能重新构建。
• CRLF** 换行符**：Windows 环境下创建的文件带有 CRLF 换行符，需要转换为 LF。

1.3 libplacebo 简介

libplacebo 是一个由 Niklas Haas 开发的高性能 GPU 加速视频/图像渲染库。其主要特点包括：

• GPU** 加速**：支持 Vulkan、OpenGL、D3D11 等多种 GPU 后端。
• 高质量渲染：提供先进的色彩空间转换、缩放算法、色调映射等功能。
• 模块化设计：轻量且高效，可嵌入到各种媒体播放器中。
• 跨平台特性：原生支持 Windows、macOS、Linux，本次适配扩展到 鸿蒙PC 平台。
• 开源地址：
  • GitHub：https://github.com/haasn/libplacebo
  • AtomGit：https://atomgit.com/weixin_62765017/ohos_libplacebo

二、环境准备

2.0 系统要求

• 开发环境：Ubuntu 24.04（推荐 WSL 2）
• 核心工具：Meson（v0.57+）、Ninja、Python3、Git
• 构建框架：lycium_plusplus
• 鸿蒙 SDK：鸿蒙PC SDK（提供交叉编译工具链 aarch64-linux-ohos-clang/clang++）
• 目标架构：arm64-v8a（AArch64）

2.0.1 扩展阅读与参考教程

下方汇总展示了多位老师在鸿蒙 鸿蒙PC 适配方面的高质量教程。若在前提准备（环境、工具链、框架）部分还有不清楚的地方，可参考这些文章进一步学习。 以下资源不分先后顺序，均具有参考价值。

资源类型	描述	链接
三方库交叉编译环境（Ubuntu）	在 Ubuntu 中搭建鸿蒙PC 三方库交叉编译构建开发环境	👉 点击查看
三方库交叉编译环境（macOS）	在 macOS 中搭建鸿蒙PC 三方库交叉编译开发环境	👉 点击查看
基础环境搭建	Windows 10 上安装和使用 WSL 2、安装 Ubuntu 24 详细指南	👉 点击查看
Mac 移植指南	鸿蒙PC命令行适配指南（Mac 版）	👉 点击查看
Win 移植指南	鸿蒙PC 生态三方软件移植：开发环境搭建及三方库移植指南	👉 点击查看
全流程适配指南	鸿蒙PC Linux 命令行工具适配实战：基于 Cursor × WSL 的 tree 2.2.1 交叉编译与 HNP 打包全流程指南	👉 点击查看
官方构建文档	新脚手架：社区维护的鸿蒙PC 生态命令行工具构建框架 lycium_plusplus（原 build 仓库为旧方式，请以本仓库为准）	👉 点击查看

2.1 lycium_plusplus 框架

lycium_plusplus 是本次适配工作的核心工具，主要用于统一管理各类第三方库的构建流程，通过规范编译、依赖与打包逻辑，实现三方库在目标平台上高效、稳定地编译与集成，是整个适配环节中保障构建一致性与可维护性的关键支撑。

# 克隆 lycium_plusplus 项目
git clone https://atomgit.com/OpenHarmonyPCDeveloper/lycium_plusplus.git
cd lycium_plusplus

2.2 Meson 与交叉编译环境

由于 libplacebo 是 C/C++ 项目，需要 Meson、Ninja 和 鸿蒙PC SDK 提供的交叉编译工具链。

# 安装 Meson 和 Ninja
sudo apt-get install -y meson ninja-build

# 验证安装
meson --version
ninja --version

# 配置 鸿蒙PC SDK 环境变量
export OHOS_SDK=/home/weishuo/ohos-sdk/linux

三、实战：以 libplacebo 为例的适配步骤

3.1 创建项目目录结构

在 lycium_plusplus/thirdparty/ 目录下为 libplacebo 创建专属目录。

cd lycium_plusplus/thirdparty
mkdir -p libplacebo
cd libplacebo

3.2 创建 HPKBUILD 文件

HPKBUILD 作为 lycium 框架的核心构建脚本，完整定义了三方库的元信息配置及下载、编译、打包等全流程构建逻辑。

#!/bin/bash

pkgname=libplacebo
pkgver=7.362
pkgrel=0
pkgdesc="Reusable library for GPU-accelerated video/image rendering primitives"
url="https://code.videolan.org/videolan/libplacebo"
archs=("arm64-v8a")
license=("LGPL-2.1-or-later")
depends=()
makedepends=("meson" "ninja")

autounpack=false
downloadpackage=false

buildtools="meson"

srcpath="${LYCIUM_ROOT}/../Projects/${pkgname}"
builddir="${pkgname}-${pkgver}"

prepare() {
    if [ -d "$srcpath" ]; then
        echo "Using local source from: $srcpath"
        mkdir -p "$builddir"

        cp -rf "$srcpath"/* "$builddir/"
        cp -rf "$srcpath"/.git* "$builddir/" 2>/dev/null || true

        if [ -f "$builddir/.gitmodules" ]; then
            cd "$builddir"
            git submodule update --init --recursive 2>/dev/null || true
            cd ..
        fi

        find "$builddir" -name "*.bak" -type f -delete 2>/dev/null || true
        find "$builddir" -name "*:Zone.Identifier" -type f -delete 2>/dev/null || true

        echo "Prepare completed in: $builddir"
    else
        echo "ERROR: Source not found at $srcpath"
        exit 1
    fi
}

build() {
    cd "$builddir"

    export CC="${OHOS_SDK}/native/llvm/bin/aarch64-linux-ohos-clang"
    export CXX="${OHOS_SDK}/native/llvm/bin/aarch64-linux-ohos-clang++"
    export AR="${OHOS_SDK}/native/llvm/bin/llvm-ar"
    export RANLIB="${OHOS_SDK}/native/llvm/bin/llvm-ranlib"
    export STRIP="${OHOS_SDK}/native/llvm/bin/llvm-strip"

    export CFLAGS="--target=aarch64-linux-ohos --sysroot=${OHOS_SDK}/native/sysroot -O2 -fPIC"
    export CXXFLAGS="--target=aarch64-linux-ohos --sysroot=${OHOS_SDK}/native/sysroot -O2 -fPIC"
    export LDFLAGS="--target=aarch64-linux-ohos --sysroot=${OHOS_SDK}/native/sysroot"

    cat > ohos-cross.ini << EOF
[binaries]
c = '${OHOS_SDK}/native/llvm/bin/aarch64-linux-ohos-clang'
cpp = '${OHOS_SDK}/native/llvm/bin/aarch64-linux-ohos-clang++'
ar = '${OHOS_SDK}/native/llvm/bin/llvm-ar'
strip = '${OHOS_SDK}/native/llvm/bin/llvm-strip'
pkgconfig = 'pkg-config'

[built-in options]
c_args = ['--target=aarch64-linux-ohos', '--sysroot=${OHOS_SDK}/native/sysroot', '-O2', '-fPIC']
cpp_args = ['--target=aarch64-linux-ohos', '--sysroot=${OHOS_SDK}/native/sysroot', '-O2', '-fPIC']
c_link_args = ['--target=aarch64-linux-ohos', '--sysroot=${OHOS_SDK}/native/sysroot']
cpp_link_args = ['--target=aarch64-linux-ohos', '--sysroot=${OHOS_SDK}/native/sysroot']

[host_machine]
system = 'linux'
cpu_family = 'aarch64'
cpu = 'aarch64'
endian = 'little'
EOF

    meson setup ohos-build \
        --cross-file ohos-cross.ini \
        --prefix=/usr \
        --buildtype=release \
        -D vulkan=disabled \
        -D opengl=disabled \
        -D d3d11=disabled \
        -D glslang=disabled \
        -D shaderc=disabled \
        -D lcms=disabled \
        -D dovi=disabled \
        -D libdovi=disabled \
        -D demos=false \
        -D tests=false \
        -D bench=false \
        > "$buildlog" 2>&1

    ret=$?
    if [ $ret -ne 0 ]; then
        echo "Meson configuration failed!"
        cat "$buildlog" >&2
        cd "$OLDPWD"
        return $ret
    fi

    ninja -C ohos-build >> "$buildlog" 2>&1
    ret=$?

    if [ $ret -ne 0 ]; then
        echo "Build failed!"
        cat "$buildlog" >&2
        cd "$OLDPWD"
        return $ret
    fi

    echo "Build completed successfully!"
    cd "$OLDPWD"
}

package() {
    cd "$builddir"

    : ${destdir:=${LYCIUM_ROOT}/usr/${pkgname}/${ARCH}}

    mkdir -p "${destdir}/usr/lib"
    mkdir -p "${destdir}/usr/include"
    mkdir -p "${destdir}/usr/lib/pkgconfig"

    cp -f ohos-build/src/libplacebo.so* "${destdir}/usr/lib/" 2>/dev/null || true
    cp -rf src/include/libplacebo "${destdir}/usr/include/" 2>/dev/null || true

    if [ -f ohos-build/meson-private/libplacebo.pc ]; then
        cp -f ohos-build/meson-private/libplacebo.pc "${destdir}/usr/lib/pkgconfig/"
    fi

    echo "Package completed!"
    cd "$OLDPWD"
}

check() {
    : ${destdir:=${LYCIUM_ROOT}/usr/${pkgname}/${ARCH}}

    if [ ! -f "${destdir}/usr/lib/libplacebo.so" ] && [ ! -f "${destdir}/usr/lib/libplacebo.a" ]; then
        echo "ERROR: libplacebo library not found!"
        exit 1
    fi

    if [ ! -d "${destdir}/usr/include/libplacebo" ]; then
        echo "ERROR: libplacebo header not found!"
        exit 1
    fi

    echo "Check passed!"
}

archive() {
    export HNP_TOOL="${HNP_TOOL:-${OHOS_SDK}/toolchains/hnpcli}"

    mkdir -p ${LYCIUM_ROOT}/output/$ARCH

    pushd ${LYCIUM_ROOT}/usr/${pkgname}/${ARCH} > /dev/null 2>&1
    tar -zcf ${LYCIUM_ROOT}/output/$ARCH/${pkgname}_${pkgver}.tar.gz .
    echo "Archive completed: ${LYCIUM_ROOT}/output/$ARCH/${pkgname}_${pkgver}.tar.gz"
    popd > /dev/null 2>&1

    if [ -f "${HNP_TOOL}" ]; then
        cp ${LYCIUM_ROOT}/../thirdparty/${pkgname}/hnp.json ${LYCIUM_ROOT}/usr/${pkgname}/${ARCH}/
        ${HNP_TOOL} pack \
            -i ${LYCIUM_ROOT}/usr/${pkgname}/${ARCH} \
            -o ${LYCIUM_ROOT}/output/$ARCH/
        echo "Archive completed: ${LYCIUM_ROOT}/output/$ARCH/${pkgname}.hnp"
    else
        echo "Warning: hnpcli not found at ${HNP_TOOL}, skipping HNP generation"
    fi
}

cleanbuild() {
    echo "Cleaning build artifacts for ${pkgname}..."

    rm -rf "${LYCIUM_ROOT}/../thirdparty/${pkgname}/${pkgname}-${pkgver}"
    rm -rf "${LYCIUM_ROOT}/output/${pkgname}"*
    rm -rf "${LYCIUM_ROOT}/usr/${pkgname}"

    echo "Clean completed"
}

3.3 创建 hnp.json（包元数据）

hnp.json 文件用于描述 HNP 包的元信息，类似于 package.json。

{
    "type": "hnp-config",
    "name": "libplacebo",
    "version": "7.362",
    "description": "Reusable library for GPU-accelerated video/image rendering primitives",
    "license": "LGPL-2.1-or-later",
    "arch": "arm64-v8a",
    "install": {
        "lib": ["usr/lib/libplacebo.so*"],
        "include": ["usr/include/libplacebo"]
    }
}

3.4 创建 README.OpenSource（开源声明）

为了满足开源合规性，需要提供 README.OpenSource 文件来声明许可证和依赖库信息。

[
    {
        "Name": "libplacebo",
        "License": "LGPL-2.1-or-later",
        "License File": "https://github.com/haasn/libplacebo/blob/master/LICENSE",
        "Version Number": "7.362",
        "Owner": "your-email@example.com",
        "Upstream URL": "https://github.com/haasn/libplacebo/archive/refs/tags/v7.362.tar.gz",
        "Description": "Reusable library for GPU-accelerated video/image rendering primitives, with a focus on vulkan"
    },
    {
        "Name": "fast_float",
        "License": "Apache-2.0 OR MIT",
        "License File": "https://github.com/fastfloat/fast_float/blob/main/LICENSE-MIT",
        "Version Number": "6.1.0",
        "Owner": "your-email@example.com",
        "Upstream URL": "https://github.com/fastfloat/fast_float/archive/refs/tags/v6.1.0.tar.gz",
        "Description": "Fast and exact implementation of the C++ from_chars functions for float and double types."
    },
    {
        "Name": "spirv-headers",
        "License": "MIT",
        "License File": "https://github.com/KhronosGroup/SPIRV-Headers/blob/main/LICENSE",
        "Version Number": "1.6.1",
        "Owner": "your-email@example.com",
        "Upstream URL": "https://github.com/KhronosGroup/SPIRV-Headers/archive/refs/tags/sdk-1.3.268.0.tar.gz",
        "Description": "Header files for the SPIR-V intermediate representation."
    },
    {
        "Name": "vulkan-headers",
        "License": "MIT",
        "License File": "https://github.com/KhronosGroup/Vulkan-Headers/blob/main/LICENSE.md",
        "Version Number": "1.3.268",
        "Owner": "your-email@example.com",
        "Upstream URL": "https://github.com/KhronosGroup/Vulkan-Headers/archive/refs/tags/sdk-1.3.268.0.tar.gz",
        "Description": "Vulkan Header files and API registry."
    }
]

3.5 创建 HPKCHECK 检查脚本

HPKCHECK 是 lycium 框架的构建检查脚本，用于在编译前验证环境是否满足构建要求。

#!/bin/bash
# HPKCHECK for libplacebo
# 检查 libplacebo 构建产物

echo "=== Checking libplacebo build artifacts ==="

# 检查库文件
if [ -f "$1/usr/lib/libplacebo.so" ]; then
    echo "✓ Shared library found: libplacebo.so"
    file "$1/usr/lib/libplacebo.so"
elif [ -f "$1/usr/lib/libplacebo.a" ]; then
    echo "✓ Static library found: libplacebo.a"
    file "$1/usr/lib/libplacebo.a"
else
    echo "✗ ERROR: No libplacebo library found!"
    exit 1
fi

# 检查头文件
if [ -d "$1/usr/include/libplacebo" ]; then
    echo "✓ Header directory found: libplacebo/"
    ls "$1/usr/include/libplacebo/" | head -10
else
    echo "✗ ERROR: Header directory not found!"
    exit 1
fi

# 检查 pkg-config 文件
if [ -f "$1/usr/lib/pkgconfig/libplacebo.pc" ]; then
    echo "✓ pkg-config file found"
else
    echo "⚠ Warning: pkg-config file not found"
fi

echo "=== Check completed ==="

四、编译流程与完整示例

4.1 环境准备

配置用于前置环境检查与变量设置，通过指定 鸿蒙PC SDK 路径、验证 Meson 环境，为 lycium_plusplus 构建三方库提供基础运行环境。

# 1. 确保 鸿蒙PC SDK 已安装
export OHOS_SDK=/home/weishuo/ohos-sdk/linux

# 2. 确保 Meson 和 Ninja 已安装
meson --version
ninja --version

4.2 创建项目结构并执行编译

通过目录操作、脚本创建、清理缓存、执行构建指令，完成 lycium_plusplus 中 libplacebo 三方库的从零构建全流程。

cd lycium_plusplus/thirdparty
mkdir -p libplacebo
cd libplacebo
# 创建 HPKBUILD 文件（内容见第三章）
vim HPKBUILD

cd ../../lycium
# 清理历史构建记录（可选，但推荐）
rm -f usr/hpk_build.csv
rm -rf ../thirdparty/libplacebo/libplacebo-7.362
rm -rf output/*/libplacebo*

# 开始构建
./build.sh libplacebo

4.3 构建成功输出示例

4.4 验证产物

构建成功后，编译产物会统一输出至 output 目录，包含标准 tar 压缩包与鸿蒙专用 hnp 格式包。

output/arm64-v8a/
├── libplacebo_7.362.tar.gz  (739K)
└── libplacebo.hnp           (772K)

五、鸿蒙PC 上验证结果（测试）

解压并进入目录，查看库文件结构。

# 解压 libplacebo 编译产物压缩包
tar -zxf libplacebo_7.362.tar.gz

# 进入库文件所在目录 usr/lib
cd usr/lib

# 查看 libplacebo.so 文件的架构、格式信息（验证鸿蒙 arm64 编译结果）
file libplacebo.so

od -N 4 用于读取文件前 4 个字节，通常是 ELF 文件的魔数，用于识别系统架构

libplacebo 鸿蒙适配成功：已生成符合鸿蒙 arm64 架构的 ELF 共享库，核心编译产物完整有效

# 查看详细的文件大小与权限信息
ls -lh

# 查看 libplacebo.so 的二进制前 4 个字节（Magic Number），快速验证架构
od -N 4 libplacebo.so

六、常见问题与解决方案（FAQ）

Q1：构建时报错 “ERROR: Unknown options: chelsea, cuda, docs”？

A：这是因为 Meson 选项名称不正确。需要查看 meson_options.txt 确认正确的选项名称：

# 查看可用的 Meson 选项
cat meson_options.txt

# 正确的选项应该是：
# -D glslang=disabled \
# -D shaderc=disabled \
# -D lcms=disabled \
# -D dovi=disabled \
# -D libdovi=disabled \
# -D demos=false \
# -D tests=false \
# -D bench=false \

然后清理缓存并重新构建：

# 清理构建缓存
rm -f lycium/usr/hpk_build.csv
rm -rf thirdparty/libplacebo/libplacebo-*
rm -rf lycium/usr/libplacebo

# 重新构建
./lycium/build.sh libplacebo

Q2：构建时报错 “static assertion failed: <fast_float/fast_float.h> is required”？

A：这是因为缺少 fast_float 头文件库。需要从 GitHub 下载并放置到正确位置：

# 克隆 fast_float 仓库
cd /home/weishuo/lycium_plusplus/Projects/libplacebo
git clone --depth 1 https://github.com/fastfloat/fast_float.git 3rdparty/fast_float

# 确保头文件在正确位置
ls 3rdparty/fast_float/include/fast_float/fast_float.h

fast_float 是 header-only 库，只需要头文件，不需要编译。

Q3：修改 HPKBUILD 后 lycium 直接跳过构建？

A：这是 lycium 的构建缓存机制导致的。lycium 使用 hpk_build.csv 文件记录构建状态，如果存在记录则会跳过构建。解决方案是删除缓存文件：

# 删除构建状态缓存
rm -f lycium/usr/hpk_build.csv

# 同时清理旧产物
rm -rf thirdparty/libplacebo/libplacebo-*
rm -rf lycium/usr/libplacebo
rm -rf lycium/output/*/*libplacebo*

# 重新构建
./lycium/build.sh libplacebo

Q4：构建时报错 $‘\r’: command not found？

A：这是 Windows 换行符（CRLF）导致的问题。在 WSL + Windows 共享目录环境下，使用某些工具创建的文件会自动带有 CRLF 换行符。解决方案是使用 Python 脚本在 Linux 环境中转换：

# 创建修复脚本 fix_crlf.py
cat > fix_crlf.py << 'EOF'
#!/usr/bin/env python3
import os

files = ["HPKBUILD", "HPKCHECK", "hnp.json", "OAT.xml"]

script_dir = os.path.dirname(os.path.abspath(__file__))

for filename in files:
    filepath = os.path.join(script_dir, filename)
    
    if not os.path.exists(filepath):
        print(f"Skip (not found): {filename}")
        continue
    
    with open(filepath, "rb") as f:
        content = f.read()
    
    if b"\r\n" in content:
        content = content.replace(b"\r\n", b"\n")
        
        with open(filepath, "wb") as f:
            f.write(content)
        
        print(f"Fixed: {filename}")

print("All files fixed!")
EOF

# 执行修复
python3 fix_crlf.py

Q5：package() 函数中 cp 命令报错 “Permission denied”？

A：这是因为使用了错误的目标路径。应该使用 lycium 标准的 ${destdir} 变量，而不是硬编码的路径：

# 错误写法
cp libplacebo.so /usr/lib/

# 正确写法
: ${destdir:=${LYCIUM_ROOT}/usr/${pkgname}/${ARCH}}
mkdir -p "${destdir}/usr/lib"
cp -f ohos-build/src/libplacebo.so* "${destdir}/usr/lib/"

${destdir} 会自动解析为正确的产物目录，如 /home/weishuo/lycium_plusplus/lycium/usr/libplacebo/arm64-v8a

Q6：hnp.json 解析报错 “get type info in cfg unsuccess”？

A：这是因为 hnp.json 缺少必需字段。需要添加 “type”: “hnp-config” 和 “arch” 字段：

{
    "type": "hnp-config",
    "name": "libplacebo",
    "version": "7.362",
    "description": "Reusable library for GPU-accelerated video/image rendering primitives",
    "license": "LGPL-2.1-or-later",
    "arch": "arm64-v8a",
    "install": {
        "lib": ["usr/lib/libplacebo.so*"],
        "include": ["usr/include/libplacebo"]
    }
}

关键字段：

• type: 必须是 “hnp-config”
• arch: 必须指定目标架构，如 “arm64-v8a”
• install: 指定安装的文件路径

Q7：为什么 meson install 没有生效？

A：Meson 的 DESTDIR 在某些交叉编译场景下可能不生效。可靠的解决方案是在 package() 函数中手动复制产物：

package() {
    : ${destdir:=${LYCIUM_ROOT}/usr/${pkgname}/${ARCH}}
    
    # 手动复制库文件
    mkdir -p "${destdir}/usr/lib"
    cp -f ohos-build/src/libplacebo.so* "${destdir}/usr/lib/"
    
    # 手动复制头文件
    mkdir -p "${destdir}/usr/include"
    cp -rf src/include/libplacebo "${destdir}/usr/include/"
    
    # 手动复制 pkg-config 文件
    mkdir -p "${destdir}/usr/lib/pkgconfig"
    cp -f ohos-build/meson-private/libplacebo.pc "${destdir}/usr/lib/pkgconfig/"
}

这样可以确保产物被正确安装到 lycium 的产物目录。

Q8：如何验证 libplacebo 是否正确编译为 arm64 架构？

A：使用 file 命令检查生成的 .so 文件：

# 检查库文件架构
file lycium/usr/libplacebo/arm64-v8a/usr/lib/libplacebo.so.362

# 正确输出应该显示：
# ELF 64-bit LSB shared object, ARM aarch64, version 1 (SYSV), dynamically linked

如果显示 x86_64 或其他架构，说明交叉编译配置有误，需要检查 ohos-cross.ini 文件。

七、技术总结

本次成功将 libplacebo 适配至 鸿蒙PC 平台，形成了一套可复用的 Meson 构建系统 C/C++ 库鸿蒙移植范式。核心要点如下：

• Meson 交叉编译模板：建立了 Meson + Ninja 的 HPKBUILD 配置规范，创建 ohos-cross.ini 交叉编译配置文件
• 关键问题解决：通过查看 meson_options.txt 确认正确选项、下载 fast_float 头文件库满足编译依赖、禁用不支持的图形后端
• 依赖管理：fast_float 作为 header-only 库，需要完整的目录结构才能通过编译
• 产物安装：由于 meson install 的 DESTDIR 不生效，采用手动复制产物的可靠方案
• 通用适配能力：方案可直接迁移至其他使用 Meson 构建的多媒体处理库的鸿蒙移植

八、结语

本次实践成功将 libplacebo 移植至 鸿蒙PC 平台，验证了 lycium_plusplus 框架对 Meson 构建系统项目交叉编译的支撑能力。通过规范 HPKBUILD 构建流程、创建 Meson 交叉编译配置、管理 fast_float 依赖、禁用不支持的图形后端、手动复制编译产物等关键措施，有效解决了适配中的兼容性与构建问题，为同类开源项目迁移至鸿蒙生态提供了可复用的实践参考，助力鸿蒙原生多媒体工具生态的完善与发展。

提示：本文基于 libplacebo 7.362 版本进行适配。不同版本的依赖和构建脚本可能有所差异，建议在适配前先熟悉目标项目的 meson.build 和 meson_options.txt 配置文件。