Reference · Environment Variables

环境变量与构建参数参考

本页列出了 gpux-cli 在本地开发、交叉编译与 CI/CD 流水线中读取的全部环境变量。

运行时与渲染管线变量

变量名	示例值	说明
`GPUX_LOG` / `RUST_LOG`	`gpux=debug,gpui=info`	控制 `tracing` 结构化日志级别
`GPUX_GPU_BACKEND`	`metal \| vulkan \| dx12 \| webgpu \| webgl2`	显式指定底层 GPU 渲染后端（默认自动探测最优硬件管线）
`GPUX_FONT_FALLBACK`	`emoji_and_cjk \| emoji_only \| disabled`	控制 Web WASM 构建时的 Canvas2D 字体回退模式

变量名	适用平台	说明
`ANDROID_NDK_HOME`	Android (`aarch64-linux-android`)	指定 Android NDK r26+ 路径供 `cargo-ndk` 调用
`OHOS_SDK_NATIVE`	HarmonyOS NEXT (`aarch64-unknown-linux-ohos`)	指定鸿蒙 Native SDK (Clang & sysroot) 目录供 `ohrs` 调用
`APPLE_SIGNING_IDENTITY`	macOS / iOS	代码签名证书名称（用于 `.dmg` 公证与 `.ipa` 打包）
`GPUX_UPDATER_PRIVATE_KEY`	全平台 OTA	用于对构建产物生成 Ed25519 增量更新签名的私钥