用途:该技能用于执行 ArkWeb 构建、选择合适构建目标、验证构建是否成功、依据日志诊断失败,以及在不清理工作树的情况下继续增量构建。
主要能力:通过 build_arkweb.sh 发起构建;区分首次构建与增量构建;按失败阶段分类(pre-gn/sdk-lfs、gn-generation、ninja-graph-or-target、ninja-compile-link、resource-or-terminated);用脚本分析 build.log、扫描近期错误、检查 LFS 产物、捕获 CPU 与内存快照、过滤默认脏文件并展示相关 git 变更;并在允许范围内进行根因修复后重新构建验证。
必要用法:需在 ArkWeb wrapper 根目录(含 build_arkweb.sh 与 src/arkweb/build/build.sh)执行,而非 src/。主要默认命令为:cd <arkweb-root> 后执行 ./build_arkweb.sh rk3568_64 -t w -A。仅当调用方未提供 buildCommands、verifyCommands、buildTarget、buildOutputDir、buildTimeoutMinutes 时才使用默认值。默认增量构建;不自动执行 git clean、git reset --hard、rm -rf src/out、gn clean、ninja -t clean 或重新同步依赖。默认最长等待 4 小时,退出码 0 视为成功。
限制:需 Linux 构建主机,具备 GNU coreutils 与 /proc。首次构建通常约 2 至 3 小时,不应误判为普通增量构建或过早判定卡死。禁止修改 src/ohos_sdk/ 下工具链、SDK 归档、安装脚本等预构建内容,禁止修改当前 ArkWeb 项目目录之外的服务器文件。故障定位优先关联当前 git 变更;单一命令快速验证仅适用于 ninja-compile-link 阶段。具体命令变化、常见错误与日志位置见配套参考文档,本文未展开。