Variables de entorno

Esta es una documentación de todas las variables de entorno utilizadas por las crates de tauri core y la Tauri CLI.

Tauri CLI

Estas variables de entorno son entradas para la CLI que pueden tener un flag de la CLI equivalente.

Prioridad de las variables de entorno

Si se utilizan tanto la variable de entorno como el flag de la CLI, el flag de la CLI tendrá prioridad.

• CI — Si está establecida, la CLI se ejecutará en modo CI y no requerirá ninguna interacción por parte del usuario.
• TAURI_CLI_CONFIG_DEPTH — Número de niveles a recorrer para encontrar el archivo de configuración de tauri.
• TAURI_CLI_PORT — Puerto a utilizar para el servidor de desarrollo integrado de la CLI.
• TAURI_CLI_WATCHER_IGNORE_FILENAME — Nombre de un archivo al estilo .gitignore para controlar qué archivos deben ser observados por la CLI en el comando dev. La CLI buscará este nombre de archivo en cada directorio.
• TAURI_CLI_NO_DEV_SERVER_WAIT — Omite la espera a que el servidor de desarrollo del frontend se inicie antes de compilar la aplicación tauri.
• TAURI_LINUX_AYATANA_APPINDICATOR — Establece esta variable en true o 1 para forzar el uso de libayatana-appindicator para la bandeja del sistema en Linux.
• TAURI_BUNDLER_WIX_FIPS_COMPLIANT — Especifica la opción FipsCompliant de WiX del empaquetador.
• TAURI_BUNDLER_TOOLS_GITHUB_MIRROR - Especifica un mirror de GitHub para descargar los archivos y herramientas utilizados por el empaquetador de tauri.
• TAURI_BUNDLER_TOOLS_GITHUB_MIRROR_TEMPLATE - Especifica una plantilla de mirror de GitHub para descargar archivos y herramientas utilizados por el empaquetador de tauri, por ejemplo: https://mirror.example.com/<owner>/<repo>/releases/download/<version>/<asset>.
• TAURI_SKIP_SIDECAR_SIGNATURE_CHECK - Omitir la firma de sidecars.
• TAURI_SIGNING_PRIVATE_KEY — Clave privada utilizada para firmar los paquetes de tu aplicación, puede ser una cadena de texto o una ruta al archivo.
• TAURI_SIGNING_PRIVATE_KEY_PASSWORD — La contraseña de la clave privada de firma, consulta TAURI_SIGNING_PRIVATE_KEY.
• TAURI_SIGNING_RPM_KEY — La clave privada GPG utilizada para firmar el paquete RPM, exportada a su formato blindado ASCII.
• TAURI_SIGNING_RPM_KEY_PASSPHRASE — La frase de paso de la clave GPG para TAURI_SIGNING_RPM_KEY, si es necesaria.
• TAURI_WINDOWS_SIGNTOOL_PATH — Especifica la ruta a signtool.exe utilizada para la firma de código de la aplicación en Windows.
• APPLE_CERTIFICATE — Codificación en base64 del certificado .p12 para la firma de código. Para obtener este valor, ejecuta openssl base64 -A -in MiCertificado.p12 -out MiCertificado-base64.txt.
• APPLE_CERTIFICATE_PASSWORD — La contraseña que utilizaste para exportar el certificado.
• APPLE_ID — El Apple ID utilizado para notarizar la aplicación. Si se proporciona esta variable de entorno, también deben establecerse APPLE_PASSWORD y APPLE_TEAM_ID. De manera alternativa, se pueden utilizar APPLE_API_KEY y APPLE_API_ISSUER para autenticarse.
• APPLE_PASSWORD — La contraseña de Apple utilizada para autenticarse en la notarización de la aplicación. Requerida si se especifica APPLE_ID. Se puede utilizar una contraseña específica de la aplicación. Como alternativa a ingresar la contraseña en texto plano, también se puede especificar utilizando un prefijo '@keychain:' o '@env:' seguido del nombre del elemento de contraseña del llavero o del nombre de la variable de entorno.
• APPLE_TEAM_ID: ID del equipo de desarrolladores. Para encontrar tu Team ID, ve a la página Account en el sitio web de Apple Developer y consulta los detalles de tu membresía.
• APPLE_API_KEY — Alternative to APPLE_ID and APPLE_PASSWORD for notarization authentication using JWT. Also an option to allow automated iOS certificate and provisioning profile management.
  • See creating API keys for more information.
• API_PRIVATE_KEYS_DIR — Especifica el directorio donde se encuentra tu archivo AuthKey. Consulta APPLE_API_KEY.
• APPLE_API_ISSUER — ID del emisor. Requerido si se especifica APPLE_API_KEY.
• APPLE_API_KEY_PATH - Ruta al archivo .p8 de la clave API. Si no se especifica, para aplicaciones de macOS el empaquetador busca en secuencia los siguientes directorios un archivo de clave privada con el nombre 'AuthKey_<api_key>.p8': './private_keys', '/private_keys', '/.private_keys' y '~/.appstoreconnect/private_keys'. Para iOS esta variable es requerida.
• APPLE_SIGNING_IDENTITY — La identidad utilizada para firmar el código. Sobrescribe tauri.conf.json > bundle > macOS > signingIdentity. Si ninguno está establecido, se infiere de APPLE_CERTIFICATE cuando se proporciona.
• APPLE_PROVIDER_SHORT_NAME — Si tu Apple ID está conectado a múltiples equipos, debes especificar el nombre corto del proveedor del equipo que deseas usar para notarizar tu aplicación. Sobrescribe tauri.conf.json > bundle > macOS > providerShortName.
• APPLE_DEVELOPMENT_TEAM — El ID del equipo utilizado para firmar el código en iOS. Sobrescribe tauri.conf.json > bundle > iOS > developmentTeam. Se puede encontrar en https://developer.apple.com/account#MembershipDetailsCard.
• TAURI_WEBVIEW_AUTOMATION — Habilita la automatización del webview (Solo Linux).
• TAURI_ANDROID_PROJECT_PATH — Ruta del proyecto de tauri android, por lo general será <project>/src-tauri/gen/android.
• TAURI_IOS_PROJECT_PATH — Ruta del proyecto de tauri iOS, por lo general será <project>/src-tauri/gen/ios.

Comandos de hook de la Tauri CLI

Estas variables de entorno se establecen para cada comando hook (beforeDevCommand, beforeBuildCommand, ...etc) lo cual puede ser útil para compilar condicionalmente tu frontend o ejecutar una acción específica.

• TAURI_ENV_DEBUG — true para el comando dev o build --debug, false en caso contrario.
• TAURI_ENV_TARGET_TRIPLE — Target triple que la CLI está compilando.
• TAURI_ENV_ARCH — Arquitectura de destino, x86_64, aarch64...etc.
• TAURI_ENV_PLATFORM — Plataforma de destino, windows, darwin, linux...etc.
• TAURI_ENV_PLATFORM_VERSION — Versión de la plataforma de compilación
• TAURI_ENV_FAMILY — Familia de la plataforma de destino unix o windows.