Cómo solucionar errores de compilación, archivado y firma de Xcode en proyectos de WebViewGold con Claude Code
La mayoría de las compilaciones de iOS fallidas de un proyecto de WebViewGold se reducen a una lista corta: el archivo de proyecto equivocado, un target sin equipo, una extensión con un bundle ID antiguo, un App ID sin las capabilities correctas o una versión de Xcode que App Store Connect ya no acepta. Claude Code es muy bueno leyendo un log largo de xcodebuild y encontrando la única línea que importa. No puede iniciar sesión en tu cuenta de Apple, y esta guía deja claro dónde está ese límite.
Desde $109 de pago único por plataforma, o deja que nuestro equipo lo haga todo desde $698.
Garantía de aprobación – o te devolvemos el dinero en 14 días
Sin programar
Pago único, actualizaciones gratuitas
Soporte humano 24/7
Hecho en Alemania desde 2014 · ISO 27001
9:41
Tu app
Tu appYa en tu bolsillo
App Store · Google Play Aprobada
Dale a Claude Code el log real
El aviso rojo de Xcode es un resumen; la causa suele estar unos cientos de líneas antes. Hay dos formas de hacerle llegar el log real a Claude Code. En Xcode, abre el Report navigator (Cmd + 9), selecciona la compilación o el archivado fallido y copia o exporta la transcripción completa. O, más sencillo, deja que Claude Code ejecute la compilación: inícialo en Terminal dentro de la carpeta del proyecto iOS en tu Mac y podrá llamar a xcodebuild, guardar la salida y buscar en ella.
Dos detalles ahorran horas. Abre y compila siempre WebViewGold.xcworkspace, no WebView.xcodeproj; la documentación de configuración de iOS insiste en ello porque solo el workspace incluye las dependencias. Y Claude Code en la web se ejecuta en Linux: una sesión en la nube puede editar Info.plist o los ajustes del proyecto en tu repositorio, pero no puede ejecutar Xcode. Las compilaciones de iOS se hacen en un Mac, en un Mac alquilado o en el Cloud Builder.
Los comandos que ejecutará Claude Code
Ejecútalos tú o deja que los ejecute el agente. El paso 1 te dice el nombre real del scheme; úsalo en los demás comandos.
bash
mkdir -p build
# 1. List schemes and targets (always use the workspace, not the .xcodeproj)
xcodebuild -list -workspace WebViewGold.xcworkspace
# 2. Archive for the App Store and keep the complete log
# (replace WebViewGold with the app scheme from step 1 if it differs)
xcodebuild -workspace WebViewGold.xcworkspace \
-scheme WebViewGold \
-configuration Release \
-destination 'generic/platform=iOS' \
-archivePath build/App.xcarchive \
archive 2>&1 | tee build/archive.log
# 3. The lines that usually matter
grep -nE "error:|Provisioning|provisioning profile|Signing for|entitlement" build/archive.log | head -40
# 4. What Xcode actually used for each target
xcodebuild -workspace WebViewGold.xcworkspace -scheme WebViewGold -showBuildSettings \
| grep -E "TARGET_NAME|PRODUCT_BUNDLE_IDENTIFIER|DEVELOPMENT_TEAM|CODE_SIGN_STYLE|MARKETING_VERSION|CURRENT_PROJECT_VERSION"
Errores con los que te encontrarás y quién los soluciona
Error (extracto)
Causa habitual en un proyecto de WebViewGold
Solución
Quién
No such module '…', o cientos de errores en los pods
Se abrió el .xcodeproj en lugar del workspace
Cierra Xcode (Cmd + Q) y abre WebViewGold.xcworkspace
Tú
Signing for "WebViewGold" requires a development team
No hay ningún equipo seleccionado para un target
Signing & Capabilities: selecciona tu equipo para el target de la app y para cada target de extensión
Tú, en Xcode
No profiles for 'com.example.app' were found
Xcode no ha iniciado sesión en tu cuenta de desarrollador o el App ID todavía no existe
Xcode Settings, Accounts: añade tu cuenta de Apple, deja activada la firma automática y deja que Xcode cree el perfil
Tú
Provisioning profile … doesn't include the Push Notifications capability (o App Groups, o el entitlement aps-environment)
Al App ID le faltan capabilities que usa el proyecto
Activa Push Notifications y App Groups en el App ID en el portal Apple Developer, como describe la documentación de publicación, y reinicia Xcode
Tú
Embedded binary's bundle identifier is not prefixed with the parent app's bundle identifier
Una extensión como OneSignalNotificationServiceExtension todavía tiene el bundle ID de la plantilla
Usa tu ID principal más un sufijo, por ejemplo com.example.app.OneSignalNotificationServiceExtension
Claude encuentra cada discrepancia, tú confirmas en Xcode
Sandbox: rsync(…) deny(1) file-write-create durante "Embed Pods Frameworks"
El sandboxing de scripts de usuario de las versiones recientes de Xcode bloquea los scripts de compilación de CocoaPods
Pon User Script Sandboxing (ENABLE_USER_SCRIPT_SANDBOXING) en No para el target de la app
Claude
Command PhaseScriptExecution failed with a nonzero exit code
Falló un script de compilación; esta línea es solo la consecuencia
Busca hacia arriba en el log el primer error: de ese script
Claude
Archive aparece en gris o no produce nada
Hay un simulador seleccionado como destino de ejecución
Selecciona "Any iOS Device (arm64)" y luego Product, Archive
Tú
"Missing private key" junto a un certificado en Xcode Settings, Accounts
El certificado de distribución se creó en otro Mac
Expórtalo como .p12 en ese Mac, o revócalo y deja que Xcode cree uno nuevo
Tú
ITMS-90189: Redundant Binary Upload, o "bundle version must be higher"
El número de compilación ya se usó
Incrementa CURRENT_PROJECT_VERSION (Build) en cada subida y MARKETING_VERSION (Version) en cada nueva versión
Claude
Error de versión del SDK al subir
Compilado con un Xcode que App Store Connect ya no acepta; desde abril de 2026 las subidas requieren Xcode 26 y el SDK de iOS 26 o posterior
Actualiza Xcode (y macOS si hace falta) y descarga la versión actual de WebViewGold, gratuita para quienes tienen licencia
Tú
ITMS-90683: Missing purpose string in Info.plist
Se borró una descripción de uso aunque el binario sigue haciendo referencia a esa API
Restaura la clave con un texto de finalidad honesto y concreto
Claude
Unable to process request - PLA Update available
Apple publicó un nuevo Program License Agreement
El Account Holder lo acepta en la cuenta de desarrollador
Tú (Account Holder)
Con una buena versión optimizada de su aplicación web, puedes tener una impresionante aplicación móvil en un par de minutos. ¡Además del servicio al cliente es muy agradable y muy útil! ¡Puedo recomendar WebViewgold :-)
Julian Koch · Cofundador de Dueldonkey · CodeCanyon
El ciclo de reparación
Primero diagnostica, después edita, y quédate tus claves para ti.
Abre Claude Code en la carpeta del proyecto iOS
En Terminal, haz cd a la carpeta que contiene WebViewGold.xcworkspace e inicia claude. Abre Xcode al menos una vez antes, para que las herramientas de línea de comandos y tu cuenta estén configuradas.
Deja que reproduzca el fallo
Pega el prompt de diagnóstico de abajo. El agente enumera los schemes, ejecuta el archivado y guarda el log completo en build/archive.log, así tienes delante exactamente el mismo texto que el agente.
Separa las correcciones de archivos de las de la cuenta
El prompt hace que Claude clasifique cada corrección en "puedo cambiar este archivo" (Info.plist, números de compilación, un ajuste de compilación, bundle IDs de extensiones) y "tienes que hacerlo tú en Xcode o en el portal de desarrolladores". Aprueba las primeras; haz tú las segundas con la ruta de clics que te da.
Vuelve a archivar
Ejecuta de nuevo el mismo comando de archivado. Un error nuevo es un avance: los errores de firma suelen venir por capas, primero el equipo, luego el perfil y luego una capability.
Sube con un número de compilación nuevo
Distribuye el archivo desde el Organizer de Xcode o con Transporter. Cada subida necesita un número de compilación nuevo, así que pide a Claude que lo incremente antes de cada archivado.
Prueba antes de enviar
Instala la compilación mediante TestFlight en un iPhone real y comprueba push, Face ID y la pantalla sin conexión antes de enviarla a App Review.
El prompt de diagnóstico
Le dice al agente qué puede cambiar y qué debe devolverte a ti. Las reglas del punto 5 son las que impiden que un problema de un error se convierta en uno de tres.
Pégalo en Claude Code en tu Mac, en la carpeta del proyecto iOS
Esta carpeta contiene un proyecto iOS de WebViewGold. El archivado para el App Store falla y quiero un diagnóstico antes de cualquier cambio.
1. Ejecuta xcodebuild -list -workspace WebViewGold.xcworkspace y elige el scheme de la app.
2. Archiva con -configuration Release -destination 'generic/platform=iOS' y guarda la salida completa en build/archive.log.
3. Encuentra el primer error real, no los errores derivados. Cita las líneas relevantes del log y explica en lenguaje sencillo qué significan.
4. Clasifica la corrección en uno de estos dos grupos:
(a) un cambio de archivo que puedes hacer tú: Info.plist, número de versión o de compilación, un ajuste de compilación, una discrepancia de bundle ID entre el target de la app y sus targets de extensión;
(b) algo que tengo que hacer yo en Xcode Settings > Accounts, en la pestaña Signing & Capabilities o en el portal Apple Developer. Para (b), dame la ruta de clics exacta.
5. Reglas: no cambies el equipo, el estilo de firma, los certificados ni los perfiles de aprovisionamiento; no ejecutes pod update ni cambies versiones de dependencias; no renombres el proyecto de Xcode; nunca accedas al llavero ni muestres certificados.
Muéstrame los cambios de archivo propuestos y espera mi OK antes de aplicarlos.
Lo que Claude Code no puede hacer por ti
Nada de esto es una función que falte. Son cosas ligadas a tu identidad y a tus claves, y así debe seguir siendo.
Tu cuenta de Apple
Iniciar sesión, los códigos de verificación en dos pasos, la inscripción en el Apple Developer Program ($99 al año) y aceptar acuerdos nuevos. Solo el Account Holder puede aceptar el Program License Agreement; la guía de inscripción cubre la parte de la cuenta.
Certificados y claves privadas
Crear o revocar certificados de distribución, exportar un .p12 desde el Mac que tiene la clave privada, responder a las solicitudes del llavero. Nunca pegues la contraseña de un certificado en un chat.
App IDs y capabilities
Registrar el bundle ID, activar Push Notifications y App Groups, crear el registro de la app en App Store Connect. La firma automática de Xcode hace parte de esto, pero quien hace clic eres tú.
Dispositivos y confianza
Registrar dispositivos de prueba, activar el modo de desarrollador en el iPhone, confiar en el ordenador. El agente puede enumerar los pasos; los hacen tus manos y tu teléfono.
Decisiones de envío
Elegir la compilación en App Store Connect, la respuesta sobre cumplimiento de exportación, las notas para la revisión y pulsar Submit. Claude puede redactar los textos; las respuestas son tuyas.
Elegir identificadores
El bundle ID es permanente una vez que la app está publicada. Decídelo tú, una sola vez; la guía del bundle ID explica por qué.
Errores habituales
Dejar que el agente "arregle" la firma. Pasar a la firma manual, pegar IDs de equipo en project.pbxproj o borrar ajustes de aprovisionamiento suele convertir un error en tres. Los cambios de firma van en la pestaña Signing & Capabilities.
Renombrar el proyecto de Xcode. El proyecto se llama WebViewGold y así debe seguir; solo el Product Name y el Bundle Display Name están pensados para cambiar.
Actualizar dependencias para silenciar una advertencia.pod update o una nueva versión de un SDK en mitad de una publicación es la forma clásica de romper una compilación que solo necesitaba un número de compilación nuevo.
Borrar la descripción de uso del tracking. La documentación de WebViewGold pide conservar la clave Privacy - Tracking Usage Description; si la eliminas, la app se cierra.
Consejos genéricos de respuestas antiguas en foros. En Macs con Apple Silicon, la documentación de configuración describe destinos de simulador con Rosetta para algunas configuraciones. Si las compilaciones para el simulador fallan con errores de arquitectura, lee esa sección antes de cambiar los ajustes de arquitectura.
Reutilizar números de compilación. Cada subida necesita un número de compilación más alto, aunque la versión siga siendo la misma.
Lista de comprobación antes de cada archivado
WebViewGold.xcworkspace abierto en Xcode 26 o posterior.
Hay un equipo seleccionado para el target de la app y para cada target de extensión.
Los bundle IDs de las extensiones empiezan por el bundle ID principal.
El App ID tiene Push Notifications y App Groups si usas push.
Version incrementada para cada nueva publicación y número de compilación incrementado en cada subida.
Config.swift apunta a la URL de producción, no a un servidor de desarrollo.
Las descripciones de uso son concretas y honestas, y la clave de tracking sigue ahí.
Preguntas frecuentes
¿Puede Claude Code compilar y archivar mi app de iOS?
En un Mac, sí: puede ejecutar xcodebuild en la terminal para compilaciones y archivados y leer los resultados. No puede hacer clic por Xcode, iniciar sesión en tu cuenta de Apple ni aprobar solicitudes del llavero, así que la firma tienes que configurarla tú una vez.
¿Puedo solucionar errores de Xcode con Claude Code en la web?
Solo en parte. Las sesiones en la nube se ejecutan en Linux sin Xcode, así que el agente puede editar Info.plist o archivos del proyecto en tu repositorio, pero no puede compilar para verificar la corrección. Compila en un Mac o con el Cloud Builder.
¿Debo darle al agente mi certificado o la contraseña de mi cuenta de Apple?
No. Nada en una corrección de compilación normal lo requiere. Si una corrección sugerida necesita tus credenciales, haz ese paso tú mismo en Xcode o en el portal de desarrolladores.
¿Por qué el archivado funciona pero la subida falla?
App Store Connect hace sus propias comprobaciones después del archivado: versión del SDK, número de compilación, registro del bundle ID, textos de finalidad y capabilities. Pega el error exacto de la subida en Claude Code; la mayoría se corrigen con una sola línea.
¿Necesito una nueva versión de WebViewGold cuando Apple sube el requisito de Xcode?
A menudo es el camino más fácil. Las actualizaciones son gratuitas para quienes tienen licencia: descarga el proyecto actual y deja que Claude Code copie tus ajustes del antiguo Config.swift al nuevo.
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.
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.
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.
Los reembolsos se conceden bajo las condiciones indicadas en nuestras FAQ: un rechazo por motivos ajenos al contenido por parte de Apple y/o Google, reclamado dentro de los 14 días posteriores a la compra.