Cómo preparar tu app para iPhone Duo: checklist por prioridades

iPhone Duo salió a la venta el 23 de octubre de 2026 con iOS 27.1. Si necesitas preparar tu app para iPhone Duo, te estás adaptando a dos pantallas, una bisagra, una cámara en el lateral y barras que se mueven al borde. Es mucha superficie, así que esta checklist ordena el trabajo: primero los arreglos que ayudan a cualquier app y después los retoques específicos del dispositivo.

Este artículo es el punto de partida de nuestra serie para desarrolladores sobre iPhone Duo. Cada paso enlaza a una guía más detallada. Se basa en los Tech Talks de Apple, las páginas de Apple sobre iPhone Duo, los Apple Developer Forums e informes de desarrolladores. El equipo de AppleDuo no ha probado estas API en hardware, y la mayoría son nuevas en iOS 27 o iOS 27.1, así que los detalles pueden cambiar entre versiones.

¿Qué les pasa en iPhone Duo a las apps compiladas con SDK anteriores?

Tu app ya funciona en iPhone Duo. Su aspecto depende del SDK con el que la compilaste. La página de preparación para iPhone Duo de Apple describe tres niveles:

La recomendación de Apple es asegurarte de que tu contenido se adapta a las barras verticales antes de publicar con el SDK de 27.1. Esperar tampoco es una opción a largo plazo: Apple dice que, a partir de abril de 2027, las subidas al App Store deberán usar el SDK de iOS 27 o posterior.

¿Cuál es la checklist para preparar una app para iPhone Duo?

Este es el orden que recomendamos, según cuánto arregla cada paso en relación con el esfuerzo. Los tres primeros son lo que sugiere Sarun Wongpatcharapakorn si tienes poco tiempo para adaptar tu app.

¿Cómo arreglo primero las size classes, los márgenes de diseño y las áreas seguras?

Las size classes dirigen la mayor parte del diseño en iPhone Duo. El Tech Talk de Apple Prepare your app for iPhone Duo las enumera: la pantalla exterior es ancho compact y alto regular en vertical, y compact en ambas direcciones en horizontal. La pantalla interior es regular en ambas direcciones. Como dice Sarun, plegado es un iPhone; desplegado, un iPad.

El problema es que muchas apps interpretan el ancho regular como «esto es un iPad». La página de preparación de Apple dice que no lo hagas: las apps de iPhone ahora pueden tener cualquier combinación de size classes, así que ramifica según la propia size class, no según el idiom del dispositivo, la orientación o una altura fija en el código. Esta vista de SwiftUI lee el entorno y elige un diseño:

struct LibraryView: View {
    @Environment(\.horizontalSizeClass) private var horizontalSizeClass

    var body: some View {
        if horizontalSizeClass == .regular {
            TwoColumnLibrary()
        } else {
            SingleColumnLibrary()
        }
    }
}

Las áreas seguras son el segundo arreglo. En iPhone Duo, las barras verticales añaden márgenes inicial y final, y Apple advierte de que los márgenes opuestos no son iguales. Los márgenes de diseño también son asimétricos. Sarun señala que pueden ser de 20 puntos en un lado y de 0 junto a la barra. Este patrón de UIKit del Tech Talk trata cada lado por separado:

// Evitar: supone que los márgenes inicial y final coinciden
let width = view.bounds.width - view.safeAreaInsets.left * 2

// Preferible: aplica a cada borde su propio margen
let width = view.bounds.inset(by: view.safeAreaInsets).width

Mantén el contenido interactivo dentro del área segura y deja que los fondos se extiendan más allá. Nuestra guía sobre las size classes de iPhone Duo incluye la tabla completa de posturas, y áreas seguras y márgenes de contenido en iPhone Duo cubre las nuevas API de márgenes.

¿Cómo consigo la experiencia a pantalla completa en iPhone Duo?

Vuelve a compilar con Xcode 27.1, que añade soporte de desarrollo para iPhone Duo y el SDK de iOS 27.1. El Tech Talk de Apple dice que Xcode 27.1 es necesario para la experiencia a pantalla completa. Antes de hacerlo, elimina los patrones que enumera la página de preparación de Apple:

