En esta página

Qt para iOS

Qt para iOS permite desarrollar aplicaciones para los dispositivos iPhone y iPad de Apple, así como para el Apple Vision Pro.

Para desarrollar con Qt para iOS, sigue la guía de introducción; a continuación, explora los ejemplos para iOS y los temas relacionados.

Configuraciones compatibles

Qt 6.12 es compatible con las siguientes versiones del entorno de compilación y de la plataforma de ejecución de destino.

Entorno de compilaciónPlataforma de destinoArquitectura
Xcode 16 (SDK de iOS 18) o superioriOS 18 o superior (incluido iOS 26)armv8, arm64

Nota: La promesa de compatibilidad con futuras versiones de iOSpor parte de Apple garantiza, en general, que las aplicaciones Qt sigan funcionando correctamente en las nuevas versiones del sistema operativo. Los problemas que puedan surgir se priorizan y se programan de acuerdo con las políticas de ramificación y soporte de Qt. El soporte para las nuevas funciones del sistema operativo no suele incluirse en las versiones de parches.

Dispositivos de destino utilizados en las pruebas automatizadas
DispositivoVersión del sistema operativoArquitecturaFormato
iPhone 12iOS 17armv8 (arm64)Móvil
iPhone 11iOS 17armv8 (arm64)Móvil
iPad Pro, 3.ª generacióniOS 17armv8 (arm64)Tableta
iPad, 6.ª generacióniOS 17armv8 (arm64)Tableta
iPad, 9.ª generacióniOS 18armv8 (arm64)Tableta
iPhone 16eiOS 18armv8 (arm64)Móvil
iPad Air M3iOS 18armv8 (arm64)Tableta

Entorno de compilación

El entorno de compilación para iOS lo proporciona la aplicación Xcode de Apple, que incluye tanto la cadena de herramientas (compilador, enlazador y otras herramientas) como el SDK de la plataforma iOS (cabeceras y bibliotecas) con el que se compila y se enlaza. En conjunto, estos elementos definen cómo se compila la aplicación.

Apple suele recomendar (y, en el caso de la App Store, exige) que las aplicaciones se compilen con el último SDK disponible, por lo que siempre debes utilizar la última versión de Xcode de Apple. Esto puede requerir actualizar la versión de macOS de tu sistema, ya que es posible que las nuevas versiones de Xcode no funcionen en versiones anteriores de macOS.

Nota: El entorno de compilación de iOS viene definido siempre en su totalidad por la versión de Xcode (su cadena de herramientas y sus SDK) que estés utilizando, yno por la versión de macOS en la que ejecutes Xcode.

Excluirse de los cambios de comportamiento

Una salvedad a tener en cuenta al utilizar la última versión de Xcode y el SDK para compilar tu aplicación es que los marcos del sistema iOS a veces decidirán si habilitan o no los cambios de comportamiento en función del SDK con el que hayas compilado tu aplicación.

Esta técnica permite a Apple garantizar que los binarios compilados con SDK más antiguos sigan funcionando sin regresiones en las versiones más recientes de iOS.

Por ejemplo, cuando se introdujo el modo oscuro en macOS 10.14 Mojave, macOS solo consideraba que las aplicaciones compiladas con el SDK 10.14 eran compatibles con el modo oscuro, mientras que las aplicaciones compiladas con SDK anteriores mantenían el aspecto predeterminado del modo claro.

Compilar con una versión anterior de Xcode, utilizando un SDK anterior, es una forma de evitar estos cambios de comportamiento, pero es una solución de último recurso y solo debe aplicarse si tu aplicación no tiene otras formas de solucionar el problema.

Plataformas de destino

La compilación para iOS utiliza una técnica denominada «enlace débil» que permite compilar la aplicación utilizando los encabezados y las bibliotecas del SDK más reciente de la plataforma, al tiempo que permite que la aplicación se implemente en versiones de iOS anteriores a la versión del SDK. Cuando el binario se ejecuta en una versión de iOS anterior a la del SDK con el que se compiló, Qt comprueba en tiempo de ejecución si una característica de la plataforma está disponible antes de utilizarla.

