docs: add macOS (Apple Silicon) quick start guide - #626
Open
onecer wants to merge 1 commit into
Open
Conversation
❌ CLA Signature Required@onecer Some contributors need to sign the CLA:
Please:
📋 View detailed check results: Action Run #29255109162 💡 Tip: All contributors must sign the CLA before the PR can be merged. |
Mirror the Ubuntu quick start for macOS on Apple Silicon: repo init with -g default,platform-darwin, GNU toolchain via Homebrew, cmake/jidl host adaptations, and the quickjs host build patch. Includes zh-cn and en, with macos-env.sh / build-macos.sh helper scripts. Verified end-to-end: build goldfish-arm64-v8a-ap and boot the emulator to the goldfish-armv8a-ap> prompt.
onecer
force-pushed
the
docs/macos-quick-start
branch
from
July 13, 2026 14:01
730126c to
0164f72
Compare
❌ CLA Signature Required@onecer Some contributors need to sign the CLA:
Please:
📋 View detailed check results: Action Run #29256157820 💡 Tip: All contributors must sign the CLA before the PR can be merged. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
新增 macOS（Apple Silicon）快速上手文档，与现有《快速入门（Ubuntu）》对应，覆盖依赖安装、
repo同步、编译到运行 Vela Emulator 的完整流程。中英双语（zh-cn/与en/）。Why
openvela 的
build.sh/emulator.sh/envsetup.sh已内置Darwin分支，manifest 也提供完整的darwin-aarch64预编译工具链，可在 macOS 上原生开发，但文档此前只覆盖 Ubuntu。macOS 与 Ubuntu 的主要差异（文档均已说明）
repo init需显式追加-g default,platform-darwin，否则 darwin 预编译工具链不被同步。bash(5.x)/grep/coreutils/gnu-sed并前置 PATH（declare -A/grep -oP/realpath --relative-to/sed -i等依赖）。prebuilts/tools/cmake/bin为 Linux ELF，需符号链接到prebuilts/cmake/darwin-aarch64。jidl_gen_cpp为 Linux 二进制，通过 Docker（linux/amd64）运行。CMakeLists.txt补丁（CMAKE_HOST_APPLE→ clang 分支 +-include sys/types.h）。-j$(nproc)→-j$(sysctl -n hw.ncpu)；ffmpeg 首次 out-of-tree 构建目录顺序由build-macos.sh自动重试覆盖。附带
macos-env.sh与build-macos.sh两个幂等辅助脚本。验证
已在 macOS（Apple Silicon）端到端验证：
repo sync→ 编译goldfish-arm64-v8a-ap（产出nuttx/nuttx.bin）→emulator.sh引导至goldfish-armv8a-ap>提示符。