App Store

La App Store de Apple es la tienda de aplicaciones mantenida por Apple. Puedes distribuir tu aplicación Tauri dirigida a macOS e iOS a través de esta App Store.

Esta guía solo cubre detalles para distribuir aplicaciones directamente a la App Store. Consulta la guía general de App Bundle para obtener más información sobre las opciones y configuraciones de distribución en macOS.

Requisitos

Distribuir aplicaciones iOS y macOS requiere inscribirse en el programa Apple Developer.

Además, debes configurar la firma de código para macOS e iOS.

Cambiar el icono de la aplicación

Después de ejecutar tauri ios init para configurar el proyecto de Xcode, puedes usar el comando tauri icon para actualizar los iconos de la aplicación.

npm

npm run tauri icon /path/to/app-icon.png -- --ios-color '#fff'

yarn

yarn tauri icon /path/to/app-icon.png --ios-color '#fff'

pnpm

pnpm tauri icon /path/to/app-icon.png --ios-color '#fff'

deno

deno task tauri icon /path/to/app-icon.png --ios-color '#fff'

bun

bun tauri icon /path/to/app-icon.png --ios-color '#fff'

cargo

cargo tauri icon /path/to/app-icon.png --ios-color '#fff'

El argumento --ios-color define el color de fondo para los iconos de iOS.

Configuración

Después de inscribirte en el programa Apple Developer, el primer paso para distribuir tu aplicación Tauri en la App Store es registrar tu aplicación en App Store Connect.

Nota

El valor proporcionado en el campo Bundle ID debe coincidir con el identificador definido en tauri.conf.json > identifier.

Compilar y subir

La CLI de Tauri puede empaquetar tu aplicación para macOS e iOS. Ejecutar en una máquina macOS es un requisito.

Tauri deriva la versión CFBundleVersion del valor definido en [tauri.conf.json > version]. Puedes establecer una versión de paquete personalizada en la configuración [tauri.conf.json > bundle > iOS > bundleVersion] o [tauri.conf.json > bundle > macOS > bundleVersion] si necesitas un esquema de versión de paquete diferente, p. ej., códigos secuenciales:

tauri.conf.json

{
  "bundle": {
    "iOS": {
      "bundleVersion": "100"
    }
  }
}

Precaución

Se requiere firma de código. Consulta la documentación para macOS e iOS.

Ten en cuenta que Tauri aprovecha Xcode para la aplicación iOS, por lo que puedes usar Xcode para archivar y distribuir para iOS en lugar de la CLI de Tauri. Para abrir el proyecto de iOS en Xcode para compilarlo, debes ejecutar el siguiente comando:

npm

npm run tauri ios build -- --open

yarn

yarn tauri ios build --open

pnpm

pnpm tauri ios build --open

deno

deno task tauri ios build --open

bun

bun tauri ios build --open

cargo

cargo tauri ios build --open

macOS

Para subir tu aplicación a la App Store, primero debes asegurarte de que todas las opciones de configuración requeridas estén establecidas para poder empaquetar el App Bundle, crear un archivo .pkg firmado y subirlo.

Las siguientes secciones te guiarán a través del proceso.

Configuración

Tu aplicación debe incluir algunas configuraciones para ser aceptada por el sistema de verificación de la App Store.

Consejo

Las siguientes secciones te guían a través de la configuración de tu aplicación para envíos a la App Store.

Para aplicar los siguientes cambios de configuración solo al compilar para la App Store, puedes crear un archivo de configuración de Tauri separado:

"src-tauri/tauri.appstore.conf.json

{
  "bundle": {
    "macOS": {
      "entitlements": "./Entitlements.plist",
      "files": {
        "embedded.provisionprofile": "path/to/profile-name.provisionprofile"
      }
    }
  }
}

Luego combina ese archivo de configuración con el principal al empaquetar tu aplicación Tauri para la App Store:

npm

npm run tauri build -- --no-bundle
npm run tauri bundle -- --bundles app --target universal-apple-darwin --config src-tauri/tauri.appstore.conf.json

yarn

