环境诊断 (zero-native doctor)

zero-native doctor 命令用于对您的开发环境进行故障排查与健康检查。

检查项说明

检查项目	描述
宿主平台 (Host platform)	操作系统与芯片架构。
WebView	WKWebView (macOS) 或 WebKitGTK (Linux) 的可用性。
描述文件清单 (Manifest)	app.zon 配置文件的合法性校验（仅在传入 --manifest 参数时执行）。
日志目录 (Log directory)	日志输出路径的可写权限。
CEF	当在 app.zon 中指定了使用 Chromium 引擎或在命令行传入了 --web-engine chromium 时，校验 CEF 运行时分发目录是否存在。
签名工具 (Signing tools)	代码签名工具在系统中的可用性。

使用方法

# 普通信息模式（即使存在警告也总是以退出码 0 结束）
zero-native doctor

# 严格模式（如果存在任何警告则返回非零退出码）
zero-native doctor --manifest app.zon --strict

# 校验 CEF 环境配置
zero-native doctor --manifest app.zon

命令行参数

参数名	描述
--strict	在诊断出任何警告时均直接以非零状态码退出。
--manifest	指定要校验的 app.zon 配置文件的路径。
--web-engine	临时覆盖 app.zon 中配置的引擎类型，可选值为 system 或 chromium。
--cef-dir	临时覆盖 CEF 运行时的分发路径。
--cef-auto-install	进行 Chromium 环境校验时，临时允许自动下载并安装预备好的 CEF 运行时。