• Sustituye UIScreen.main.bounds por view.bounds o window.bounds. Apple considera UIScreen.main ambiguo en un dispositivo con dos pantallas y dice que quedará obsoleto. Lee la escala de traitCollection.displayScale.
• Sustituye UIWindow(frame: UIScreen.main.bounds) por UIWindow(windowScene:). Blake Crosley y Adapty indican que las apps compiladas con el SDK más reciente necesitan el ciclo de vida basado en escenas.
• Elimina la lógica de diseño basada en UIDevice.current.orientation o interfaceOrientation. Compara en su lugar el ancho y el alto del espacio que tienes.
• Revisa las imágenes y los vídeos a sangre que usan aspect fill. La forma de la pantalla interior puede recortar más de lo que esperas.

¿Y UIRequiresFullScreen? Apple dice que iPhone Duo sigue respetándolo, pero tu app se redimensiona igualmente cuando el dispositivo se abre o se cierra. No es una vía de escape. En la pantalla interior, el sistema también ignora tus orientaciones de interfaz compatibles y escala la app.

En los Apple Developer Forums, un evangelista de Apple dio el mismo consejo en el hilo 848047: usa size classes en lugar de comprobaciones del dispositivo y admite todas las orientaciones, ya que las apps de iPhone ahora pueden redimensionarse en iPad y en Mac mediante iPhone Mirroring.

¿Cómo cambian las barras de herramientas, la barra vertical y las sheets?

Con el SDK de iOS 27.1, las barras de navegación, las barras de herramientas y las barras de pestañas pasan a una barra vertical a lo largo de un borde en la pantalla exterior y en la pantalla interior en horizontal. El Tech Talk de Apple Raise the bar with iPhone Duo explica las reglas. Solo se mueven las barras que pertenecen a contenedores de navegación, así que las instancias personalizadas de UIToolbar, UINavigationBar o UITabBar se quedan donde están.

La barra vertical tiene un ancho fijo, así que favorece los símbolos. Los elementos con icono pasan al eje vertical y los elementos solo de texto se quedan en horizontal. El resumen de Sarun es sencillo: da a los elementos de la barra de herramientas un icono y un título, y probablemente ya estés listo. El título se sigue usando en los menús de desbordamiento. Las posiciones y el modificador siguientes están escritos tal como los muestra el Tech Talk de Apple. .topBarPinnedTrailing es nuevo en iOS 27:

.toolbar {
    ToolbarItem(placement: .cancellationAction) {
        Button("Close", systemImage: "xmark") { dismiss() }
    }
    ToolbarItem(placement: .topBarPinnedTrailing) {
        Button("Done", systemImage: "checkmark") { save() }
    }
    ToolbarItem {
        Button("Share", systemImage: "square.and.arrow.up") { share() }
    }
    .visibilityPriority(.high)
}

Atrás o Cerrar van arriba, luego la acción destacada y después el resto. Cuando se acaba el espacio, los elementos se desbordan de abajo arriba, y .visibilityPriority decide cuáles se mantienen. Un diseño de una sola página con el peso en la parte inferior, como Calculadora, puede desactivarla con .toolbarVerticalBehavior(.disabled). Nuestra guía sobre la barra de herramientas vertical de iPhone Duo cubre el desbordamiento, las vistas personalizadas y los equivalentes en UIKit.

Las sheets también cambian. En la pantalla exterior, la barra de herramientas de una sheet es vertical. En la pantalla interior, las sheets están centradas por defecto y pueden situarse en el lado inicial o final. Lee sheets y presentationPlacement en iPhone Duo para conocer los detalles.

¿Qué contenedores y API gestionan el pliegue por mí?

Empieza por los contenedores del sistema. NavigationSplitView y UISplitViewController se contraen a una sola pila cuando el dispositivo está cerrado y muestran columnas cuando está abierto. TabView se adapta a cada postura, y en la pantalla interior puedes activar una barra lateral con .defaultTabBarPlacement(.sidebar). List y ScrollView se adaptan al pliegue automáticamente.

Para diseños personalizados de dos vistas, iOS 27.1 añade ArrangementView en SwiftUI y UIArrangementViewController en UIKit, que se tratan en Strike a pose with adaptive layouts on iPhone Duo. El estilo .split reparte el espacio entre dos vistas, y .overlay las superpone hasta que el dispositivo se pliega. No pongas un ArrangementView dentro de un List, un ScrollView u otro contenedor de navegación. Consulta nuestra guía de ArrangementView.

