环境变量

这是 tauri 核心包和 tauri CLI 使用的所有环境变量的文档。

🌐 This is a documentation of all environment variables used by tauri core crates and tauri CLI.

Tauri CLI

这些环境变量是 CLI 的输入，可能具有等效的 CLI 标志。

🌐 These environment variables are inputs to the CLI which may have an equivalent CLI flag.

CI — 如果设置，CLI 将以 CI 模式运行，并且不需要任何用户交互。
TAURI_CLI_CONFIG_DEPTH — 要遍历的层数以找到 tauri 配置文件。
TAURI_CLI_PORT — 用于 CLI 内置开发服务器的端口。
TAURI_CLI_WATCHER_IGNORE_FILENAME — 一个 .gitignore 风格的文件名，用于控制 CLI 在 dev 命令中应监视哪些文件。CLI 会在每个目录中查找这个文件名。
TAURI_CLI_NO_DEV_SERVER_WAIT — 在构建 Tauri 应用之前跳过等待前端开发服务器启动的步骤。
TAURI_LINUX_AYATANA_APPINDICATOR — 将此变量设置为 true 或 1 以强制在 Linux 上使用 libayatana-appindicator 作为系统托盘。
TAURI_BUNDLER_WIX_FIPS_COMPLIANT — 指定打包器的 WiX FipsCompliant 选项。
TAURI_BUNDLER_TOOLS_GITHUB_MIRROR - 指定 GitHub 镜像以下载 tauri bundler 使用的文件和工具。
TAURI_BUNDLER_TOOLS_GITHUB_MIRROR_TEMPLATE - 指定一个 GitHub 镜像模板来下载 tauri bundler 使用的文件和工具，例如：https://mirror.example.com/<owner>/<repo>/releases/download/<version>/<asset>。
TAURI_SKIP_SIDECAR_SIGNATURE_CHECK - 跳过签名 sidecar。
TAURI_SIGNING_PRIVATE_KEY — 用于签署应用包的私钥，可以是字符串或文件路径。
TAURI_SIGNING_PRIVATE_KEY_PASSWORD — 签名私钥密码，见 TAURI_SIGNING_PRIVATE_KEY。
TAURI_SIGNING_RPM_KEY — 用于签署 RPM 包的私有 GPG 密钥，已导出为 ASCII 装甲格式。
TAURI_SIGNING_RPM_KEY_PASSPHRASE — TAURI_SIGNING_RPM_KEY 的 GPG 密钥密码（如需要）。
TAURI_WINDOWS_SIGNTOOL_PATH — 指定用于在 Windows 上对应用进行代码签名的 signtool.exe 的路径。
APPLE_CERTIFICATE — .p12 代码签名证书的 Base64 编码。要获取此值，请运行 openssl base64 -A -in MyCertificate.p12 -out MyCertificate-base64.txt。
APPLE_CERTIFICATE_PASSWORD — 你用来导出证书的密码。
APPLE_ID — 用于对应用进行公证的 Apple ID。如果提供了此环境变量，则必须同时设置 APPLE_PASSWORD 和 APPLE_TEAM_ID。或者，也可以使用 APPLE_API_KEY 和 APPLE_API_ISSUER 进行身份验证。
APPLE_PASSWORD — 用于应用公证认证的 Apple 密码。如果指定了 APPLE_ID，则为必填项。可以使用应用专用密码。除了以明文输入密码外，也可以使用 ‘@keychain:’ 或 ‘@env:’ 前缀指定密码，后跟密钥串密码条目名称或环境变量名称。
APPLE_TEAM_ID：开发者团队 ID。要查找你的团队 ID，请转到 Apple Developer 网站上的账户页面，并查看你的会员详细信息。
APPLE_API_KEY — 使用 JWT 进行公证认证的 APPLE_ID 和 APPLE_PASSWORD 替代方案。同时也是允许自动化 iOS 证书和配置文件管理的选项。
- 有关更多信息，请参阅创建 API 密钥。
API_PRIVATE_KEYS_DIR — 指定存放 AuthKey 文件的目录。参见 APPLE_API_KEY。
APPLE_API_ISSUER — 发行者 ID。如果指定了 APPLE_API_KEY，则为必填项。
APPLE_API_KEY_PATH - API 密钥 .p8 文件的路径。如果未指定，对于 macOS 应用，打包工具将按顺序在以下目录中搜索名为 ‘AuthKey_<api_key>.p8’ 的私钥文件：’./private_keys’、‘~~/private_keys’、‘~~/.private_keys’ 和 ’~/.appstoreconnect/private_keys’。对于 iOS，此变量是必需的。
APPLE_SIGNING_IDENTITY — 用于代码签名的身份。会覆盖 tauri.conf.json > bundle > macOS > signingIdentity。如果两者都未设置，则在提供 APPLE_CERTIFICATE 时会从 APPLE_CERTIFICATE 推断。
APPLE_PROVIDER_SHORT_NAME — 如果你的 Apple ID 连接到多个团队，你必须指定你想用来公证应用的团队的提供商简称。会覆盖 tauri.conf.json > bundle > macOS > providerShortName。
APPLE_DEVELOPMENT_TEAM — 用于 iOS 代码签名的团队 ID。会覆盖 tauri.conf.json > bundle > iOS > developmentTeam。可以在 https://developer.apple.com/account#MembershipDetailsCard 中找到。
TAURI_WEBVIEW_AUTOMATION — 启用网页视图自动化（仅限 Linux）。
TAURI_ANDROID_PROJECT_PATH —— 牛头人安卓项目的路径，通常是 <project>/src-tauri/gen/android。
TAURI_IOS_PROJECT_PATH — tauri iOS 项目的路径，通常是 <project>/src-tauri/gen/ios。

Tauri CLI Hook 命令

🌐 Tauri CLI Hook Commands

这些环境变量为每个钩子命令（beforeDevCommand、beforeBuildCommand……等）设置，这可能有助于有条件地构建你的前端或执行特定操作。

🌐 These environment variables are set for each hook command (beforeDevCommand, beforeBuildCommand, …etc) which could be useful to conditionally build your frontend or execute a specific action.

TAURI_ENV_DEBUG — 对 dev 命令或 build --debug 使用 true，否则使用 false。
TAURI_ENV_TARGET_TRIPLE — CLI 正在构建的目标三元组。
TAURI_ENV_ARCH — 目标架构, x86_64, aarch64…等等.
TAURI_ENV_PLATFORM — 目标平台，windows，darwin，linux…等。
TAURI_ENV_PLATFORM_VERSION — 构建平台版本
TAURI_ENV_FAMILY — 目标平台系列 unix 或 windows。