Erste Schritte mit Apple Vision Pro

Einführung

Dieser Leitfaden soll Ihnen den Einstieg in die Entwicklung von Anwendungen für visionOS.

Bevor Sie beginnen, ist es wichtig zu verstehen, dass es zwei Möglichkeiten gibt, Anwendungen für visionOS zu entwickeln. Die erste Methode, auf die wir uns beziehen werden, produziert "Low-Immersion"-Anwendungen. Diese Anwendungen können wie eine normale iPad/iOS-Anwendung entwickelt und für visionOS bereitgestellt werden. Diese Anwendungen laufen im Fenstermodus und sehen aus wie eine normale iPad-Anwendung, die in Ihrer VR-Umgebung schwebt.

Hinweis: visionOS-spezifische Anwendungen können auch in den Low-Immersion-Modus versetzt werden und funktionieren dann im Wesentlichen wie eine iPad/iOS-Anwendung.

Die zweite Methode bezeichnen wir als High-Immersion-Anwendungen. Diese Anwendungen werden mit dem visionOS SDK entwickelt und im "Vollbildmodus" ausgeführt, d. h. QtQuick3D übernimmt die vollständige Kontrolle über das Rendering, mit einigen Ausnahmen (z. B. Pass-Through-Video der Hände).

Hinweis: visionOS unterstützt Anwendungen, die zwischen diesen beiden Zuständen wechseln, aber dies wird von QtQuick3D.Xr nicht unterstützt.

Hinweis: Die Entwicklung für visionOS erfordert Apple-Hardware mit Apple Silicon.

Hinweis: Es gibt kein binäres Build von Qt für visionOS. Sie müssen Qt aus dem Quellcode erstellen. Weitere Informationen finden Sie unter Erstellen von Qt für visionOS.

Bereitstellen einer Low-Immersion-Anwendung

Um eine iPad/iOS-Anwendung für visionOS bereitzustellen, erstellen Sie die Anwendung wie gewohnt für iOS/iPad und stellen sie bereit.

Erstellen von Qt für visionOS

Um Qt für visionOS zu erstellen, benötigen Sie den Qt-Quellcode mit Qt Quick3D; weitere Informationen zum Erhalt des Quellcodes finden Sie unter Erstellen von Qt-Quellen.

Konfigurieren und Bauen für den Simulator

Ein minimaler configure-Befehl zur Erstellung von Qt für den visionOS-Simulator würde wie folgt aussehen:

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

Nach der Konfiguration können Sie mit Ihrem Build-Tool, z. B. CMake, bauen.

Konfigurieren und Bauen für das Gerät

Ein minimaler configure-Befehl für die Erstellung von Qt für das visionOS-Gerät würde wie folgt aussehen:

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

Nach der Konfiguration können Sie mit Ihrem Build-Tool bauen.

Bereitstellen einer visionOS-Anwendung

Um eine visionOS-Anwendung bereitzustellen, benötigen Sie Xcode mit den installierten visionOS-SDK-Komponenten und optional den visionOS-Simulator. Weitere Informationen finden Sie unter Unterstützte Versionen.

Hinweis: Im Gegensatz zu den iOS/iPad-Anwendungen werden visionOS-Anwendungen nicht mit Qt Creator, sondern mit Xcode bereitgestellt.

Um eines der Qt-Beispiele für visionOS zu erstellen, können Sie den folgenden Befehl verwenden:

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

Die Ausführung dieses Befehls erzeugt ein Xcode-Projekt, das Sie in Xcode öffnen und auf dem Gerät bereitstellen können.

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