macOS 安装

以下流程用于 macOS 本地开发和原生工具链验证。

前置环境

macOS 构建需要：

• Xcode Command Line Tools；
• Homebrew；
• Git；
• CMake 3.25+；
• Ninja 和脚本列出的 Homebrew 构建依赖。

先安装并验证 Xcode Command Line Tools：

xcode-select --install
xcode-select -p

Homebrew 需要由开发者按其官方安装方式安装。安装脚本不会自动执行 Homebrew 自身的远程安装命令。

执行安装

# 默认构建 Release
sh install/install_macos.sh

# 构建 Debug
sh install/install_macos.sh Debug

# 明确构建 Release
sh install/install_macos.sh Release

macOS 使用以下 CMake 配置：

Preset:       macos-ninja
Generator:    Ninja Multi-Config
Build dir:    kbe/src/out/build/macos-ninja
Runtime dir:  kbe/bin/server

脚本会通过 Homebrew 检查并安装 CMake、Ninja、Autotools、pkg-config、Bison、Flex、Perl 和 libtirpc 等依赖，并将 keg-only 工具加入当前构建进程的 PATH。

已经准备好依赖时可以只执行验证和构建：

KBE_SKIP_SYSTEM_DEPS=1 sh install/install_macos.sh Release

Apple Silicon 默认使用当前主机架构构建。不要把 x86_64 的 vcpkg installed/buildtrees 缓存与 arm64 构建目录混用。