Mike-Solar
66d761b4b7
- app/ no longer includes engine C++ headers nor holds engine C++ types: engine access goes through the oakengine C ABI plus C++ wrappers (oakutil/oaknode.h, oakutil/oakvideo.h) and app-local mirror types (tooltypes, trackreferencehandle, timelinecommonapp, keyframetypes, subtitleapp, serializedlayoutinfoapp, nodevaluehandle, sliderdisplaytypeapp) - engine: new C ABI functions for block/track/clip/transition navigation and predicates, links, caches, waveform/playback, disk folder, sequence_track_list, node_free, footage_is_valid, block_get_track, get_brush; loadotio/saveotio ported to the current engine API - OTIO is now a required dependency: CI and CD build it on every platform, FindOpenTimelineIO fixed for OTIO 0.16/0.19 (the old deps include requirement silently disabled OTIO everywhere), runtime libraries are bundled into packages and copied next to macOS binaries (oak_copy_otio_runtime) - fix ProjectViewModel drag&drop mime read/write size mismatch (segfault) - unify color label naming (k_olive -> "Oak") in the app-side mirror - docs: OTIO required, FFmpeg minimum corrected to 6.0 (en/zh) - gtest suite: 1925 passed, 0 failed
262 lines
5.1 KiB
Markdown
262 lines
5.1 KiB
Markdown
# macOS Build Guide
|
|
|
|
This document describes how to build Oak Video Editor from source on macOS.
|
|
|
|
For the Chinese version, see [`build-macos-zh.md`](zh/build_macos-zh.md).
|
|
|
|
---
|
|
|
|
## Prerequisites
|
|
|
|
- macOS 12.0 (Monterey) or later
|
|
- [Homebrew](https://brew.sh/) package manager
|
|
- Xcode Command Line Tools
|
|
|
|
### Install Xcode Command Line Tools
|
|
|
|
```bash
|
|
xcode-select --install
|
|
```
|
|
|
|
---
|
|
|
|
## Install Dependencies
|
|
|
|
### 1. Install Homebrew (if not already installed)
|
|
|
|
```bash
|
|
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
|
```
|
|
|
|
### 2. Install Build Tools and Libraries
|
|
|
|
```bash
|
|
brew update
|
|
brew install cmake ninja pkg-config
|
|
```
|
|
|
|
### 3. Install Qt 6
|
|
|
|
```bash
|
|
brew install qt@6
|
|
```
|
|
|
|
Add Qt 6 to your PATH (you may want to add this to your `~/.zshrc`):
|
|
|
|
```bash
|
|
echo 'export PATH="/opt/homebrew/opt/qt@6/bin:$PATH"' >> ~/.zshrc
|
|
source ~/.zshrc
|
|
```
|
|
|
|
### 4. Install FFmpeg
|
|
|
|
```bash
|
|
brew install ffmpeg
|
|
```
|
|
|
|
### 5. Install Image/Color Libraries
|
|
|
|
```bash
|
|
brew install openimageio opencolorio openexr
|
|
```
|
|
|
|
### 6. Install Audio and XML Libraries
|
|
|
|
```bash
|
|
brew install portaudio expat
|
|
```
|
|
|
|
### 7. Install Vulkan Backend Dependencies (Optional)
|
|
|
|
Only needed for the Vulkan render backend. Oak builds the OpenGL backend regardless and falls back to it at runtime if Vulkan is unavailable:
|
|
|
|
```bash
|
|
brew install molten-vk vulkan-headers vulkan-loader
|
|
```
|
|
|
|
Point CMake at the loader so `find_package(Vulkan)` succeeds (add to `~/.zshrc` if you build regularly):
|
|
|
|
```bash
|
|
export VULKAN_SDK="$(brew --prefix vulkan-loader)"
|
|
```
|
|
|
|
### 8. Install Test Framework (Optional)
|
|
|
|
Only needed if you plan to build and run tests:
|
|
|
|
```bash
|
|
brew install googletest
|
|
```
|
|
|
|
---
|
|
|
|
## Build OpenTimelineIO (Required)
|
|
|
|
OpenTimelineIO enables importing/exporting timeline data in OTIO format. It is a required dependency.
|
|
|
|
```bash
|
|
# Clone the repository
|
|
git clone --depth 1 --branch v0.16.0 https://github.com/PixarAnimationStudios/OpenTimelineIO.git
|
|
cd OpenTimelineIO
|
|
|
|
# Configure and build
|
|
cmake -S . -B build -G Ninja \
|
|
-DOTIO_SHARED_LIBS=ON \
|
|
-DOTIO_PYTHON_BINDINGS=OFF \
|
|
-DOTIO_FIND_IMATH=ON \
|
|
-DCMAKE_BUILD_TYPE=Release \
|
|
-DCMAKE_INSTALL_PREFIX="${PWD}/install"
|
|
|
|
cmake --build build
|
|
cmake --install build
|
|
```
|
|
|
|
Note the installation path (e.g., `${PWD}/install`), you'll need it for the `OTIO_LOCATION` CMake option.
|
|
|
|
---
|
|
|
|
## Clone and Build Oak Video Editor
|
|
|
|
### 1. Clone the Repository
|
|
|
|
```bash
|
|
git clone --recursive https://github.com/OakVideoEditorCommunity/oak.git
|
|
cd oak
|
|
```
|
|
|
|
> **Note:** Make sure to use `--recursive` to clone submodules, as Oak depends on several external libraries included as submodules.
|
|
|
|
### 2. Configure with CMake
|
|
|
|
```bash
|
|
cmake -S . -B build -G Ninja \
|
|
-DCMAKE_BUILD_TYPE=Release \
|
|
-DOCIO_LOCATION=$(brew --prefix opencolorio) \
|
|
-DOTIO_LOCATION=/path/to/otio/install \
|
|
-DBUILD_TESTS=ON
|
|
```
|
|
|
|
### 3. Build
|
|
|
|
```bash
|
|
cmake --build build --config Release
|
|
```
|
|
|
|
The build process may take 10-30 minutes depending on your hardware.
|
|
|
|
---
|
|
|
|
## Run the Application
|
|
|
|
After successful build, you can run Oak Video Editor:
|
|
|
|
```bash
|
|
./build/app/oak-editor
|
|
```
|
|
|
|
Or open the app bundle (if generated):
|
|
|
|
```bash
|
|
open ./build/app/Oak.app
|
|
```
|
|
|
|
---
|
|
|
|
## Run Tests (Optional)
|
|
|
|
If you built with `-DBUILD_TESTS=ON`:
|
|
|
|
```bash
|
|
ctest --test-dir build --output-on-failure -C Release
|
|
```
|
|
|
|
---
|
|
|
|
## Build Options
|
|
|
|
| Option | Default | Description |
|
|
|--------|---------|-------------|
|
|
| `BUILD_TESTS` | `OFF` | Build unit tests |
|
|
| `BUILD_DOXYGEN` | `OFF` | Build Doxygen documentation |
|
|
| `USE_WERROR` | `OFF` | Treat warnings as errors |
|
|
| `OTIO_LOCATION` | - | Path to OpenTimelineIO installation (required) |
|
|
| `OCIO_LOCATION` | - | Path to OpenColorIO installation |
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### Qt 6 Not Found
|
|
|
|
If CMake cannot find Qt 6, ensure it's in your PATH:
|
|
|
|
```bash
|
|
export PATH="/opt/homebrew/opt/qt@6/bin:$PATH"
|
|
export CMAKE_PREFIX_PATH="/opt/homebrew/opt/qt@6"
|
|
```
|
|
|
|
For Intel Macs, the path may be `/usr/local/opt/qt@6` instead.
|
|
|
|
### OpenColorIO Not Found
|
|
|
|
Make sure to specify the correct `OCIO_LOCATION`:
|
|
|
|
```bash
|
|
-DOCIO_LOCATION=$(brew --prefix opencolorio)
|
|
```
|
|
|
|
### OpenImageIO Not Found
|
|
|
|
Try reinstalling OpenImageIO:
|
|
|
|
```bash
|
|
brew reinstall openimageio
|
|
```
|
|
|
|
### PortAudio Issues
|
|
|
|
If you encounter audio-related build errors:
|
|
|
|
```bash
|
|
brew reinstall portaudio
|
|
export PKG_CONFIG_PATH="/opt/homebrew/opt/portaudio/lib/pkgconfig:$PKG_CONFIG_PATH"
|
|
```
|
|
|
|
### Apple Silicon (M1/M2/M3) Specific Issues
|
|
|
|
On Apple Silicon Macs, Homebrew installs to `/opt/homebrew` instead of `/usr/local`. Make sure your environment variables are set correctly:
|
|
|
|
```bash
|
|
export PATH="/opt/homebrew/bin:$PATH"
|
|
export LIBRARY_PATH="/opt/homebrew/lib:$LIBRARY_PATH"
|
|
export CPATH="/opt/homebrew/include:$CPATH"
|
|
```
|
|
|
|
---
|
|
|
|
## Creating an App Bundle
|
|
|
|
To create a distributable `.app` bundle, you may need to use `macdeployqt`:
|
|
|
|
```bash
|
|
/opt/homebrew/opt/qt@6/bin/macdeployqt build/app/Oak.app
|
|
```
|
|
|
|
This will bundle the required Qt libraries into the app.
|
|
|
|
---
|
|
|
|
## Uninstall
|
|
|
|
To remove the built application:
|
|
|
|
```bash
|
|
rm -rf build
|
|
```
|
|
|
|
To remove Homebrew dependencies (optional):
|
|
|
|
```bash
|
|
brew uninstall qt@6 ffmpeg openimageio opencolorio openexr portaudio expat googletest
|
|
```
|