El número de compilación de iOS que se quedó en 1: tres arreglos fallidos y uno que funcionó
Por Nesim Razon, desarrollador móvil independiente · 2026-11-17
Cada subida a App Store Connect necesita un número de compilación mayor que el anterior. Nuestra canalización en la nube seguía produciendo un paquete con número de compilación 1, cambiáramos lo que cambiáramos. Hicieron falta tres intentos para descubrir por qué. Esta es la historia y la solución, para quien compile apps de iOS desde un proyecto de Xcode generado sin tener un Mac propio.
El síntoma
El paso de subida falló con un error que decía que la versión del paquete debe ser mayor que la subida anteriormente. La primera subida de una app siempre funciona, así que el problema solo aparece desde la segunda compilación. El número mostrado para la compilación en la tienda era 1 cada vez.
Intervienen dos números. La versión de marketing, como 1.0, es la que ven las personas. El número de compilación, CFBundleVersion, solo tiene que aumentar con cada subida de la misma versión de marketing.
Primer intento: opciones del archivo
La herramienta de compilación permite pasar opciones adicionales al comando de archivado, así que pasamos allí el número de compilación. No cambió nada. La opción se aceptó sin efecto alguno sobre el valor que acababa en el paquete.
Segundo intento: editar la descripción del proyecto
El proyecto se genera con XcodeGen a partir de un pequeño archivo de descripción, que tiene un campo para el número de compilación. Lo reescribimos con sed antes de generar el proyecto, con el número de ejecución de la integración continua. El proyecto generado contenía el valor nuevo, pero el paquete seguía diciendo 1.
El motivo es que el Info.plist que produce XcodeGen no toma el número de compilación de ese ajuste. Tiene su propio valor, y ese es el que se empaqueta.
Tercer intento y una idea mejor
Una tercera variante de la misma idea falló igual. Lo que había que cambiar no eran los ajustes de compilación, sino el archivo que realmente se lee: el Info.plist.
La solución: escribirlo en el Info.plist
Una vez generado el proyecto, un solo comando fija el valor directamente: PlistBuddy con Set :CFBundleVersion y el número. El número es 1000 más el contador de compilaciones del servicio de integración continua, de modo que siempre crece y no choca con subidas anteriores.
La segunda mitad de la solución es demostrarlo. Antes de subir, el script lee CFBundleVersion del paquete terminado y lo imprime en el registro. Si el valor es incorrecto, lo ves en un minuto y no después de una subida fallida.
Qué llevarse
- Fija el número de compilación en el archivo que se empaqueta, no en un ajuste que quizá no llegue a él.
- Imprime el valor del paquete final, no de tu entrada.
- Usa un contador que solo sube, como el número de compilación de la integración continua con un desplazamiento fijo.
- Si la subida dice que la versión del paquete debe ser mayor, mira primero el paquete.
Preguntas frecuentes
¿Cuál es la diferencia entre la versión y el número de compilación?
La versión es el número que ven los usuarios, por ejemplo 1.0. El número de compilación solo tiene que subir con cada subida de esa versión.
¿Por qué no funcionó editar la descripción del proyecto?
El Info.plist generado por XcodeGen no tomó el número de compilación de ese ajuste, así que el paquete conservó su propio valor.
¿Cómo se comprueba el valor empaquetado?
Se lee CFBundleVersion del Info.plist dentro del paquete terminado y se imprime en el registro de compilación antes de subir.
Más del blog
- Puerta de región para Analytics en iOS cuando no se lee el país de la SIM
- Por qué mi enlace de la App Store dio 404 y la página mostraba capturas de 2018
- Guía 2.1 de App Store «Information Needed»: lo que envié
- Capturas de App Store sin teléfono: Robolectric, un cargador de imágenes falso y un navegador sin interfaz
- Un código QR para dos tiendas de apps: una pequeña página de redirección
- Reescribir para Kotlin Multiplatform sin cambiar el comportamiento: el código antiguo como oráculo de pruebas