Añadir un icono a Xcode: importar AppIcon y comprobar el destino

Para añadir un icono de aplicación a Xcode, importa el conjunto en el catálogo de recursos y asegúrate de que el destino utiliza su nombre. Descargar el ZIP solo prepara los archivos. Xcode debe encontrar la imagen referenciada e incluirla en la aplicación que compilas.

Esta guía trata la salida del generador de iconos para iOS. Apple también ofrece un flujo con Icon Composer. Identifica cuál usa tu proyecto antes de sustituir recursos.

Extrae y revisa el conjunto de iconos

Conserva el ZIP como referencia y descomprime una copia de trabajo. El conjunto principal de la exportación actual es iOS/AppIcon.appiconset; contiene AppIcon-1024.png y Contents.json. Los PNG derivados de AdditionalSizes son opcionales y quedan fuera de la entrada principal del catálogo.

Abre Contents.json y compara el nombre de imagen con el archivo de la misma carpeta. Respeta mayúsculas y minúsculas: otro sistema de archivos puede distinguirlas durante la compilación. Si cambias el nombre del PNG, actualiza también su referencia en JSON.

El conjunto generado declara una imagen universal de iOS. Un proyecto con otro destino de despliegue o con varias apariencias puede requerir más recursos. Examina lo que ya existe; no borres automáticamente las variantes oscuras o tintadas del proyecto.

Importa el conjunto en el catálogo adecuado

Busca en Xcode el catálogo incluido en el destino de tu aplicación. Arrastra allí AppIcon.appiconset, o copia la carpeta dentro del catálogo en disco y comprueba que aparece en el editor. Guarda el conjunto anterior hasta que la sustitución compile correctamente.

Si ya existe un conjunto llamado AppIcon, decide si vas a reemplazar su contenido o dar otro nombre al nuevo. Dos conjuntos difíciles de distinguir hacen más probable seleccionar el equivocado. Los destinos de desarrollo y producción pueden utilizar iconos distintos dentro del mismo repositorio.

La documentación de configuración del catálogo de Apple describe el flujo admitido. Los nombres de los controles pueden variar entre versiones de Xcode. Cuando documentes los pasos para el equipo, incluye la versión del editor que utilizaste.

Selecciona el recurso del destino de la aplicación

Selecciona el destino y revisa su configuración de icono. El nombre elegido debe coincidir con el conjunto importado. Si utilizas distintas configuraciones de compilación, comprueba específicamente la que vas a ejecutar.

Esta diferencia explica un fallo frecuente: la imagen nueva aparece en el editor de recursos, pero la aplicación instalada conserva la anterior porque otro destino o configuración selecciona otro conjunto. Revisa el destino y el esquema juntos antes de modificar el diseño.

También comprueba que el catálogo pertenece al destino de la aplicación. Tener la carpeta en el repositorio no basta si sus recursos quedan fuera de la compilación correspondiente.

Una compilación comprobada con el catálogo exportado

El 1 de octubre de 2026, un proyecto de prueba importó el AppIcon.appiconset actual y compiló el esquema IconValidation en Debug con Xcode 26.6 (17F113), iOS Simulator SDK 26.5 y destino mínimo iOS 18.0. La app incluyó su ejecutable, Assets.car, AppIcon60x60@2x.png y AppIcon76x76@2x~ipad.png. Las entradas principales de iPhone e iPad seleccionaron AppIcon.

Descargar el proyecto original de verificación local

El proyecto incluido reproduce la compilación con este comando desde su directorio. No tiene dependencias externas y desactiva la firma para el simulador local.

xcodebuild -project IconValidation.xcodeproj -scheme IconValidation \
  -configuration Debug -sdk iphonesimulator \
  -destination 'generic/platform=iOS Simulator' \
  -derivedDataPath /tmp/iconvalidation-derived \
  CODE_SIGNING_ALLOWED=NO build

Compila e inspecciona la aplicación instalada

Compila el esquema elegido para un simulador o dispositivo. Lee las advertencias del catálogo además de los errores que detienen el proceso. Instala esa compilación y observa el icono en la pantalla de inicio a su tamaño real.

La vista grande puede ocultar trazos finos y contrastes débiles. Antes de exportar, compara la vista pequeña de App Icon Maker; después contrástala con la aplicación instalada. El simulador proporciona evidencia local útil. Registra por separado una prueba en un dispositivo físico cuando la realices.

Conserva el conjunto que efectivamente compilaste. Una nueva exportación posterior puede tener diferencias que todavía no se han probado en el proyecto.

Diagnostica un icono que no se actualiza

Comprueba este orden antes de volver a diseñar:

1. El PNG existe con el nombre declarado en Contents.json.
2. El catálogo está incluido en el destino de la aplicación.
3. El nombre seleccionado coincide con el conjunto importado.
4. Has compilado el esquema y la configuración previstos.
5. Esa compilación se ha instalado en el dispositivo observado.

Si todo coincide, investiga la caché con una aplicación de prueba desechable o una compilación limpia. Una vista del navegador o una carpeta descomprimida no demuestran que Xcode haya compilado el recurso correcto. Antes de eliminar una aplicación para probar, conserva los datos que necesites.

Ejemplo instalado en simulador

El 2 de octubre de 2026 se instaló el icono exportado en un simulador iPhone 17 aislado con iOS 26.5. La aplicación arrancó y su icono XY apareció en la pantalla de inicio. Esto verifica ese proyecto y sistema, no un dispositivo físico ni la aprobación de App Store.

Preguntas sobre los iconos de Xcode

¿Debo redondear las esquinas antes de subir la imagen?

Deja la máscara exterior al sistema. Usa la imagen original y la vista de plataforma para evaluar los márgenes, sin incorporar una forma de pantalla de inicio a cada archivo exportado.

¿Se crean automáticamente las apariencias oscuras y tintadas?

El generador actual no las produce. Conserva o crea las variantes que requiera tu proyecto mediante el flujo correspondiente de Apple.

¿Una compilación correcta garantiza la aceptación en App Store?

No. Demuestra la integración local. Los requisitos de la tienda, los metadatos y la revisión son pasos independientes. Consulta la guía de tamaños y la documentación de Apple para preparar la publicación.

Completa la importación en Xcode

Mantén coherentes la imagen de origen, el conjunto importado y la configuración del destino. Compila el esquema exacto y registra el aspecto instalado junto a la versión de la herramienta. Si todavía necesitas crear el diseño, empieza por la guía de creación de iconos.