跳到内容
Tauri
指南 参考 博客 发布

环境变量

本篇文档介绍了 Tauri 核心 crates 和 Tauri CLI 中使用的所有环境变量。

Tauri CLI

Section titled “Tauri CLI”

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

  • CI — 如果设置，CLI 将在 CI 模式下运行，并且不需要任何用户交互。
  • TAURI_CLI_CONFIG_DEPTH — 遍历并查找 tauri 配置文件所用的层数。
  • TAURI_CLI_PORT — 用于 CLI 内置开发服务器的端口。
  • TAURI_CLI_WATCHER_IGNORE_FILENAME — 控制 CLI 在 dev 命令中监视哪些文件的 .gitignore 样式文件名。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-armored 格式。
  • TAURI_SIGNING_RPM_KEY_PASSPHRASE — TAURI_SIGNING_RPM_KEY 的 GPG 密钥密码，如果需要。
  • TAURI_WINDOWS_SIGNTOOL_PATH — 指定用于在 Windows 上进行代码签名的 signtool.exe 路径。
  • APPLE_CERTIFICATE — 用于代码签名的 .p12 证书的 Base64 编码。要获取此值，请运行 openssl base64 -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 — APPLE_ID 和 APPLE_PASSWORD 的替代方案，用于使用 JWT 进行公证身份验证。也是允许自动 iOS 证书和配置文件管理的选项。
  • 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_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 — 启用 webview 自动化（仅限 Linux）。
  • TAURI_ANDROID_PROJECT_PATH — tauri android 项目的路径，通常为 <project>/src-tauri/gen/android。
  • TAURI_IOS_PROJECT_PATH — tauri iOS 项目的路径，通常为 <project>/src-tauri/gen/ios。

Tauri CLI 钩子命令

Section titled “Tauri CLI Hook Commands”

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

  • 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。
在 Open Collective 上支持 在 GitHub 上赞助

© 2025 Tauri 贡献者。CC-BY / MIT