{"id":4056,"date":"2024-12-11T18:49:01","date_gmt":"2024-12-11T15:49:01","guid":{"rendered":"https:\/\/demensdeum.com\/blog\/2024\/12\/11\/dynamic-linking-qt-app-macos\/"},"modified":"2024-12-16T22:32:09","modified_gmt":"2024-12-16T19:32:09","slug":"dynamic-linking-qt-app-macos","status":"publish","type":"post","link":"https:\/\/demensdeum.com\/blog\/fr\/2024\/12\/11\/dynamic-linking-qt-app-macos\/","title":{"rendered":"Liaison dynamique des applications Qt sur macOS"},"content":{"rendered":"

Aujourd’hui, j’ai publi\u00e9 une version de RaidenVideoRipper pour les appareils Apple \u00e9quip\u00e9s de processeurs macOS et M1\/M2\/M3\/M4 (Apple Silicon). RaidenVideoRipper est une application de montage vid\u00e9o rapide qui vous permet de couper une partie d’un fichier vid\u00e9o dans un nouveau fichier. Vous pouvez \u00e9galement cr\u00e9er des gifs et exporter la piste audio au format mp3.<\/p>\n

Ensuite, je d\u00e9crirai bri\u00e8vement les commandes que j’ai utilis\u00e9es pour accomplir cela. La th\u00e9orie de ce qui se passe ici, la documentation des utilitaires, peut \u00eatre lue sur les liens suivants :
\nhttps:\/\/www.unix.com\/man-page\/osx\/1\/otool\/<\/a>
\nhttps:\/\/www.unix.com\/man-page\/osx\/1\/install_name_tool\/<\/a>
\nhttps:\/\/llvm.org\/docs\/CommandGuide\/llvm-nm.html<\/a>
\nhttps:\/\/linux.die.net\/man\/1\/file<\/a>
\nhttps:\/\/www.unix.com\/man-page\/osx\/8\/SPCTL\/<\/a>
\nhttps:\/\/linux.die.net\/man\/1\/chmod<\/a>
\nhttps:\/\/linux.die.net\/man\/1\/ls<\/a>
\nhttps:\/\/man7.org\/linux\/man-pages\/man7\/xattr.7.html<\/a>
\nhttps:\/\/doc.qt.io\/qt-6\/macos-deployment.html<\/a><\/p>\n

Pour commencer, installez Qt sur votre macOS et installez \u00e9galement l’environnement pour Qt Desktop Development. Apr\u00e8s cela, assemblez votre projet, par exemple, dans Qt Creator, puis je d\u00e9crirai ce qui est n\u00e9cessaire pour garantir que les d\u00e9pendances avec des biblioth\u00e8ques dynamiques externes sont trait\u00e9es correctement lors de la distribution de l’application aux utilisateurs finaux.<\/p>\n

Cr\u00e9ez un r\u00e9pertoire Frameworks dans le dossier YOUR_APP.app\/Contents de votre application et placez-y des d\u00e9pendances externes. Par exemple, voici \u00e0 quoi ressemble le Frameworks de l’application RaidenVideoRipper\u00a0:<\/p>\n

\n
Frameworks\n\u251c\u2500\u2500 DullahanFFmpeg.framework\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 dullahan_ffmpeg.a\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 libavcodec.60.dylib\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 libavdevice.60.dylib\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 libavfilter.9.dylib\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 libavformat.60.dylib\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 libavutil.58.dylib\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 libpostproc.57.dylib\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 libswresample.4.dylib\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 libswscale.7.dylib\n\u251c\u2500\u2500 QtCore.framework\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Headers -> Versions\/Current\/Headers\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 QtCore -> Versions\/Current\/QtCore\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Resources -> Versions\/Current\/Resources\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 Versions\n\u251c\u2500\u2500 QtGui.framework\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Headers -> Versions\/Current\/Headers\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 QtGui -> Versions\/Current\/QtGui\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Resources -> Versions\/Current\/Resources\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 Versions\n\u251c\u2500\u2500 QtMultimedia.framework\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Headers -> Versions\/Current\/Headers\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 QtMultimedia -> Versions\/Current\/QtMultimedia\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Resources -> Versions\/Current\/Resources\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 Versions\n\u251c\u2500\u2500 QtMultimediaWidgets.framework\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Headers -> Versions\/Current\/Headers\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 QtMultimediaWidgets -> Versions\/Current\/QtMultimediaWidgets\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Resources -> Versions\/Current\/Resources\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 Versions\n\u251c\u2500\u2500 QtNetwork.framework\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Headers -> Versions\/Current\/Headers\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 QtNetwork -> Versions\/Current\/QtNetwork\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Resources -> Versions\/Current\/Resources\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 Versions\n\u2514\u2500\u2500 QtWidgets.framework\n    \u251c\u2500\u2500 Headers -> Versions\/Current\/Headers\n    \u251c\u2500\u2500 QtWidgets -> Versions\/Current\/QtWidgets\n    \u251c\u2500\u2500 Resources -> Versions\/Current\/Resources\n    \u2514\u2500\u2500 Versions\n<\/code><\/pre>\n<\/div>\n
Pour plus de simplicit\u00e9, j’ai imprim\u00e9 uniquement le deuxi\u00e8me niveau d’imbrication.<\/p>\n
Ensuite, nous imprimons les d\u00e9pendances dynamiques actuelles de votre application\u00a0:<\/p>\n
\n
otool -L RaidenVideoRipper \n<\/code><\/pre>\n<\/div>\n
Sortie pour le binaire RaidenVideoRipper, qui se trouve dans RaidenVideoRipper.app\/Contents\/MacOS\u00a0:<\/p>\n
\n
RaidenVideoRipper:\n\t@rpath\/DullahanFFmpeg.framework\/dullahan_ffmpeg.a (compatibility version 0.0.0, current version 0.0.0)\n\t@rpath\/QtMultimediaWidgets.framework\/Versions\/A\/QtMultimediaWidgets (compatibility version 6.0.0, current version 6.8.1)\n\t@rpath\/QtWidgets.framework\/Versions\/A\/QtWidgets (compatibility version 6.0.0, current version 6.8.1)\n\t@rpath\/QtMultimedia.framework\/Versions\/A\/QtMultimedia (compatibility version 6.0.0, current version 6.8.1)\n\t@rpath\/QtGui.framework\/Versions\/A\/QtGui (compatibility version 6.0.0, current version 6.8.1)\n\t\/System\/Library\/Frameworks\/AppKit.framework\/Versions\/C\/AppKit (compatibility version 45.0.0, current version 2575.20.19)\n\t\/System\/Library\/Frameworks\/ImageIO.framework\/Versions\/A\/ImageIO (compatibility version 1.0.0, current version 1.0.0)\n\t\/System\/Library\/Frameworks\/Metal.framework\/Versions\/A\/Metal (compatibility version 1.0.0, current version 367.4.0)\n\t@rpath\/QtNetwork.framework\/Versions\/A\/QtNetwork (compatibility version 6.0.0, current version 6.8.1)\n\t@rpath\/QtCore.framework\/Versions\/A\/QtCore (compatibility version 6.0.0, current version 6.8.1)\n\t\/System\/Library\/Frameworks\/IOKit.framework\/Versions\/A\/IOKit (compatibility version 1.0.0, current version 275.0.0)\n\t\/System\/Library\/Frameworks\/DiskArbitration.framework\/Versions\/A\/DiskArbitration (compatibility version 1.0.0, current version 1.0.0)\n\t\/System\/Library\/Frameworks\/UniformTypeIdentifiers.framework\/Versions\/A\/UniformTypeIdentifiers (compatibility version 1.0.0, current version 709.0.0)\n\t\/System\/Library\/Frameworks\/AGL.framework\/Versions\/A\/AGL (compatibility version 1.0.0, current version 1.0.0)\n\t\/System\/Library\/Frameworks\/OpenGL.framework\/Versions\/A\/OpenGL (compatibility version 1.0.0, current version 1.0.0)\n\t\/usr\/lib\/libc++.1.dylib (compatibility version 1.0.0, current version 1800.101.0)\n\t\/usr\/lib\/libSystem.B.dylib (compatibility version 1.0.0, current version 1351.0.0)\n<\/code><\/pre>\n<\/div>\n
Comme on peut le voir dans RaidenVideoRipper dans les d\u00e9pendances Qt et dullahan_ffmpeg. Dullahan FFmpeg est un fork de FFmpeg qui encapsule ses fonctionnalit\u00e9s dans une biblioth\u00e8que dynamique, avec la possibilit\u00e9 d’obtenir la progression et l’annulation de l’ex\u00e9cution en cours \u00e0 l’aide de routines C.
\nEnsuite, remplacez les chemins de l’application et toutes les biblioth\u00e8ques n\u00e9cessaires \u00e0 l’aide de install_name_tool.<\/p>\n
La commande pour cela est\u00a0:<\/p>\n
\n
install_name_tool -change old_path new_path target\n<\/code><\/pre>\n<\/div>\n
Exemple d’utilisation\u00a0:<\/p>\n
\n
install_name_tool -change \/usr\/local\/lib\/libavfilter.9.dylib @rpath\/DullahanFFmpeg.framework\/libavfilter.9.dylib dullahan_ffmpeg.a\n<\/code><\/pre>\n<\/div>\n
Apr\u00e8s avoir saisi tous les chemins corrects, l\u2019application devrait d\u00e9marrer correctement. V\u00e9rifiez que tous les chemins d’acc\u00e8s aux biblioth\u00e8ques sont relatifs, transf\u00e9rez le binaire et rouvrez-le.
\nSi vous voyez une erreur, v\u00e9rifiez les chemins via otool et modifiez \u00e0 nouveau via install_name_tool.<\/p>\n
Il y a aussi une erreur de confusion des d\u00e9pendances, lorsque la biblioth\u00e8que que vous avez remplac\u00e9e n’a pas de symbole dans le tableau vous pouvez v\u00e9rifier la pr\u00e9sence ou l’absence d’un symbole comme ceci :<\/p>\n
\n
nm -gU path\n<\/code><\/pre>\n<\/div>\n
Une fois ex\u00e9cut\u00e9, vous verrez toute la table des symboles de la biblioth\u00e8que ou de l’application.
\nIl est \u00e9galement possible que vous ayez copi\u00e9 les d\u00e9pendances d’une mauvaise architecture, vous pouvez le v\u00e9rifier \u00e0 l’aide du fichier\u00a0:<\/p>\n
\n
file path\n<\/code><\/pre>\n<\/div>\n
L’utilitaire de fichiers vous montrera \u00e0 quelle architecture appartient la biblioth\u00e8que ou l’application.<\/p>\n
Qt n\u00e9cessite \u00e9galement un dossier Plugins dans le dossier Contents de votre r\u00e9pertoire YOUR_APP.app, copiez les plugins de Qt vers Contents. Ensuite, v\u00e9rifiez la fonctionnalit\u00e9 de l’application, apr\u00e8s quoi vous pourrez commencer \u00e0 optimiser le dossier Plugins, \u00e0 supprimer des \u00e9l\u00e9ments de ce dossier et \u00e0 tester l’application.<\/p>\n
S\u00e9curit\u00e9 macOS<\/h2>\n
Apr\u00e8s avoir copi\u00e9 toutes les d\u00e9pendances et corrig\u00e9 les chemins pour les liens dynamiques, vous devrez signer l’application avec la signature du d\u00e9veloppeur et envoyer en outre la version de l’application \u00e0 Apple pour l\u00e9galisation.<\/p>\n
Si vous ne disposez pas de 100 $ pour une licence de d\u00e9veloppeur ou si vous ne souhaitez rien signer, \u00e9crivez des instructions \u00e0 vos utilisateurs sur la fa\u00e7on de lancer l’application.<\/p>\n
Cette instruction fonctionne \u00e9galement pour RaidenVideoRipper\u00a0:<\/p>\n