Portage sur iOS
Dans cette section, nous allons porter une application Qt existante vers iOS et la déployer sur l'appareil.
La plupart des applications Qt devraient être facilement portables sur iOS, à moins qu'elles ne dépendent d'une caractéristique matérielle ou logicielle spécifique qui n'est pas prise en charge par iOS. Une grande partie de l'effort de portage consiste à s'assurer que tous les actifs de l'application (par exemple, les fichiers QML, les images et les icônes) sont déployés correctement sur l'appareil.
Comme la plupart des applications d'interface utilisateur, les applications Qt dépendent également de ressources telles que des images, des icônes, des fichiers de traduction, etc. Ces ressources doivent être mises à disposition sur l'appareil car elles sont nécessaires au bon fonctionnement de l'application.
L'option la plus pratique consiste à regrouper les ressources dans un fichier qrc, qui est intégré au binaire de l'application. Cette approche réduit considérablement l'effort de portage et permet un accès plus rapide aux ressources. Il s'agit également d'une approche multiplateforme, qui facilite le portage sur d'autres plateformes.
Par défaut, toutes les applications Qt peuvent accéder au contenu d'un fichier qrc en utilisant le préfixe ":/" ou le préfixe du schéma d'URL, "qrc :". Pour en savoir plus sur les fichiers qrc et leur gestion, voir le système de ressources Qt.
Les instructions suivantes vous guident pas à pas pour porter une application Qt Quick existante sur iOS en utilisant l'approche qrc :
- Ouvrez le projet existant dans Qt Creator et configurez-le avec iOS ou iOS Simulator kit. Pour plus d'informations, voir Qt Creator: Configuration des projets.
- Mettez à jour toutes les importations de répertoires locaux dans les fichiers
qmlpour utiliser un espace de noms local. Par exemple, pour importer les documents QML dans le répertoire "contents" relatif àmain.qml, utilisez l'instruction d'importation suivante :import "contents" as Contents - Identifiez toutes les ressources utilisées par votre application et ajoutez-les à un ou plusieurs fichiers qrc. Qt Creator met à jour votre fichier de projet qmake avec la variable
RESOURCES, listant les fichiers qrc que vous avez ajoutés. - Pour charger les ressources dans le fichier qrc ou y faire référence à partir d'un fichier C++, utilisez le préfixe "
qrc:" - pour l'URL. Par exemple :
QQuickView viewer; viewer.setSource(QUrl("qrc:qml/main.qml")); viewer.show();
Note : Les documents QML peuvent faire référence à des fichiers dans les ressources en utilisant simplement le chemin d'accès relatif au document. Ces références ne nécessitent pas le préfixe "
qrc:" ou "
:/".
- Mettez à jour les paramètres " Run " de votre projet comme décrit dans Qt Creator: Configurer les projets pour l'exécution de
- Si votre application utilise des importations ou des plugins qui dépendent de modules Qt spéciaux, ces modules Qt doivent être ajoutés à votre fichier de configuration de construction. Par exemple, si votre application utilise l'importation Qt Multimedia dans QML, vous devez ajouter ce qui suit à votre fichier
.proouCMakeLists.txt:
find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(my_project PRIVATE Qt6::Multimedia)
QT += multimedia
Dans Qt pour iOS, tout est compilé statiquement et placé dans le paquet d'applications. Les applications sont placées dans un "bac à sable" à l'intérieur de leurs paquets et ne peuvent pas utiliser de fichiers d'objets partagés. Pour cette raison, les plugins utilisés par les modules Qt doivent également être liés de manière statique. Pour ce faire, définissez les plugins requis à l'aide de la variable QTPLUGIN.
- Enregistrez les modifications apportées à votre projet et exécutez l'application.
Qt Creator déploie votre application sur l'appareil iOS, si l'appareil est détecté et configuré correctement dans Xcode. Il est également possible de tester l'application dans le simulateur iOS. Pour plus d'informations, voir Connexion des appareils iOS.
Voir aussi Notes de plateforme - iOS.
© 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.