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

环境变量

这是所有 Tauri Core crates 和 Tauri CLI 使用的环境变量的文档。

Tauri CLI

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

  • 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 — 指定 bundler 的 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 -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_PRIVATE_KEYS_DIR — 指定 AuthKey 文件所在的目录。请参阅 APPLE_API_KEY。
  • APPLE_API_ISSUER — 发布者 ID。如果指定了 APPLE_API_KEY，则为必需项。
  • APPLE_API_KEY_PATH - API 密钥 .p8 文件的路径。如果未指定，对于 macOS 应用程序，bundler 将按顺序在以下目录中搜索名称为“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 — 启用 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 Hook 命令

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

  • TAURI_ENV_DEBUG — true 用于 dev 命令或 build --debug，否则为 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。

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