oak-editor/docs/zh/build.md

构建指南

本文档介绍如何从源码构建 Oak Video Editor。

依赖

• CMake 3.20+
• Ninja（推荐）
• Qt 6（含私有头文件）
• FFmpeg 开发库
• OpenImageIO
• OpenColorIO（2.x）
• OpenEXR
• Expat
• PortAudio
• OpenGL 头文件
• XKB common（Linux）

Linux（Ubuntu/Debian）

安装依赖：

sudo apt-get update
sudo apt-get install -y \
  ninja-build pkg-config \
  qt6-base-dev qt6-base-dev-tools qt6-base-private-dev qt6-tools-dev qt6-tools-dev-tools \
  libavcodec-dev libavformat-dev libavfilter-dev libavutil-dev libswscale-dev libswresample-dev \
  libopencolorio-dev libopenimageio-dev libopenexr-dev libexpat1-dev \
  portaudio19-dev libgl1-mesa-dev libxkbcommon-dev

配置并构建：

cmake -S . -B build -G Ninja -DBUILD_TESTS=ON -DBUILD_QT6=ON
cmake --build build --config Release

运行测试：

ctest --test-dir build --output-on-failure -C Release

macOS（非官方支持）

说明：macOS 非官方支持，目前只做 CI 自动化测试，不做人工测试。

安装依赖：

brew update
brew install ninja pkg-config qt@6 ffmpeg openimageio opencolorio openexr portaudio expat

构建 OpenTimelineIO（可选，如需 OTIO 支持）：

git clone --depth 1 --branch v0.16.0 https://github.com/PixarAnimationStudios/OpenTimelineIO.git
cmake -S OpenTimelineIO -B OpenTimelineIO/build -G Ninja \
  -DOTIO_SHARED_LIBS=ON \
  -DOTIO_PYTHON_BINDINGS=OFF \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_INSTALL_PREFIX="${PWD}/otio-install"
cmake --build OpenTimelineIO/build
cmake --install OpenTimelineIO/build

配置并构建：

export PATH="$(brew --prefix qt@6)/bin:$PATH"
export CMAKE_PREFIX_PATH="$(brew --prefix qt@6)"
export OTIO_LOCATION="${PWD}/otio-install"
export OCIO_LOCATION="$(brew --prefix opencolorio)"

cmake -S . -B build -G Ninja -DBUILD_TESTS=ON -DBUILD_QT6=ON \
  -DOTIO_LOCATION="${OTIO_LOCATION}" \
  -DOCIO_LOCATION="${OCIO_LOCATION}"
cmake --build build --config Release

运行测试：

ctest --test-dir build --output-on-failure -C Release

Windows

Qt 6 请使用系统安装器或 CI action。其余依赖建议用 vcpkg。

choco install -y ninja
$env:VCPKG_ROOT = "C:\vcpkg"
& "$env:VCPKG_ROOT\vcpkg.exe" install ffmpeg openimageio opencolorio openexr expat portaudio --triplet x64-windows

配置并构建：

cmake -S . -B build -G Ninja `
  -DBUILD_TESTS=ON `
  -DBUILD_QT6=ON `
  -DCMAKE_BUILD_TYPE=Release `
  -DCMAKE_TOOLCHAIN_FILE="$env:VCPKG_ROOT\scripts\buildsystems\vcpkg.cmake" `
  -DCMAKE_PREFIX_PATH="$env:Qt6_DIR"
cmake --build build --config Release

运行测试：

ctest --test-dir build --output-on-failure -C Release