yarn tauri build --no-bundle
yarn tauri bundle --bundles app --target universal-apple-darwin --config src-tauri/tauri.appstore.conf.json

pnpm

pnpm tauri build --no-bundle
pnpm tauri bundle --bundles app --target universal-apple-darwin --config src-tauri/tauri.appstore.conf.json

deno

deno task tauri build --no-bundle
deno task tauri bundle --bundles app --target universal-apple-darwin --config src-tauri/tauri.appstore.conf.json

bun

bun tauri build --no-bundle
bun tauri bundle --bundles app --target universal-apple-darwin --config src-tauri/tauri.appstore.conf.json

cargo

cargo tauri build --no-bundle
cargo tauri bundle --bundles app --target universal-apple-darwin --config src-tauri/tauri.appstore.conf.json

Esto es particularmente útil cuando configuras tu CI/CD para subir tu aplicación a la App Store sin requerir el perfil de aprovisionamiento de forma local o al compilar la aplicación para su distribución fuera de la App Store.

• Categoría

Tu aplicación debe definir su tauri.conf.json > bundle > category para mostrarse en la App Store:

tauri.conf.json

{
  "bundle": {
    "category": "Utility"
  }
}

• Perfil de aprovisionamiento

También debes crear un perfil de aprovisionamiento para que tu aplicación sea aceptada por Apple.

En la página Identifiers, crea un nuevo App ID y asegúrate de que su valor “Bundle ID” coincida con el identificador establecido en tauri.conf.json > identifier.

Navega a la página Profiles para crear un nuevo perfil de aprovisionamiento. Para la distribución de macOS en la App Store, debe ser un perfil “Mac App Store Connect”. Selecciona el App ID adecuado y vincula el certificado que estás utilizando para la firma de código.

Después de crear el perfil de aprovisionamiento, descárgalo y guárdalo en una ubicación conocida y configura Tauri para incluirlo en el paquete de tu aplicación:

tauri.conf.json

{
  "bundle": {
    "macOS": {
      "files": {
        "embedded.provisionprofile": "path/to/profile-name.provisionprofile"
      }
    }
  }
}

• Info.plist

Tu aplicación debe cumplir con las regulaciones de exportación de cifrado. Consulta la documentación oficial para obtener más información.

Crea un archivo Info.plist en la carpeta src-tauri:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>ITSAppUsesNonExemptEncryption</key>
  <false/> # or `true` if your app uses encryption
</dict>
</plist>

• Entitlements

Tu aplicación debe incluir la capacidad App Sandbox para ser distribuida en la App Store. Además, también debes establecer tu App ID y Team ID en los entitlements de firma de código.

Crea un archivo Entitlements.plist en la carpeta src-tauri:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.security.app-sandbox</key>
    <true/>
    <key>com.apple.application-identifier</key>
    <string>$TEAM_ID.$IDENTIFIER</string>
    <key>com.apple.developer.team-identifier</key>
    <string>$TEAM_ID</string>
</dict>
</plist>

Ten en cuenta que debes reemplazar $IDENTIFIER con el valor de tauri.conf.json > identifier y $TEAM_ID con el ID de tu equipo de Apple Developer, que se puede encontrar en la sección App ID Prefix en el Identifier que creaste para el perfil de aprovisionamiento.

Y haz referencia a ese archivo en la configuración del paquete de macOS tauri.conf.json > bundle > macOS > entitlements:

tauri.conf.json

{
  "bundle": {
    "macOS": {
      "entitlements": "./Entitlements.plist"
    }
  }
}

Ahora debes compilar tu aplicación con la firma de código habilitada para que se apliquen los entitlements.

Asegúrate de que tu aplicación funcione al ejecutarse en un contexto de App Sandbox.

Compilar

Debes subir tu aplicación de macOS como un archivo .pkg a la App Store. Ejecuta el siguiente comando para empaquetar tu aplicación como un App Bundle de macOS (extensión .app):

tauri build --bundles app --target universal-apple-darwin

Nota

El comando anterior crea un binario de aplicación universal, compatible con procesadores Apple Silicon e Intel.

