Qt-Tutorial Teil 3: Ressourcen unter mehreren Betriebssystemen (Windows/Mac/Linux) laden

Nachdem im letzten Teil des Qt-Tutorials gezeigt wurde, wie man die Qt-eigenen Sprachdateien in verschiedenen Betriebssystemen richtig lädt, beschreibt der dritte Teil das korrekte Laden von allgemeinen Ressourcen.

Verzeichniswirren

Als Beispiel dient ein Verzeichnis, in dem HTML-Dateien liegen. Diese werden im Programm von der Online-Hilfe geladen und dargestellt. Ähnlich wie bei den Sprachdateien ist der genaue Pfad abhängig vom Betriebssystem:

Linux: Der Pfad wird durch eine qmake-Variable in der Projektdatei fix definiert. Im ersten Teil des Tutorials war dies die Zeile DEFINES += "HELPPATH=\\\"/usr/share/doc/myprog/help\\\".
Windows: In Windows liegt die Hilfe im Programmverzeichnis (z.B. C:\Programme\MeinProgramm\help\). Insofern ist das einfach. Während des Entwickelns wird jedoch ein Verzeichnis debug und Verzeichnis release erzeugt, so dass die Pfade hier nicht stimmen. Man soll jedoch auch unter diesen Umständen das Programm realitätsnah testen können.
Mac: Die Hilfe liegt im Resource Bundle im Verzeichnis Resources.

Um diesen Umständen Rechnung zu tragen, muss der Compiler je Betriebssystem angewiesen werden, verschiedene Pfade auszuwählen. Folgendes Listing zeigt eine typische Methode, die in ein Objekt integriert werden kann, um den richtigen Pfad zurückzugeben:

Quelltext: Alles auswählen | Zeilennummerierung an/aus

/*
* gibt ein korrektes Unterverzeichnis der Hilfe zurück
* subdir = Verzeichnis unterhalb des Hilfeverzeichnisses
*/
QDir HelpBrowser::directoryOf(const QString &subdir)
{
#if defined(LINUX)
//fixer Pfad unter Linux (s. Projektdatei)
QDir dir(HELPPATH);
#else
//ansonsten ist der Pfad der der Applikation
QDir dir(QApplication::applicationDirPath());
#if defined(Q_OS_WIN)
//Windows: Testen, ob man noch in der Entwicklungsumgebung ist
//falls ja: in übergeordnetes Verzeichnis wechseln
if (dir.dirName().toLower() == "debug"
|| dir.dirName().toLower() == "release")
dir.cdUp();
#elif defined(Q_OS_MAC)
//falls im Resource Bundle: Wechsel ins Verzeichnis Resources
if (dir.dirName() == "MacOS") {
dir.cdUp();
dir.cd("Resources");
}
#endif
#endif
//nun in das eigentliche Unterverzeichnis wechseln
dir.cd(subdir);
//korrekten absoluten Pfad zurückgeben
return dir;
}

Wie man hier sieht, kann man relativ leicht den Pfad festsetzen, wenn man mit den entsprechenden Präprozessor-Anweisungen arbeitet.

Falls man Daten übrigens ins Verzeichnis des Benutzer ablegen bzw. von dort laden will, kann man dies mit der statischen Methode QDir::homePath() bewerkstelligen.

Weitere Teile des Qt-Tutorials: