Guide de Construction

Construction de QtlMovie

Construire QtlMovie sur Mac OS

Pré-requis

QtlMovie peut être construit sur n'importe quelle plate-forme Mac OS supportant Qt 5.5 ou plus. Tous les packages de développement de Qt 5 doivent être installés, y compris QtMultimedia.

L'utilisation de Qt Creator n'est pas obligatoire. S'il est utilisé, Qt Creator version 2.7 ou plus requis. Qt Creator est recommandé pour éditer ou modifier le projet. Construire le produit sans le modifier ne nécessite pas Qt Creator.

Construire QtlMovie manuellement

Exécuter le script build/build.sh.

Construire QtlMovie avec Qt Creator

Qt Creator doit être lancé via le Launcher de Mac OS. La première fois que Qt Creator est lancé, accepter toutes les options par défaut du projet, notamment la configuration de shadow build.

Construire la documentation Doxygen

Exécuter le script build/build-doc.sh.

Construire le package DMG de QtlMovie pour Mac OS

Exécuter le script build/build-mac.sh. Le package DMG est construit dans le répertoire installers. Le package DMG se nomme QtlMovie-1.6.dmg par exemple, où "1.6" est la version de QtlMovie.

Construire QtlMovie sur Windows

Il y a probablement plusieurs façons différents de construire QtlMovie sur les plates-formes Windows. Ce chapitre décrit une manière qui a prouvé son efficacité mais vous pouvez en expérimenter d'autres...

Pré-requis

Les produits suivants doivent être installés avant de reconstruire QtlMovie. Les numéros de version minimum sont indiqués mais des versions supérieures fonctionnent probablement.

Version de Qt

QtlMovie peut être reconstruit sur n'importe quelle version de Windows supportant Qt 5.5 ou plus. La version MinGW est recommandée. Utiliser Qt avec Visual Studio fonctionne certainement mais n'a pas été testé..

L'utilisation de Qt Creator n'est pas obligatoire. S'il est utilisé, Qt Creator version 2.7 ou plus requis. Qt Creator est recommandé pour éditer ou modifier le projet. Construire le produit sans le modifier ne nécessite pas Qt Creator.

Qt peut être installé en utilisant les installeurs binaires disponibles sur qt-project.org. Utiliser l'installation par défaut dans C:\Qt. A titre d'exemple, l'installeur binaire pour Qt 5.7.0 est qt-opensource-windows-x86-mingw530-5.7.0.exe.

Important: Lors de l'installation de Qt, sélectionner l'option Tools, puis MinGW.

Librairies OpenSSL

Sur Windows, Qt n'inclut pas les librairies OpenSSL. OpenSSL est indispensable pour utiliser HTTPS. QtlMovie ne fait aucune opération sur le réseau, sauf pour aller vérifier la disponibilité d'une nouvelle version sur Internet. Selon la configuration du fournisseur de service, cette opération peut utiliser HTTPS et par conséquent requiert OpenSSL.

Les librairies binaires OpenSLL sont disponibles sur slproweb.com. Sélectionner la version Win32 la plus récente. Utiliser l'installation par défaut dans C:\OpenSSL-Win32. A titre d'exemple, l'installeur binaire pour OpenSSL 1.0.2j est Win32OpenSSL-1_0_2j.exe.

Important:

Windows PowerShell

Tous les scripts Windows dans le répertoire build utilisent Windows PowerShell. La version minimum requise est PowerShell 3.0.

Pour afficher la version courante, ouvrez une fenêtre de commande PowerShell et tapez la commande suivante (une version 3.0 dans ce cas):

PS> $PSVersionTable.PSVersion

Major  Minor  Build  Revision
-----  -----  -----  --------
3      0      -1     -1

PowerShell 3.0 est installé avec Windows 8. Sur Windows 7, téléchargez et installez PowerShell 3.0.

Avant d'installer PowerShell 3.0, téléchargez et installez Microsoft .NET Framework 4.5 (ou utilisez le lien direct dotnetfx45_full_x86_x64.exe pour les systèmes 64-bit).

Après avoir installé .NET 4.5 and PowerShell 3.0, n'oubliez pas de lancer Windows Update car quelques mises à jour de sécurité seront probablement disponibles. Il faut également s'attendre à quelques reboots.

Un script Windows PowerShell a une extension .ps1. L'action par défaut de Windows sur un double-clic est d'éditer le fichier script avec notepad. Ce n'est pas très pratique. Le fichier de registre build\WindowsPowerShellTools.reg modifie ce comportement par défaut de telle sorte qu'un script soit exécuté sur un double-clic.

Si un double-clic sur un fichier .ps1 n'exécute pas le script, activez build\WindowsPowerShellTools.reg (double-clic puis accepter les modifications). L'effet est permanent.

Construire QtlMovie manuellement

Exécuter le script build\build.ps1.

Construire QtlMovie avec Qt Creator

