Crea la estructura inicial de la app y el ciclo de compilación

Al crear una app para Mac, pídele a Codex que primero elija el modelo de escenas adecuado: WindowGroup, Window, Settings, MenuBarExtra o DocumentGroup. Así, la app tendrá una estructura nativa de escritorio desde la primera versión, en lugar de partir de una ContentView al estilo de iOS.

Usa el shell como punto de partida para compilar y ejecutar la app. Para proyectos de Xcode, usa xcodebuild. Para apps organizadas como paquetes, usa swift build y un script script/build_and_run.sh dentro del proyecto que detenga el proceso anterior, compile la app e inicie la versión recién compilada. Si lo necesitas, el script también puede mostrar registros o datos de telemetría.

Si desarrollas una app con interfaz gráfica exclusivamente con SwiftPM, empaquétala y ejecútala como .app en lugar de iniciar el ejecutable directamente. Así evitas que la app no aparezca en el Dock y que surjan problemas de activación o de identidad del paquete durante la validación local.

Aprovecha las habilidades

Agrega el complemento Build macOS Apps cuando empieces a trabajar en aspectos más específicos del escritorio. Abarca los ciclos de compilación y depuración desde el shell, el empaquetado de apps de SwiftPM, los patrones nativos de escenas y ventanas de SwiftUI, la interoperabilidad con AppKit, el registro unificado de eventos, la clasificación de fallos en las pruebas y los procesos de firma y notarización.

Para obtener más información sobre cómo instalar y usar complementos y habilidades, consulta la documentación de complementos y la documentación de habilidades.

Crea una interfaz nativa de escritorio

Da prioridad a las convenciones de Mac frente a los patrones de navegación de iOS. Usa NavigationSplitView para los diseños con barra lateral y vista de detalle, y escenas Settings explícitas para las preferencias. Usa barras de herramientas y comandos para que las acciones sean fáciles de encontrar, y elementos de la barra de menús para las utilidades ligeras que deban estar siempre disponibles.

Empieza con los materiales del sistema, los colores semánticos y los controles estándar. Agrega estilos de ventana personalizados, zonas de arrastre o superficies Liquid Glass solo cuando el producto necesite una interfaz de escritorio con un diseño propio.

Si SwiftUI cubre casi todo lo que necesitas, usa el puente con AppKit más pequeño posible para lo que falte. Algunos ejemplos son los paneles para abrir o guardar archivos, el control de qué elemento recibe primero los eventos, la validación de menús, los casos especiales de arrastrar y soltar y la integración de una NSView para un control especializado.

Depura, prueba y prepara la app para su distribución

Para comprobar el comportamiento de la app en tiempo de ejecución, pídele a Codex que agregue algunos eventos de Logger al abrir ventanas, seleccionar elementos en la barra lateral, ejecutar comandos de menú o sincronizar datos en segundo plano. Después de iniciar la app, verifica esos eventos con log stream.

Si fallan las pruebas, pídele a Codex que primero ejecute el conjunto mínimo de pruebas que permita investigar el problema con xcodebuild test o swift test. Luego, pídele que determine si se trata de un error de compilación, una aserción fallida, un cierre inesperado, un fallo intermitente o un problema del entorno o de su configuración.

Cuando pases del desarrollo local a la distribución, pídele a Codex que prepare dos procedimientos: uno para generar el archivo de distribución manualmente en Xcode y otro para generarlo y notarizarlo mediante un script en cada lanzamiento. Pídele que inspeccione el paquete de la app, sus permisos especiales y la protección reforzada del entorno de ejecución con codesign y plutil. Usa App Store Connect CLI si también quieres subir la app desde la terminal.

Ejemplo de prompt

Consejos prácticos

Define las escenas de forma explícita

Define la ventana principal, la ventana de configuración, las ventanas de utilidades y los elementos de la barra de menús como raíces de escenas independientes, en lugar de agrupar toda la app en una sola vista enorme.

Aprovecha los elementos de interfaz del sistema

Antes de crear barras laterales, barras de herramientas o materiales personalizados, comprueba si las API estándar de escenas y ventanas de SwiftUI ya ofrecen el comportamiento que buscas en Mac.

Limita el uso de AppKit a lo indispensable

Usa NSViewRepresentable, NSViewControllerRepresentable o un auxiliar de NSWindow con una función bien delimitada para incorporar una capacidad de escritorio que falte. Mantén SwiftUI como fuente de verdad para la selección y el estado de la app.

Verifica la firma y la notarización por separado de la compilación local

Que la app se inicie correctamente en tu equipo no demuestra que esté firmada ni lista para la notarización. Conserva un procedimiento manual para generar el archivo de distribución en Xcode cuando necesites verificar una versión de forma puntual. Agrega un script para repetir el archivado y la notarización en cada distribución, y ejecuta las comprobaciones con codesign y plutil cuando la tarea incluya preparar la app para su distribución, más allá del desarrollo local.