Lee el log
Dale la salida completa de xcodebuild, no una captura de pantalla. Codex encuentra el primer error real entre cientos de advertencias y lo explica con palabras sencillas, que es la mitad de cualquier arreglo.
Cinco datos sobre el proyecto de Xcode de WebViewGold
La mayoría de los bucles con Xcode vienen de tratar el proyecto como si fuera una plantilla nueva de Xcode. No lo es, y cinco datos de la documentación de configuración para iOS y de nuestro equipo de soporte explican casi todos los errores:
- Abre el workspace. El proyecto usa CocoaPods. Abre siempre
WebViewGold.xcworkspace, nunca el.xcodeprojpor sí solo, o faltarán los pods (OneSignal, AdMob y otros). - Hay más de un target. Junto al target de la app
WebViewGoldhay targets de extensión comoOneSignalNotificationServiceExtension(y App Clip u otros, si los hay). Cada uno necesita un equipo, y cada bundle ID debe empezar por el de la app:com.yourbrand.app.OneSignalNotificationServiceExtension. - Las versiones tienen que coincidir. Todos los targets llevan la misma versión y el mismo número de build.
- El nombre está en dos sitios. El Product Name de Build Settings no puede contener letras acentuadas; el nombre de la pantalla de inicio con acentos va en Bundle Display Name, en Info.plist. No cambies el nombre del propio proyecto ("WebViewGold"); la documentación de publicación advierte de que da problemas.
- Hay una clave de Info.plist que debe quedarse. Elimina los textos de permisos que no necesites, pero mantén Privacy - Tracking Usage Description; la documentación indica que sin ella la app se cierra.
Y un dato de Apple: desde el 28 de abril de 2026, App Store Connect solo acepta builds hechas con Xcode 26 o posterior. Usa el Xcode actual que no sea beta, desde la Mac App Store, y una versión actual de WebViewGold.
Los errores que más vemos y cómo arreglarlos
| Mensaje o síntoma | Causa | Solución | Quién |
|---|---|---|---|
| "No such module …" o "framework not found Pods_WebViewGold" | Se abrió el .xcodeproj en lugar del workspace, o la herramienta de descompresión dañó los pods | Abre WebViewGold.xcworkspace. Si sigue fallando: vuelve a descargar el zip, descomprímelo con otra herramienta y conserva los nombres de las carpetas; si hace falta, ejecuta pod install en la carpeta del proyecto | Codex puede ejecutarlo |
| "Pods-WebViewGold-frameworks.sh: Permission denied" con "Command PhaseScriptExecution failed with a nonzero exit code" | El script perdió el permiso de ejecución al descomprimir | chmod +x sobre el script que indica el log y después Product → Clean Build Folder | Codex |
| "… cannot be opened because the developer cannot be verified" | Gatekeeper de macOS bloquea el script descargado | Cierra Xcode, haz Control-clic en el archivo en el Finder (Pods/Target Support Files), elige Abrir y vuelve a abrir el workspace | Tú |
| "Signing for OneSignalNotificationServiceExtension requires a development team" | El equipo solo está configurado en el target de la app | Selecciona el mismo equipo en Signing & Capabilities para todos los targets | Tú, o Codex con tu Team ID |
| "Failed to register bundle identifier" / "… is not available" | El bundle ID de la plantilla, o uno que ya registró otro desarrollador | Elige tu propio ID en formato DNS inverso y cámbialo en todos los targets | Codex |
| "The embedded binary's bundle identifier is not prefixed with the parent app's bundle identifier" | El ID de la extensión sigue teniendo el prefijo antiguo | El ID de tu app más .OneSignalNotificationServiceExtension | Codex |
| ITMS-90685 "CFBundleIdentifier Collision" | Una extensión usa el mismo ID que la app | Dale a cada extensión su propio sufijo | Codex |
| ITMS-90473 "CFBundleVersion Mismatch" | El número de build de la extensión no coincide con el de la app | La misma versión y el mismo número de build en todos los targets | Codex |
| "Provisioning profile doesn't support the Push Notifications capability" | Al App ID le falta la capability | Activa Push Notifications y App Groups para el App ID en el portal de Apple Developer, quita y vuelve a añadir la capability en Xcode y reinicia Xcode | Tú |
| "Failed to create provisioning profile" / "No profiles for … were found" | Apple ID o equipo incorrecto en Xcode, o un simulador seleccionado como destino | Revisa Xcode Settings → Accounts; archiva con "Any iOS Device (arm64)" | Tú |
| "errSecInternalComponent" / "Command CodeSign failed with a nonzero exit code" | Llavero bloqueado o certificado ausente | Desbloquea el llavero de inicio de sesión; si no aparece ningún certificado Apple Distribution, crea uno en Settings → Accounts → Manage Certificates | Tú |
| ITMS-90717 "Invalid App Store Icon" (transparencia o canal alfa) | El icono de 1024 px tiene canal alfa | Expórtalo aplanado y sin alfa y sustitúyelo en el conjunto AppIcon | Codex puede comprobarlo |
| ITMS-90725 "SDK version issue" | Compilado con un Xcode y un SDK antiguos | Actualiza Xcode y vuelve a compilar | Tú |
| La app se cierra nada más abrirse después de editar Info.plist | Se eliminó Privacy - Tracking Usage Description | Restaura la clave con un texto de finalidad breve y veraz | Codex |
Dónde ayuda Codex y dónde te pasa el testigo
Edita los archivos de texto del proyecto de forma coherente
Los bundle IDs y los números de versión están en project.pbxproj, los textos de permisos en Info.plist y tus ajustes en Config.swift. Codex cambia todos los targets en un solo diff en lugar de solo el que recordabas.
Ejecuta comandos, con tu aprobación
Con la Codex CLI o la extensión del IDE en tu Mac puede ejecutar xcodebuild, pod install, plutil y sips. Los comandos que salen de su sandbox (una compilación de Xcode escribe en DerivedData y puede contactar con Apple) necesitan tu aprobación, o los ejecutas tú y le pasas el log.
Nunca tu cuenta de Apple
Los certificados, los App IDs, las capabilities y los perfiles están en tu cuenta de Apple Developer, y el llavero necesita la contraseña de tu Mac. No pegues ninguna de las dos cosas en un agente. Codex escribe los pasos; tú haces los clics.
Las tareas en la nube no tienen Xcode
Una tarea en la nube de Codex puede editar los archivos del proyecto en un repositorio y abrir un pull request, pero no puede compilar, firmar ni archivar una app de iOS. Las compilaciones se hacen en un Mac o en el Cloud Builder.
WebViewGold nos ha permitido el tiempo de mercado más corto y eficiente que jamás sea posible de todas las otras plataformas de aplicaciones que hemos probado durante los últimos 5 años. No sé por qué no lo había descubierto antes, ¡pero estoy muy, muy contento de haberlo hecho. Actualmente cerca de 6000 descargas de aplicaciones tanto en iOS App Store & Google Play Store sin ningún problema!
Dale a Codex un log completo
Ejecuta esto en Terminal, en la carpeta que contiene WebViewGold.xcworkspace, o deja que lo ejecute Codex. El comando de archivado hace lo mismo que Product → Archive y guarda todo en build.log.
bash
# 1. Schemes and targets (use the scheme name it prints below)
xcodebuild -list -workspace WebViewGold.xcworkspace
# 2. Archive from the command line and keep the complete log
xcodebuild -workspace WebViewGold.xcworkspace -scheme WebViewGold \
-configuration Release -destination "generic/platform=iOS" \
-archivePath build/WebViewGold.xcarchive archive 2>&1 | tee build.log
# 3. The errors only, with line numbers
grep -n "error:" build.log | head -40
# 4. Bundle IDs and versions of every target (one prefix, one version)
grep -n "PRODUCT_BUNDLE_IDENTIFIER\|MARKETING_VERSION\|CURRENT_PROJECT_VERSION" *.xcodeproj/project.pbxproj
# 5. Signing identities in your keychain
security find-identity -v -p codesigning
# 6. Does the icon have an alpha channel? (path from your AppIcon set)
sips -g pixelWidth -g pixelHeight -g hasAlpha path/to/AppIcon-1024.pngEl prompt de triaje para Xcode
Rellena los corchetes. Lo importante es el bloque de reglas: enumera lo que un agente no debe tocar nunca en este proyecto.
Pégalo en la Codex CLI o en la extensión del IDE, abierta en la carpeta del proyecto de Xcode
Estoy compilando la app de iOS a partir del proyecto de Xcode de WebViewGold que hay en esta carpeta, y el archivado falla. Lee build.log (la salida completa de xcodebuild) y ayúdame a arreglarlo. Datos del proyecto: - Compila siempre WebViewGold.xcworkspace (CocoaPods), nunca el .xcodeproj por sí solo. - Targets: WebViewGold más targets de extensión como OneSignalNotificationServiceExtension (y otros, si los hay). Cada bundle ID de extensión es el bundle ID principal más un sufijo, p. ej. com.yourbrand.app.OneSignalNotificationServiceExtension. - Todos los targets usan la misma versión, el mismo número de build y el mismo equipo de desarrollo. - Mi bundle ID: [com.yourbrand.app]. Mi Team ID: [ABCDE12345]. Versión [1.0], build [1]. Reglas: - No cambies el nombre del proyecto de Xcode, no ejecutes pod update, no actualices ni elimines SDKs (AdMob, OneSignal u otros), no borres la clave NSUserTrackingUsageDescription y no cambies el deployment target. - Antes de editar project.pbxproj, enséñame exactamente las líneas que vas a cambiar. Cambia solo los bundle identifiers, los números de versión y los ajustes del equipo. - No voy a compartir contraseñas. Para todo lo que necesite mi cuenta de Apple, el portal de Apple Developer o el llavero, dame en su lugar los pasos clic a clic. Responde con: 1. El primer error real del log, citado (ignora las advertencias y los errores derivados). 2. Su causa en este proyecto, en una o dos frases. 3. El arreglo: los cambios que has hecho o los pasos que debo seguir. 4. El comando que lo verifica.
Arregla en este orden
Cada paso elimina toda una categoría de errores; saltarte pasos hace que los mensajes posteriores despisten.
Empieza de cero
Una descompresión limpia de la versión actual de WebViewGold con los nombres de las carpetas intactos, el Xcode actual y el workspace abierto. Copia tus valores de Config.swift en lugar de seguir remendando un proyecto antiguo a medio arreglar.
Bundle IDs
Tu ID en el target de la app y el mismo prefijo más un sufijo en cada extensión. Decídelo para siempre: elige el bundle ID una sola vez.
Equipo y firma
El mismo equipo en todos los targets, "Automatically manage signing" activado y la sesión iniciada con el Apple ID que corresponde a tu membresía del programa de desarrolladores.
Capabilities del App ID
En el portal de Apple Developer, activa Push Notifications y App Groups para tu App ID (la documentación de publicación pide las dos) y después reinicia Xcode para que descargue los perfiles nuevos.
Versiones
La versión y el número de build idénticos en todos los targets, y el número de build más alto que el de cualquier build que hayas subido antes.
Archivar
Destino "Any iOS Device (arm64)" y después Product → Archive. Si Archive aparece en gris, hay un simulador seleccionado.
Sube la build y lee el email
Distribuye desde el Organizer. Los errores de procesamiento de App Store Connect llegan por email con un número ITMS; pega ese email en Codex igual que un log de compilación.
Prueba la build real
Instala desde TestFlight, no solo desde Xcode: las builds de release usan la firma de distribución y el push de producción. Consulta TestFlight para apps creadas con vibe coding.
Lo que Codex no debe hacer en este proyecto
- Ejecutar
pod updateo actualizar SDKs. Eso cambia las versiones probadas de OneSignal, AdMob y otros por versiones sin probar;pod installes suficiente. - Eliminar el SDK de AdMob porque no muestras anuncios. La documentación advierte de que eso provoca muchos errores de dependencias; en su lugar, responde a la pregunta del Ad ID en App Store Connect tal como describe la documentación de publicación.
- Cambiar el nombre del proyecto de Xcode, mover carpetas o subir el deployment target para silenciar una advertencia.
- Borrar de Info.plist la descripción de uso para el rastreo (tracking usage description).
- Editar
project.pbxprojsin hacer antes un commit o una copia de seguridad. Pide las líneas exactas antes de la edición. - Recibir la contraseña de tu Apple ID, una contraseña específica de app o la contraseña de tu Mac. Ningún paso de la compilación necesita que el agente las conozca.
Preguntas frecuentes
¿Puede Codex en la nube compilar mi app de iOS?
No. Las tareas en la nube pueden editar los archivos del proyecto de Xcode en un repositorio, pero compilar y firmar una app de iOS requiere Xcode en macOS. Usa la Codex CLI o la extensión del IDE en un Mac, un Mac alquilado o el Cloud Builder.
¿Debería darle a Codex mi Apple ID para que arregle la firma?
No, y tampoco lo necesita. Tu Team ID (el identificador de 10 caracteres que aparece en el portal de Apple Developer) basta para los ajustes del proyecto; todo lo que necesita la cuenta en sí son unos pocos clics que haces tú en Xcode o en el portal.
Apple me ha enviado un email sobre un entitlement de notificaciones push que falta. ¿Es un rechazo?
No, es un aviso de que el push no está configurado. Si no usas push, sigue con el envío. Si lo usas, añade la capability Push Notifications en Xcode y en el App ID del portal de Apple Developer.
¿Por qué Product → Archive aparece en gris?
Hay un simulador seleccionado como destino de ejecución. Elige Any iOS Device (arm64) en la barra de herramientas y vuelve a intentarlo.
¿Tengo que arreglar todas las advertencias amarillas?
No. Las advertencias de pods de terceros son normales en los proyectos de WebViewGold. Arregla los errores y las advertencias que mencione App Store Connect en su email de procesamiento.
Tres formas de llevar tu app a las tiendas
El mismo resultado, con distinta cantidad de trabajo por tu parte. Las tres incluyen la garantía de aprobación y soporte humano 24/7.
Hazlo tú mismo
$109 por plataforma, pago único
La licencia de WebViewGold: un proyecto de Xcode o Android Studio listo para usar. Pega tu URL, define nombre e icono, activa funciones, compila y envía. Actualizaciones gratuitas para siempre.
Ver planes en la página principalCloud Builder
$349 por licencia, complemento de pago único
Sin Mac, sin Xcode, sin Android Studio: configura en el navegador, compilamos ambas apps en la nube y las entregamos a App Store Connect y a Play Console.
Cómo funciona el Cloud Builder Prueba la demo gratuitaFull Service
$698 por plataforma $798
Envíanos tu URL y tu icono. Nuestro equipo configura, compila y entrega tu app en 72 horas, en marca blanca y con los proyectos fuente. Ambas plataformas por $1,158.
Detalles del Full Service Con tecnología de
Precios de la Oferta de invierno válidos hasta el 31 de diciembre de 2026.