Qt Creator doit être lancé par le script build\QtCreator.ps1. Ce script positionne l'environnement nécessaire pour la dernière version de Qt. Le projet QtlMovie est automatiquement ouvert.

La première fois que Qt Creator est lancé, accepter toutes les options par défaut du projet, notamment la configuration de shadow build.

Construction multi-platformes

Quand les répertoires du projet ont été précédement utilisés pour construire QtlMovie pour une autre plate-forme (soit depuis un disque partagé ou après une copie de fichiers), nettoyer d'abord l'arborescence de fichiers avec le script build\cleanup.ps1.

Ce script détruit tous les fichiers précédement générés, y compris les fichiers de configuration spécifiques .pro.user.

Construire la documentation Doxygen

Exécuter le script build\build-doc.ps1.

Exécuter des applications Qt

Pour exécuter manuellement des applications Qt, il faut d'abort positionner l'environnement approprié. Exécuter le script build\QtCommandLine.ps1 pour créer une fenêtre de commande PowerShell avec l'environnement approprié pour exécuter des application Qt comme le QtlMovie.exe que vous venez de compiler.

Construire l'installeur binaire de QtlMovie pour Windows

L'installeur binaire de QtlMovie est créé par NSIS (NullSoft Scriptable Install System). NSIS est un logiciel libre disponible en téléchargement sur le site http://nsis.sourceforge.net/. NSIS version 2.46 a été utilisé pour QtlMovie.

Pour construire l'installeur binaire de QtlMovie, exécuter le script build\build-installer.ps1.

Ce script construit également l'archive "standalone", une alternative pour les utilisateurs sans privilège administrateur qui ne peuvent pas exécuter l'installeur standard.

Construire QtlMovie sur Linux

Pré-requis

QtlMovie peut être construit sur n'importe quelle plate-forme Linux supportant Qt 5.5 ou plus. Tous les packages de développement de Qt 5 doivent être installés.

L'utilisation de Qt Creator n'est pas obligatoire. S'il est utilisé, Qt Creator version 2.7 ou plus requis. Qt Creator est recommandé pour éditer ou modifier le projet. Construire le produit sans le modifier ne nécessite pas Qt Creator.

Qt peut être installé dans les répertoires système (/usr/bin ou équivalent) avec les packages standards de la distribution Linux ou en utilisant les installeurs binaires de http://qt-project.org/. Dans ce dernier cas, Qt est installé dans /usr/local. Le script build/QtSetEnvironment.rc recherche l'installation de Qt la plus récente dans /usr/local et ajoute les répertoires nécessaires dans le PATH. QtSetEnvironment.rc est automatiquement invoqué par tous les scripts de construction.

Pour installer l'environnement de construction sur Fedora:

sudo dnf install qt5-qttools qt5-devel qt-creator rpmdevtools

Pour installer l'environnement de construction sur Ubuntu:

sudo apt-get install qtcreator qtbase5-dev qt5-default qtmultimedia5-dev

Construire QtlMovie manuellement

Exécuter le script build/build.sh.

Construire QtlMovie avec Qt Creator

Qt Creator doit être lancé par le script build/QtCreator.sh. Ce script positionne l'environnement nécessaire pour la dernière version de Qt. Le projet QtlMovie est automatiquement ouvert.

La première fois que Qt Creator est lancé, accepter toutes les options par défaut du projet, notamment la configuration de shadow build.

Construire le package RPM de QtlMovie pour Fedora

Exécuter le script build/build-rpm.sh. Le package RPM est construit dans le répertoire installers. Le package RPM se nomme qtlmovie-1.6-0.fc19.x86_64.rpm par exemple, où "1.6" est la version de QtlMovie, "19" est la version de Fedora et "x86_64" est la plate-forme.

Suivant les règles habituelles de gestion de package, le package RPM ne contient que QtlMovie. Il contient des dépendances sur les packages des divers outils media qui doivent être installés séparement. Noter les points suivants sur les packages non-standards:

Construire le package DEB de QtlMovie pour Ubuntu

Exécuter le script build/build-deb.sh. Le package DEB est construit dans le répertoire installers. Le package DEB se nomme qtlmovie_1.2.16_amd64.deb par exemple, où "1.2.16" est la version de QtlMovie et "amd64" est la plate-forme.

Suivant les règles habituelles de gestion de package, le package DEB ne contient que QtlMovie. Il contient des dépendances sur les packages des divers outils media qui doivent être installés séparement. Noter les points suivants sur les packages non-standards:

Construction multi-platformes

Quand les répertoires du projet ont été précédement utilisés pour construire QtlMovie pour une autre plate-forme (soit depuis un disque partagé ou après une copie de fichiers), nettoyer d'abord l'arborescence de fichiers avec le script build/cleanup.sh.

Ce script détruit tous les fichiers précédement générés, y compris les fichiers de configuration spécifiques .pro.user.

Construire la documentation Doxygen

Exécuter le script build/build-doc.sh.