En teoría, esto permitiría ejecutar la aplicación en todas y cada una de las versiones de iOS lanzadas, pero por razones prácticas (y técnicas) existe un límite mínimo en este rango, conocido como «objetivo de implementación » de la aplicación. Si el binario se ejecuta en una versión de iOS inferior al objetivo de implementación, Qt mostrará un mensaje de error y la aplicación no se ejecutará.

Qt expresa el objetivo de implementación a través de las variables CMAKE_OSX_DEPLOYMENT_TARGET o QMAKE_MACOSX_DEPLOYMENT_TARGET, que por defecto está establecido en el objetivo de implementación mínimo compatible con Qt.

Solo es necesario aumentar el objetivo de implementación si tu propio código utiliza API que se añadieron en una versión de iOS superior a la predeterminada por Qt y no estás utilizando comprobaciones de « @available » para proteger su uso en tiempo de ejecución.

Para aumentar el objetivo de implementación con CMake:

set(CMAKE_OSX_DEPLOYMENT_TARGET "42.0")

o con qmake:

QMAKE_MACOSX_DEPLOYMENT_TARGET = 42.0

Nota: Nodebes reducir el destino de implementación por debajo del valor predeterminado establecido por Qt. Si lo haces, es probable que se produzcan fallos en tiempo de ejecución si el binario se implementa en una versión de iOS inferior a la que Qt esperaba que se ejecutara.

Para obtener más información sobre el desarrollo basado en SDK en plataformas de Apple, consulta la documentación para desarrolladores de Apple.

Primeros pasos

Instalación de Xcode

Xcode es un requisito imprescindible para desarrollar con Qt para iOS. Se puede instalar desde la App Store o descargar desde la página web para desarrolladores de Apple.

Una vez instalado, ejecuta Xcode una vez para que instale las dependencias necesarias.

A continuación, comprueba que el sistema está utilizando la instalación correcta de Xcode mediante la herramienta « xcode-select ».

$ xcode-select -print-path
/Applications/Xcode.app/Contents/Developer

Si el resultado no coincide con lo esperado, selecciona explícitamente la instalación de Xcode.

$ sudo xcode-select --switch /Applications/Xcode.app

La arquitectura de las bibliotecas del simulador de Qt para iOS es « x86_64 », lo que significa que el simulador de iOS debe ejecutarse bajo Rosetta en los Mac con Apple Silicon. En Xcode 26 y versiones posteriores, esto requiere eliminar el componente de plataforma iOS instalado por defecto en la configuración de Xcode y, a continuación, instalar manualmente el componente de plataforma iOS universal:

xcodebuild -downloadPlatform iOS -architectureVariant universal

Para probar aplicaciones Qt en el simulador que viene con Xcode, esto es todo lo que necesitas. Sin embargo, para ejecutar aplicaciones en un dispositivo físico y/o publicarlas en la App Store, debes unirte al Programa para Desarrolladores de Apple y configurar certificados de desarrollador y perfiles de aprovisionamiento.

Antes de compilar cualquier aplicación Qt, debes comprobar que Xcode esté configurado correctamente, por ejemplo, ejecutando una de las plantillas de aplicación estándar de Xcode en tu dispositivo.

Instalación o compilación de Qt

Para instalar o compilar Qt, sigue la guía general de introducción a Qt.

Compilación de aplicaciones desde la línea de comandos

Utiliza CMake o qmake para definir cómo compilar tu aplicación para iOS. Tanto CMake como qmake pueden generar un archivo « xcodeproj », que luego se puede cargar y compilar desde la línea de comandos.

Uso de CMake

El script de ayuda « qt-cmake », que se encuentra en <Qt-dir>/<version>/ios/bin/, se encargará de configurar la cadena de herramientas y las arquitecturas adecuadas por ti.

Cómo utilizar el script de ayuda « qt-cmake »:

<Qt-dir>/<version>/ios/bin/qt-cmake <source-dir>

