跳到主要內容
Tauri
指南 參考 部落格 發行版本

環境變數

這是 Tauri 核心 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 — 指定 signtool.exe 的路徑，用於在 Windows 上程式碼簽署應用程式。
  • 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_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 — 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。

© 2025 Tauri 貢獻者。CC-BY / MIT