Primeros pasos con Apple Vision Pro
Introducción
Esta guía te ayudará a dar tus primeros pasos en el desarrollo de aplicaciones para visionOS™.
Antes de empezar, es fundamental comprender que existen dos formas de desarrollar aplicaciones para visionOS. El primer método al que nos referiremos permite crear aplicaciones de «baja inmersión». Estas aplicaciones se pueden desarrollar como cualquier aplicación normal para iPad o iOS e implementarse en visionOS; se ejecutan en modo ventana y tienen el aspecto de una aplicación normal de iPad flotando en tu entorno de realidad virtual.
Nota: Las aplicaciones específicasde visionOS también pueden ejecutarse en modo de baja inmersión y, en esencia, funcionarán igual que una aplicación de iPad/iOS.
Nos referiremos al segundo método como el de creación de aplicaciones de alta inmersión. Estas aplicaciones se desarrollan utilizando el SDK de visionOS y se ejecutan en modo «pantalla completa», lo que significa que QtQuick3D asume el control total del renderizado, con algunas excepciones (como el vídeo de paso de las manos).
Nota: visionOS admite aplicaciones que cambian entre estos dos estados, pero esto no es compatible con QtQuick3D.Xr.
Nota: El desarrollo para visionOS requiere hardware de Apple con Apple Silicon.
Nota: Noexiste una versión binaria de Qt para visionOS. Tendrás que compilar Qt a partir del código fuente. Consulta «Compilación de Qt para visionOS» para obtener más información.
Implementación de una aplicación de baja inmersión
Para implementar una aplicación de iPad/iOS en visionOS, compila e implementa la aplicación como lo harías normalmente para iOS/iPad.
Compilación de Qt para visionOS
Para compilar Qt para visionOS, necesitarás el código fuente de Qt con Qt Quick3D; consulta «Compilación de Qt» para obtener más información sobre cómo conseguir el código fuente.
Configuración y compilación para el simulador
Un comando «configure» mínimo para compilar Qt para el simulador de visionOS tendría este aspecto:
[QT_SOURCE_DIR]/configure -qt-host-path [PATH_TO_QT_HOST_BUILD] -platform macx-visionos-clang -sdk xrsimulator -submodules qtquick3dTras la configuración, puede compilar utilizando su herramienta de compilación, por ejemplo, CMake.
Configuración y compilación para el dispositivo
Un comando «configure» mínimo para compilar Qt para el dispositivo visionOS tendría este aspecto:
[QT_SOURCE_DIR]/configure -qt-host-path [PATH_TO_QT_HOST_BUILD] -platform macx-visionos-clang -sdk xros -submodules qtquick3dTras la configuración, puedes compilar utilizando tu herramienta de compilación.
Implementación de una aplicación de visionOS
Para implementar una aplicación de visionOS, necesitarás Xcode con los componentes del SDK de visionOS instalados y, opcionalmente, el simulador de visionOS. Consulta las versiones compatibles para obtener más información.
Nota: A diferencia de las aplicaciones para iOS/iPad, las aplicaciones de visionOS no se implementan mediante Qt Creator, sino a través de Xcode.
Para compilar uno de los ejemplos de Qt para visionOS, puedes utilizar el siguiente comando:
[QT_VISIONOS_BUILD]/bin/qt-cmake -B [EXAMPLE_BUILD_DIR] -S [EXAMPLE_SOURCE_DIR]Al ejecutar este comando se genera un proyecto de Xcode que puedes abrir en Xcode e implementar en el dispositivo.
© 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.