Con el archivo « xcodeproj » generado, puedes utilizar Xcode para compilar tu aplicación o ejecutar « xcodebuild » desde la línea de comandos. Para obtener una lista de los objetivos y esquemas disponibles para tu aplicación, ejecuta el siguiente comando:

xcodebuild -list -project <your-app>.xcodeproj

A continuación, ejecuta xcodebuild build, indicando los datos de tu aplicación:

xcodebuild build -allowProvisioningUpdates -project <your-app>.xcodeproj -scheme <your-scheme> -configuration Debug -destination "generic/platform=iOS" -destination-timeout 1 ENABLE_ONLY_ACTIVE_RESOURCES=NO

Uso de qmake

En primer lugar, define cómo compilar la aplicación utilizando qmake. A continuación, utiliza el archivo « xcodeproj » generado para compilar la aplicación, ya sea en Xcode o desde la línea de comandos.

qmake <your-app>.pro

qmake crea un archivo Makefile envolvente que, a su vez, llama a xcodebuild, por lo que puedes ejecutar make para compilar tu aplicación:

make -j8

Ten en cuenta que debes volver a importar el proyecto si cambia su configuración, por ejemplo, al añadir o eliminar archivos fuente.

Personalización de la configuración del proyecto de Xcode

La variable qmake ` QMAKE_MAC_XCODE_SETTINGS ` se puede utilizar para personalizar la configuración de Xcode, por ejemplo:

development_team.name = DEVELOPMENT_TEAM
development_team.value = <your-team-id>
QMAKE_MAC_XCODE_SETTINGS += development_team

También resultan útiles otras variables de qmake:

QMAKE_TARGET_BUNDLE_PREFIX = com.<your-company>
QMAKE_BUNDLE = <your-app>

Ejecución de aplicaciones en Xcode

Los proyectos de Xcode generados por qmake y CMake permiten ejecutar la aplicación tanto en dispositivos iOS como en el simulador de iOS.

Nota: Dado que la arquitectura predeterminada de las bibliotecas del simulador de Qt para iOS es « x86_64 », la aplicación debe ejecutarse bajo Rosetta en los Mac con Apple Silicon. Si los destinos de ejecución basados en Rosetta no aparecen en el menú de destinos de ejecución de Xcode, se pueden habilitar a través del menú « Product > Destination > Destination Architectures ».

Compilación y ejecución de aplicaciones con Qt Creator

Puedes encontrar información sobre cómo configurar y ejecutar aplicaciones de Qt para iOS en la documentación de Qt Creator:

Ten en cuenta que para ello sigue siendo necesaria una instalación de Xcode que funcione correctamente.

Ejemplos para iOS

En Qt Creator se pueden consultar ejemplos probados en iOS. Utiliza la palabra clave « ios » para buscar ejemplos en el modo « Qt Creator Welcome». Ten en cuenta que algunos ejemplos pueden tener una funcionalidad limitada.

Para ver una lista de ejemplos que se sabe que funcionan en dispositivos iOS, visita Ejemplos de Qt para iOS.

Los siguientes temas ofrecen más detalles sobre Qt para iOS:

Uso de código Objective-C en aplicaciones Qt

Clang, el compilador utilizado para aplicaciones en plataformas de Apple, permite mezclar código C++ y Objective-C. Para habilitar este modo, utiliza la extensión « .mm » en los archivos fuente correspondientes y añádelos a tu proyecto como de costumbre.

Con CMake:

target_sources(myapp PRIVATE objc_code.mm)

Con qmake:

SOURCES += objc_code.mm

De este modo, podrás utilizar los marcos de trabajo de Objective-C de la biblioteca para desarrolladores de Apple en tus aplicaciones Qt.

Para hacer que la funcionalidad esté disponible para el resto de la aplicación, sin tener que renombrar todos los archivos fuente, declara funciones auxiliares en un archivo de cabecera e implementa la funcionalidad en un archivo fuente de Objective-C++:

// objc_code.h
QString localizedHostName();

// objc_code.mm
#include <Foundation/NSHost.h>
QString localizedHostName()
{
    return QString::fromNSString(NSHost.currentHost.localizedName);
}

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.