Deliver (Fastlane) — qué es, carga en App Store y configuración en desarrollo iOS y Android

¿Qué es Deliver (Fastlane)?

Deliver (Fastlane) es un componente del ecosistema Fastlane que automatiza el proceso de publicación de aplicaciones móviles en App Store. Gestiona la carga de archivos binarios, la actualización de metadatos (nombre, descripción, palabras clave), la carga de capturas de pantalla y la configuración de precios para todos los idiomas de localización.

Sin Deliver, cada lanzamiento requiere actualizar manualmente la información a través de la interfaz web de App Store Connect: rellenar descripciones en varios idiomas, cargar capturas de pantalla para cada tamaño de pantalla, actualizar palabras clave y configurar precios. La publicación en App Store es la etapa final del ciclo de vida de una aplicación iOS, que incluye la verificación del archivo binario, la moderación del contenido y la puesta a disposición de la aplicación en producción.

Según la Documentación de App Store Connect (2025), las aplicaciones con actualizaciones regulares obtienen un 30% más de instalaciones repetidas y se posicionan mejor en los resultados de búsqueda. Deliver permite a los equipos publicar actualizaciones semanalmente, automatizando los pasos rutinarios de publicación y reduciendo el riesgo de error humano al completar metadatos en docenas de idiomas.

Utilice Deliver para cualquier aplicación que se publique en App Store — es especialmente valioso para proyectos con localización multilingüe donde la actualización manual de 32 idiomas lleva varias horas.

Cómo funciona Deliver con App Store Connect

El mecanismo de funcionamiento de Deliver se basa en un proceso de dos etapas. En la primera etapa, la herramienta prepara los metadatos: valida la estructura del Deliverfile, carga las capturas de pantalla y genera un manifiesto de cambios. En la segunda etapa, Deliver envía los datos a la API de App Store Connect, carga el archivo binario e inicia el proceso de verificación de la compilación por parte de Apple.

Deliver utiliza la API de App Store Connect para todas las operaciones, lo que garantiza la compatibilidad con los últimos requisitos de Apple y elimina el uso de interfaces privadas. La API de App Store Connect es la API REST oficial de Apple para automatizar operaciones con aplicaciones, incluyendo la carga de compilaciones, la gestión de metadatos y el seguimiento del estado de la revisión.

Carga de archivos binarios

Deliver se integra directamente con Gym a través de Fastlane: después de la compilación del IPA, Deliver lo carga en App Store Connect e inicia el procesamiento. El parámetro --ipa especifica la ruta al archivo binario. Si no se especifica, Deliver encuentra automáticamente el último IPA en el directorio de compilación indicado en Gymfile o pasado a través de pasos anteriores de Fastlane.

Después de la carga, Deliver espera a que Apple complete el procesamiento del archivo binario — similar a Pilot, el estado se sigue mediante una barra de progreso. Estados disponibles: Processing, Waiting For Review, In Review, Ready For Sale o Rejected. Deliver notifica al equipo de cada cambio de estado mediante callbacks en Fastfile.

Gestión de metadatos de la aplicación

Deliver gestiona el conjunto completo de metadatos de la aplicación: nombre, descripción (corta y completa), palabras clave, URL de soporte y marketing, categoría y clasificación por edad. Los metadatos de la aplicación son la información textual sobre la aplicación que se muestra en la página de App Store y se utiliza para la indexación de búsqueda y la optimización ASO.

El parámetro --submit_for_review envía la aplicación a moderación inmediatamente después de la carga de metadatos. Este es un parámetro clave para lanzamientos totalmente automatizados. Sin él, Deliver solo carga los datos pero no envía la aplicación a revisión — útil para verificar previamente todos los campos antes del envío real.

Trabajo con capturas de pantalla

Deliver carga automáticamente capturas de pantalla para todas las combinaciones de dispositivos e idiomas desde el directorio especificado. Los nombres de archivo deben seguir el patrón: iPhone_6.5_01.png para un iPhone de 6.5 pulgadas en la primera ranura. Deliver determina el tamaño de la captura y lo compara con los requisitos de Apple para cada tipo de dispositivo.

Las capturas de pantalla se cargan en el orden correcto y por separado para cada idioma de localización. Si no se encuentran capturas para un idioma, Deliver utiliza las versiones en inglés como alternativa. La localización de capturas de pantalla es un requisito obligatorio para las aplicaciones que quieren posicionarse bien en App Store de diferentes países, ya que Apple considera el contenido local en los resultados de búsqueda.

# Comando básico de carga en App Store
fastlane deliver

# Carga con metadatos y capturas especificados
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Vista previa sin carga
fastlane deliver --preview

Configuración de Deliver mediante Deliverfile

Deliverfile es un archivo de configuración de Fastlane para almacenar metadatos de la aplicación en un formato Ruby estructurado. A diferencia de rellenar formularios manualmente en App Store Connect, Deliverfile permite versionar los metadatos en Git y verificar los cambios mediante revisión de código antes de publicar.

# Deliverfile — metadatos de la aplicación
app_identifier("com.company.app")
title("MyApp")
description("Descripción de la aplicación para la tienda")
keywords("móvil, aplicación, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# Idiomas de localización de metadatos
languages(["en-US", "ru", "de"])

El parámetro languages determina para qué idiomas se cargarán los metadatos. Se debe crear un directorio separado para cada idioma en la carpeta fastlane/metadata con los archivos correspondientes de descripción, palabras clave y textos de marketing. Deliver admite hasta 32 idiomas de App Store simultáneamente.

Para la carga de capturas de pantalla, se utiliza el directorio screenshots dentro de la carpeta de Fastlane. Estructura de carpetas: screenshots/[Language]/[DeviceType]_[ScreenSize]_[Number].png. Deliver carga automáticamente las capturas para los idiomas y dispositivos especificados, comparando los tamaños con los requisitos de Apple. Se recomienda usar Snapshot para generar capturas de pantalla — su formato de salida es compatible con Deliver.

El grupo de precios se configura mediante el parámetro price_tier, que acepta un número de nivel de precio del 0 al 87. Los niveles de precio de Apple se convierten automáticamente a las monedas de todos los países de presencia. Deliver permite cambiar el precio como parte de un lanzamiento, útil para promociones temporales o cambios en el modelo de negocio de la aplicación.

Comandos de Deliver para publicar aplicaciones

La interfaz de Deliver incluye comandos para cargar metadatos, archivos binarios, capturas de pantalla y lanzamientos completos. El comando principal fastlane deliver sin parámetros utiliza los datos del Deliverfile y el directorio de metadatos para un ciclo completo de publicación.

El comando fastlane deliver --preview ejecuta una verificación preliminar de metadatos sin cargar realmente en App Store Connect. --force es necesario para la carga — sin él, Deliver opera en modo de vista previa. El parámetro --skip_binary carga solo metadatos y capturas de pantalla, omitiendo la carga del archivo binario — útil para actualizar rápidamente campos ASO sin un nuevo lanzamiento.

# Lanzamiento completo con carga de binario
fastlane deliver --force --ipa "build/App.ipa"

# Cargar solo metadatos sin binario
fastlane deliver --force --skip_binary

# Actualizar solo capturas de pantalla
fastlane deliver --force --skip_metadata

El parámetro --skip_metadata carga solo capturas de pantalla y el archivo binario, manteniendo los metadatos existentes sin cambios. Esto es útil para lanzamientos de hotfix cuando se necesita publicar rápidamente una corrección sin cambiar la descripción y los campos ASO. La combinación de banderas permite gestionar de forma flexible cada etapa de publicación por separado.

Integración de Deliver en el pipeline de lanzamiento

El pipeline de lanzamiento con Deliver es un proceso CI/CD completo para iOS que automatiza todas las etapas desde el commit hasta la publicación en App Store. Un pipeline típico incluye: Match para certificados, Gym para compilaciones IPA, Snapshot para capturas de pantalla y Deliver para cargar todos los datos en App Store Connect con el posterior envío a moderación.

Una característica clave de Deliver en el pipeline es el soporte de metadata.json, que almacena metadatos en un formato JSON estructurado. Esto permite generar metadatos programáticamente desde sistemas CMS externos o crear automáticamente descripciones en varios idiomas mediante una API de traducción.

# Pipeline de lanzamiento en Fastfile
lane :release do
    match(type: :appstore)
    capture_screenshots
    gym(scheme: "MyApp", export_method: "app-store")
    deliver(ipa: "build/MyApp.ipa", force: true, submit_for_review: true)
end

Antes de llamar a Deliver en el pipeline, asegúrese de que todos los metadatos estén actualizados: la descripción coincide con la nueva versión, las capturas de pantalla están actualizadas para las nuevas funciones y el grupo de precios no necesita cambios. Submit for review envía la aplicación a moderación de Apple, que dura de 24 a 48 horas para aplicaciones nuevas y de 2 a 12 horas para actualizaciones.

Deliver admite el mecanismo app_version, que permite especificar la versión objetivo para las actualizaciones de metadatos. Si no se especifica la versión, Deliver actualiza la versión activa actual de la aplicación en App Store Connect. Para lanzar una nueva versión, primero debe crear la versión correspondiente a través de la interfaz de App Store Connect o la API.

Errores comunes al trabajar con Deliver

Al usar Deliver, los desarrolladores a menudo se encuentran con errores de validación de metadatos, estructura incorrecta de archivos de capturas de pantalla y problemas de autenticación. El diagnóstico de errores de Deliver comienza con el análisis de los registros del comando — Deliver muestra información detallada sobre cada etapa de carga y las razones del rechazo.

El error “Invalid screenshot path” ocurre cuando la estructura de carpetas de capturas de pantalla no coincide con el formato esperado. Solución: verifique que los nombres de archivo de las capturas sigan el patrón DeviceType_ScreenSize_Number.png (por ejemplo AppleiPhone15ProMax_6.7_01.png). Deliver distingue entre mayúsculas y minúsculas y es sensible a los separadores en los nombres de archivo.

El error “Metadata validation failed” indica que los metadatos no cumplen con los requisitos de App Store. Solución: verifique la longitud de la descripción (hasta 4000 caracteres), de las palabras clave (hasta 100 caracteres) y del nombre (hasta 30 caracteres). Las directrices de revisión de App Store contienen requisitos completos para cada campo de metadatos — se recomienda verificarlos antes de cada lanzamiento.

Con el error “Apple ID not found”, la aplicación no existe en App Store Connect con el apple_identifier especificado. Solución: cree la entrada de la aplicación en App Store Connect a través de la interfaz web antes de la primera llamada de Deliver, especificando el Bundle Identifier y el nombre. Deliver no crea nuevas aplicaciones — solo actualiza entradas existentes en la tienda.