Si prefieres admitir únicamente Apple Silicon, debes cambiar tauri.conf.json > bundle > macOS > minimumSystemVersion a 12.0:

tauri.conf.json

{
  "bundle": {
    "macOS": {
      "minimumSystemVersion": "12.0"
    }
  }
}

Y cambia el comando de la CLI y la ruta de salida según el sistema Mac que estés ejecutando:

• si tu sistema de compilación usa un chip Apple Silicon, elimina los argumentos --target universal-apple-darwin y usa target/release en lugar de target/universal-apple-darwin/release en las rutas referenciadas a continuación.
• if your build system uses an Intel chip:
  • install the Rust Apple Silicon target:

    rustup target add aarch64-apple-darwin

  • cambia el argumento universal-apple-darwin a aarch64-apple-darwin y usa target/aarch64-apple-darwin/release en lugar de target/universal-apple-darwin/release en las rutas referenciadas a continuación.

Consulta la guía de distribución de App Bundle para obtener más información sobre las opciones de configuración.

Para generar un .pkg firmado a partir de tu paquete de aplicación, ejecuta el siguiente comando:

xcrun productbuild --sign "<certificate signing identity>" --component "target/universal-apple-darwin/release/bundle/macos/$APPNAME.app" /Applications "$APPNAME.pkg"

Ten en cuenta que debes reemplazar $APPNAME con el nombre de tu aplicación.

Nota

Debes firmar el PKG con un certificado de firma Mac Installer Distribution.

Subir

Ahora puedes usar la CLI de altool para subir el PKG de tu aplicación a la App Store:

xcrun altool --upload-app --type macos --file "$APPNAME.pkg" --apiKey $APPLE_API_KEY_ID --apiIssuer $APPLE_API_ISSUER

Ten en cuenta que altool requiere una clave de API de App Store Connect para subir tu aplicación. Consulta la sección de autenticación para obtener más información.

Tu aplicación será luego validada por Apple y estará disponible en TestFlight si es aprobada.

iOS

Para compilar tu aplicación iOS, ejecuta el comando tauri ios build:

npm

npm run tauri ios build -- --export-method app-store-connect

yarn

yarn tauri ios build --export-method app-store-connect

pnpm

pnpm tauri ios build --export-method app-store-connect

deno

deno task tauri ios build --export-method app-store-connect

bun

bun tauri ios build --export-method app-store-connect

cargo

cargo tauri ios build --export-method app-store-connect

El archivo IPA generado se puede encontrar en src-tauri/gen/apple/build/arm64/$APPNAME.ipa.

Ten en cuenta que debes reemplazar $APPNAME con el nombre de tu aplicación.

Ahora puedes usar la CLI de altool para subir tu aplicación iOS a la App Store:

xcrun altool --upload-app --type ios --file "src-tauri/gen/apple/build/arm64/$APPNAME.ipa" --apiKey $APPLE_API_KEY_ID --apiIssuer $APPLE_API_ISSUER

Ten en cuenta que altool requiere una clave de API de App Store Connect para subir tu aplicación. Consulta la sección de autenticación para obtener más información.

Tu aplicación será luego validada por Apple y estará disponible en TestFlight si es aprobada.

Autenticación

Las aplicaciones de iOS y macOS se suben mediante altool, el cual utiliza una clave de API de App Store Connect para autenticarse.

Para crear una nueva clave de API, abre la página de Usuarios y acceso de App Store Connect, selecciona la pestaña Integraciones > Claves individuales, haz clic en el botón Añadir y selecciona un nombre y el acceso de Desarrollador. El APPLE_API_ISSUER (ID de emisor) se presenta arriba de la tabla de claves, y el APPLE_API_KEY_ID es el valor en la columna ID de clave de esa tabla. También necesitas descargar la clave privada, lo cual solo se puede hacer una vez y solo es visible después de recargar la página (el botón se muestra en la fila de la tabla para la clave recién creada). La ruta del archivo de la clave privada se debe guardar como AuthKey\_<APPLE_API_KEY_ID>.p8 en uno de estos directorios:<current-working-directory>/private_keys, ~/private_keys, ~/.private_keyso~/.appstoreconnect/private_keys.