Premiers pas avec Meta Quest 3 Qt Quick, 3D, XR, types QML

Premiers pas avec Apple Vision Pro

Introduction

Ce guide vous aidera à vous lancer dans le développement d’applications pour visionOS™.

Avant de commencer, il est essentiel de comprendre qu’il existe deux façons de développer des applications pour visionOS. La première méthode, que nous aborderons ici, permet de créer des applications « à faible immersion ». Ces applications peuvent être développées comme n’importe quelle application iPad/iOS classique et déployées sur visionOS ; elles s’exécutent en mode fenêtré et ressemblent à une application iPad classique flottant dans votre environnement de réalité virtuelle.

Remarque : les applications spécifiquesà visionOS peuvent également être placées en mode « faible immersion » et fonctionneront alors essentiellement de la même manière qu’une application iPad/iOS.

Nous appellerons la deuxième méthode « développement d’applications à forte immersion ». Ces applications sont développées à l’aide du SDK visionOS et s’exécutent en mode « plein écran », ce qui signifie qu’ QtQuick3D prend le contrôle total du rendu, à quelques exceptions près (comme la vidéo en pass-through des mains).

Remarque : visionOS prend en charge la transition des applications entre ces deux états, mais cette fonctionnalité n’est pas prise en charge par QtQuick3D.Xr.

Remarque : le développement pour visionOS nécessite du matériel Apple équipé d’Apple Silicon.

Remarque : il n’existe pas de version binaire de Qt pour visionOS. Vous devrez compiler Qt à partir du code source. Consultez la section « Compiler Qt pour visionOS » pour plus d’informations.

Déploiement d’une application à faible immersion

Pour déployer une application iPad/iOS sur visionOS, compilez et déployez l’application comme vous le feriez normalement pour iOS/iPad.

Compilation de Qt pour visionOS

Pour compiler Qt pour visionOS, vous aurez besoin du code source de Qt avec Qt Quick3D ; consultez la section « Compilation des sources Qt » pour plus d’informations sur l’obtention du code source.

Configuration et compilation pour le simulateur

Une commande `configure` minimale pour compiler Qt pour le simulateur visionOS ressemblerait à ceci :

[QT_SOURCE_DIR]/configure -qt-host-path [PATH_TO_QT_HOST_BUILD] -platform macx-visionos-clang -sdk xrsimulator -submodules qtquick3d

Une fois la configuration terminée, vous pouvez procéder à la compilation à l’aide de votre outil de compilation, par exemple CMake.

Configuration et compilation pour l'appareil

Une commande « configure » minimale pour compiler Qt pour l’appareil visionOS ressemblerait à ceci :

[QT_SOURCE_DIR]/configure -qt-host-path [PATH_TO_QT_HOST_BUILD] -platform macx-visionos-clang -sdk xros -submodules qtquick3d

Une fois la configuration terminée, vous pouvez procéder à la compilation à l'aide de votre outil de compilation.

Déploiement d’une application visionOS

Pour déployer une application visionOS, vous aurez besoin d’Xcode avec les composants du SDK visionOS installés et, éventuellement, du simulateur visionOS. Consultez les versions prises en charge pour plus d’informations.

Remarque : contrairement aux applications iOS/iPad, les applications visionOS ne sont pas déployées à l’aide de Qt Creator, mais via Xcode.

Pour compiler l'un des exemples Qt pour visionOS, vous pouvez utiliser la commande suivante :

[QT_VISIONOS_BUILD]/bin/qt-cmake -B [EXAMPLE_BUILD_DIR] -S [EXAMPLE_SOURCE_DIR]

L'exécution de cette commande génère un projet Xcode que vous pouvez ouvrir dans Xcode et déployer sur l'appareil.

Premiers pas avec Meta Quest 3 Qt Quick 3D Xr QML Types

© 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.