Para los controles que colocas a mano, consulta las regiones reservadas, también nuevas en iOS 27.1. Una región de división marca el pliegue, y una región de oclusión marca la cámara FaceTime interior mientras está activa. Apple muestra la llamada de SwiftUI como proxy.reservedRegions(kind: .division) dentro de un GeometryReader. Nuestro artículo sobre regiones reservadas y el pliegue explica las regiones activas e inactivas.

La bisagra en sí es para efectos, no para el diseño. onHingeChange en SwiftUI y UIHingeInteraction en UIKit, ambos indicados como iOS 27.1 en la documentación de Apple, informan de los estados cerrado, parcialmente abierto y abierto del todo, además de un ángulo continuo. El valor de la bisagra es nil en dispositivos que no la tienen, así que compruébalo siempre. Para inspirarte, mira cómo Marbles Unhinged convierte el pliegue en una rampa y luego lee estados de la bisagra y onHingeChange.

¿Cómo pruebo las posturas de iPhone Duo y uso las agent skills de Xcode?

Selecciona el simulador de iPhone Duo en Xcode 27.1 y ejecuta tu app en Device Hub. Usa los controles en pantalla para abrir, cerrar, girar y plegar el dispositivo, y revisa cada postura: cerrado en vertical, cerrado en horizontal, abierto en vertical y abierto en horizontal. Apple también sugiere arrastrar la app a Split View en un lado y luego en el otro, para confirmar que el contenido vertical funciona en ambos. Revisa también los idiomas de derecha a izquierda, ya que la barra vertical se queda en el mismo lado del hardware.

Sarun indica que Device Hub de Xcode 27.2 también puede simular presión de memoria, animaciones a cámara lenta, una sacudida y una caída. Son útiles para comprobar que el estado sobrevive a un pliegue bajo carga.

Xcode 27 también incluye agent skills con buenas prácticas modernas y nuevas API. La página de preparación de Apple dice que puedes pedir al asistente de código de Xcode que prepare tu app para iPhone Duo («get my app ready for iPhone Duo»). Para usar las skills con otro agente de código, expórtalas con el comando que compartió Sarun:

xcrun agent skills export --output-dir ~/Downloads/xcode-skills

Si exportaste las skills antes de Xcode 27.1, vuelve a exportarlas. La skill uikit-app-modernization ahora se llama app-resizability y añade soporte para SwiftUI y iPhone Duo. Apple advierte de que la skill no lo detecta todo, así que revisa a mano los patrones anteriores.

¿Qué recursos del App Store necesito para iPhone Duo?

App Store Connect tiene un espacio para capturas de pantalla de iPhone Duo con tamaños distintos para la pantalla exterior y la interior. Cuando envías capturas para iPhone Duo, tu página de producto muestra una insignia que indica que la app está optimizada para iPhone Duo. Apple dice que las capturas serán obligatorias a partir de abril de 2027. Nuestra guía sobre tamaños de capturas del App Store para iPhone Duo incluye cada tamaño y qué mostrar en las tres primeras imágenes.

Dos tareas más completan un lanzamiento. Apple sugiere enviar una nominación para destacar la app en App Store Connect e indicar que admite iPhone Duo, incluidas todas las posturas del dispositivo. Apadmi también recomienda revisar la cobertura de App Intents. Con las nuevas capacidades de Siri en iOS 27, nuestra guía sobre App Intents y el índice semántico en iOS 27 es un buen siguiente proyecto. Para inspirarte, explora los juegos de Built for the fold, que usan la bisagra como parte de la jugabilidad.

Puntos clave

• Las apps compiladas con el SDK de iOS 26 o anterior funcionan, pero se ven con bandas vacías cuando el dispositivo está abierto. Solo el SDK de iOS 27.1 en Xcode 27.1 ocupa toda la pantalla.
• Arregla primero las size classes, los márgenes de diseño y los márgenes del área segura. Nunca supongas que el ancho regular significa iPad, ni que los márgenes opuestos coinciden.
• Da a cada elemento de la barra de herramientas un icono y un título, y usa las barras del sistema para que puedan pasar a la barra vertical.
• Usa NavigationSplitView, TabView y ArrangementView para el diseño, regiones reservadas para los controles colocados a mano y la bisagra solo para efectos.
• Prueba cada postura en Device Hub, vuelve a exportar las agent skills de Xcode después de 27.1 y añade capturas para iPhone Duo antes de abril de 2027.

Empieza por las size classes de iPhone Duo y continúa con la barra de herramientas vertical. Cuando tu app esté lista, la página Acerca de explica cómo conseguir que tu juego para iPhone Duo aparezca destacado.