diff options
Diffstat (limited to 'tools/macdeployqt/shared/shared.cpp')
| -rw-r--r-- | tools/macdeployqt/shared/shared.cpp | 582 |
1 files changed, 582 insertions, 0 deletions
diff --git a/tools/macdeployqt/shared/shared.cpp b/tools/macdeployqt/shared/shared.cpp new file mode 100644 index 0000000..a10e668 --- /dev/null +++ b/tools/macdeployqt/shared/shared.cpp @@ -0,0 +1,582 @@ +/**************************************************************************** +** +** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). +** Contact: Qt Software Information (qt-info@nokia.com) +** +** This file is part of the tools applications of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:LGPL$ +** No Commercial Usage +** This file contains pre-release code and may not be distributed. +** You may use this file in accordance with the terms and conditions +** contained in the either Technology Preview License Agreement or the +** Beta Release License Agreement. +** +** GNU Lesser General Public License Usage +** Alternatively, this file may be used under the terms of the GNU Lesser +** General Public License version 2.1 as published by the Free Software +** Foundation and appearing in the file LICENSE.LGPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU Lesser General Public License version 2.1 requirements +** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. +** +** In addition, as a special exception, Nokia gives you certain +** additional rights. These rights are described in the Nokia Qt LGPL +** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this +** package. +** +** GNU General Public License Usage +** Alternatively, this file may be used under the terms of the GNU +** General Public License version 3.0 as published by the Free Software +** Foundation and appearing in the file LICENSE.GPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU General Public License version 3.0 requirements will be +** met: http://www.gnu.org/copyleft/gpl.html. +** +** If you are unsure which license is appropriate for your use, please +** contact the sales department at qt-sales@nokia.com. +** $QT_END_LICENSE$ +** +****************************************************************************/ +#include <QString> +#include <QStringList> +#include <QDebug> +#include <iostream> +#include <QProcess> +#include <QDir> +#include <QRegExp> +#include <QSet> +#include <QDirIterator> +#include "shared.h" + +bool runStripEnabled = true; +int logLevel = 1; + +using std::cout; +using std::endl; + +bool operator==(const FrameworkInfo &a, const FrameworkInfo &b) +{ + return ((a.frameworkPath == b.frameworkPath) && (a.binaryPath == b.binaryPath)); +} + +QDebug operator<<(QDebug debug, const FrameworkInfo &info) +{ + debug << "Framework name" << info.frameworkName << "\n"; + debug << "Framework directory" << info.frameworkDirectory << "\n"; + debug << "Framework path" << info.frameworkPath << "\n"; + debug << "Binary directory" << info.binaryDirectory << "\n"; + debug << "Binary name" << info.binaryName << "\n"; + debug << "Binary path" << info.binaryPath << "\n"; + debug << "Version" << info.version << "\n"; + debug << "Install name" << info.installName << "\n"; + debug << "Deployed install name" << info.deployedInstallName << "\n"; + debug << "Source file Path" << info.sourceFilePath << "\n"; + debug << "Deployed Directory (relative to bundle)" << info.destinationDirectory << "\n"; + + return debug; +} + +const QString bundleFrameworkDirectory = "Contents/Frameworks"; +const QString bundleBinaryDirectory = "Contents/MacOS"; + +inline QDebug operator<<(QDebug debug, const ApplicationBundleInfo &info) +{ + debug << "Application bundle path" << info.path << "\n"; + debug << "Binary path" << info.binaryPath << "\n"; + return debug; +} + +bool copyFilePrintStatus(const QString &from, const QString &to) +{ + if (QFile::copy(from, to)) { + LogNormal() << " copied:" << from; + LogNormal() << " to" << to; + return true; + } else { + LogError() << "file copy failed from" << from; + LogError() << " to" << to; + return false; + } +} + +FrameworkInfo parseOtoolLibraryLine(const QString &line, bool useDebugLibs) +{ + FrameworkInfo info; + QString trimmed = line.trimmed(); + + if (trimmed.isEmpty()) + return info; + + // Don't deploy system libraries. + if (trimmed.startsWith("/System/Library/") || + (trimmed.startsWith("/usr/lib/") && trimmed.contains("libQt") == false) // exception for libQtuitools and libQtlucene + || trimmed.startsWith("@executable_path")) + return info; + + enum State {QtPath, FrameworkName, DylibName, Version, End}; + State state = QtPath; + int part = 0; + QString name; + QString qtPath; + QString suffix = useDebugLibs ? "_debug" : ""; + + // Split the line into [Qt-path]/lib/qt[Module].framework/Versions/[Version]/ + QStringList parts = trimmed.split("/"); + while (part < parts.count()) { + const QString currentPart = parts.at(part).simplified() ; + ++part; + if (currentPart == "") + continue; + + if (state == QtPath) { + // Check for library name part + if (part < parts.count() && parts.at(part).contains(".dylib ")) { + state = DylibName; + info.installName += "/" + (qtPath + "lib/").simplified(); + info.frameworkDirectory = info.installName; + state = DylibName; + continue; + } else if (part < parts.count() && parts.at(part).endsWith(".framework")) { + info.installName += "/" + (qtPath + "lib/").simplified(); + info.frameworkDirectory = info.installName; + state = FrameworkName; + continue; + } else if (trimmed.startsWith("/") == false) { // If the line does not contain a full path, the app is using a binary Qt package. + if (currentPart.contains(".framework")) { + info.frameworkDirectory = "/Library/Frameworks/"; + state = FrameworkName; + } else { + info.frameworkDirectory = "/usr/lib/"; + state = DylibName; + } + + --part; + continue; + } + qtPath += (currentPart + "/"); + + } if (state == FrameworkName) { + // remove ".framework" + name = currentPart; + name.chop(QString(".framework").length()); + info.frameworkName = currentPart; + state = Version; + ++part; + continue; + } if (state == DylibName) { + name = currentPart.split(" (compatibility").at(0); + info.frameworkName = name; + info.binaryName = name.left(name.indexOf('.')) + suffix + name.mid(name.indexOf('.')); + info.installName += name; + info.deployedInstallName = "@executable_path/../Frameworks/" + info.binaryName; + info.frameworkPath = info.frameworkDirectory + info.binaryName; + info.sourceFilePath = info.frameworkPath; + info.destinationDirectory = bundleFrameworkDirectory + "/"; + info.binaryDirectory = info.frameworkDirectory; + info.binaryPath = info.frameworkPath; + state = End; + ++part; + continue; + } else if (state == Version) { + info.version = currentPart; + info.binaryDirectory = "Versions/" + info.version; + info.binaryName = name + suffix; + info.binaryPath = "/" + info.binaryDirectory + "/" + info.binaryName; + info.installName += info.frameworkName + "/" + info.binaryDirectory + "/" + name; + info.deployedInstallName = "@executable_path/../Frameworks/" + info.frameworkName + info.binaryPath; + info.frameworkPath = info.frameworkDirectory + info.frameworkName; + info.sourceFilePath = info.frameworkPath + info.binaryPath; + info.destinationDirectory = bundleFrameworkDirectory + "/" + info.frameworkName + "/" + info.binaryDirectory; + state = End; + } else if (state == End) { + break; + } + } + + return info; +} + +QString findAppBinary(const QString &appBundlePath) +{ + QString appName = QFileInfo(appBundlePath).completeBaseName(); + QString binaryPath = appBundlePath + "/Contents/MacOS/" + appName; + + if (QFile::exists(binaryPath)) + return binaryPath; + LogError() << "Could not find bundle binary for" << appBundlePath; + return QString(); +} + +QList<FrameworkInfo> getQtFrameworks(const QStringList &otoolLines, bool useDebugLibs) +{ + QList<FrameworkInfo> libraries; + foreach(const QString line, otoolLines) { + FrameworkInfo info = parseOtoolLibraryLine(line, useDebugLibs); + if (info.frameworkName.isEmpty() == false) { + LogDebug() << "Adding framework:"; + LogDebug() << info; + libraries.append(info); + } + } + return libraries; +} + +QList<FrameworkInfo> getQtFrameworks(const QString &path, bool useDebugLibs) +{ + LogDebug() << "Using otool:"; + LogDebug() << " inspecting" << path; + QProcess otool; + otool.start("otool", QStringList() << "-L" << path); + otool.waitForFinished(); + + if (otool.exitCode() != 0) { + LogError() << otool.readAllStandardError(); + } + + QString output = otool.readAllStandardOutput(); + QStringList outputLines = output.split("\n"); + outputLines.removeFirst(); // remove line containing the binary path + if (path.contains(".framework") || path.contains(".dylib")) + outputLines.removeFirst(); // frameworks and dylibs lists themselves as a dependency. + + return getQtFrameworks(outputLines, useDebugLibs); +} + +// copies everything _inside_ sourcePath to destinationPath +void recursiveCopy(const QString &sourcePath, const QString &destinationPath) +{ + QDir().mkpath(destinationPath); + + QStringList files = QDir(sourcePath).entryList(QStringList() << "*", QDir::Files | QDir::NoDotAndDotDot); + foreach (QString file, files) { + const QString fileSourcePath = sourcePath + "/" + file; + const QString fileDestinationPath = destinationPath + "/" + file; + copyFilePrintStatus(fileSourcePath, fileDestinationPath); + } + + QStringList subdirs = QDir(sourcePath).entryList(QStringList() << "*", QDir::Dirs | QDir::NoDotAndDotDot); + foreach (QString dir, subdirs) { + recursiveCopy(sourcePath + "/" + dir, destinationPath + "/" + dir); + } +} + +QString copyFramework(const FrameworkInfo &framework, const QString path) +{ + QString from = framework.sourceFilePath; + QString toDir = path + "/" + framework.destinationDirectory; + QString to = toDir + "/" + framework.binaryName; + + if (QFile::exists(from) == false) { + LogError() << "no file at" << from; + return QString(); + } + + + QDir dir; + if (dir.mkpath(toDir) == false) { + LogError() << "could not create destination directory" << to; + return QString(); + } + + + if (QFile::exists(to)) { + return QString(); + } + + copyFilePrintStatus(from, to); + + const QString resourcesSourcePath = framework.frameworkPath + "/Resources"; + const QString resourcesDestianationPath = path + "/Contents/Frameworks/" + framework.frameworkName + "/Resources"; + recursiveCopy(resourcesSourcePath, resourcesDestianationPath); + + return to; +} + +void runInstallNameTool(QStringList options) +{ + QProcess installNametool; + installNametool.start("install_name_tool", options); + installNametool.waitForFinished(); + if (installNametool.exitCode() != 0) { + LogError() << installNametool.readAllStandardError(); + LogError() << installNametool.readAllStandardOutput(); + } +} + +void changeIdentification(const QString &id, const QString &binaryPath) +{ + LogDebug() << "Using install_name_tool:"; + LogDebug() << " change identification in" << binaryPath; + LogDebug() << " to" << id; + runInstallNameTool(QStringList() << "-id" << id << binaryPath); +} + +void changeInstallName(const QString &oldName, const QString &newName, const QString &binaryPath) +{ + LogDebug() << "Using install_name_tool:"; + LogDebug() << " in" << binaryPath; + LogDebug() << " change reference" << oldName; + LogDebug() << " to" << newName; + runInstallNameTool(QStringList() << "-change" << oldName << newName << binaryPath); +} + +void runStrip(const QString &binaryPath) +{ + if (runStripEnabled == false) + return; + + LogDebug() << "Using strip:"; + LogDebug() << " stripped" << binaryPath; + QProcess strip; + strip.start("strip", QStringList() << "-x" << binaryPath); + strip.waitForFinished(); + if (strip.exitCode() != 0) { + LogError() << strip.readAllStandardError(); + LogError() << strip.readAllStandardOutput(); + } +} + +/* + Deploys the the listed frameworks listed into an app bundle. + The frameworks are searched for dependencies, which are also deployed. + (deploying Qt3Support will also deploy QtNetwork and QtSql for example.) + Returns a DeploymentInfo structure containing the Qt path used and a + a list of actually deployed frameworks. +*/ +DeploymentInfo deployQtFrameworks(QList<FrameworkInfo> frameworks, + const QString &bundlePath, const QString &binaryPath, bool useDebugLibs) +{ + LogNormal(); + LogNormal() << "Deploying Qt frameworks found inside:" << binaryPath; + QStringList copiedFrameworks; + DeploymentInfo deploymenInfo; + + while (frameworks.isEmpty() == false) { + const FrameworkInfo framework = frameworks.takeFirst(); + copiedFrameworks.append(framework.frameworkName); + + // Get the qt path from one of the Qt frameworks; + if (deploymenInfo.qtPath == QString() && framework.frameworkName.contains("Qt") + && framework.frameworkDirectory.contains("/lib")) + { + deploymenInfo.qtPath = framework.frameworkDirectory; + deploymenInfo.qtPath.chop(5); // remove "/lib/" + } + + if (framework.installName.startsWith("/@executable_path/")) { + LogError() << framework.frameworkName << "already deployed, skipping."; + continue; + } + + // Install_name_tool the new id into the binary + changeInstallName(framework.installName, framework.deployedInstallName, binaryPath); + + // Copy farmework to app bundle. + const QString deployedBinaryPath = copyFramework(framework, bundlePath); + // Skip the rest if already was deployed. + if (deployedBinaryPath == QString()) + continue; + + runStrip(deployedBinaryPath); + + // Install_name_tool it a new id. + changeIdentification(framework.deployedInstallName, deployedBinaryPath); + // Check for framework dependencies + QList<FrameworkInfo> dependencies = getQtFrameworks(deployedBinaryPath, useDebugLibs); + + foreach (FrameworkInfo dependency, dependencies) { + changeInstallName(dependency.installName, dependency.deployedInstallName, deployedBinaryPath); + + // Deploy framework if neccesary. + if (copiedFrameworks.contains(dependency.frameworkName) == false && frameworks.contains(dependency) == false) { + frameworks.append(dependency); + } + } + } + deploymenInfo.deployedFrameworks = copiedFrameworks; + return deploymenInfo; +} + +DeploymentInfo deployQtFrameworks(const QString &appBundlePath, bool useDebugLibs) +{ + ApplicationBundleInfo applicationBundle; + applicationBundle.path = appBundlePath; + applicationBundle.binaryPath = findAppBinary(appBundlePath); + QList<FrameworkInfo> frameworks = getQtFrameworks(applicationBundle.binaryPath, useDebugLibs); + if (frameworks.isEmpty()) { + LogWarning(); + LogWarning() << "Could not find any external Qt frameworks to deploy in" << appBundlePath; + LogWarning() << "Perhaps macdeployqt was already used on" << appBundlePath << "?"; + LogWarning() << "If so, you will need to rebuild" << appBundlePath << "before trying again."; + return DeploymentInfo(); + } else { + return deployQtFrameworks(frameworks, applicationBundle.path, applicationBundle.binaryPath, useDebugLibs); + } +} + +void deployPlugins(const ApplicationBundleInfo &appBundleInfo, const QString &pluginSourcePath, + const QString pluginDestinationPath, DeploymentInfo deploymentInfo, bool useDebugLibs) +{ + LogNormal() << "Deploying plugins from" << pluginSourcePath; + QStringList plugins = QDir(pluginSourcePath).entryList(QStringList() << "*.dylib"); + + foreach (QString pluginName, plugins) { + if (pluginSourcePath.contains(deploymentInfo.pluginPath)) { + QStringList deployedFrameworks = deploymentInfo.deployedFrameworks; + + // Skip the debug versions of the plugins, unless specified otherwise. + if (!useDebugLibs && pluginName.endsWith("_debug.dylib")) + continue; + + // Skip the release versions of the plugins, unless specified otherwise. + if (useDebugLibs && !pluginName.endsWith("_debug.dylib")) + continue; + + // Skip the designer plugins + if (pluginSourcePath.contains("plugins/designer")) + continue; + +#ifndef QT_GRAPHICSSYSTEM_OPENGL + // SKip the opengl graphicssystem plugin when not in use. + if (pluginName.contains("libqglgraphicssystem")) + continue; +#endif + // Deploy accessibility for Qt3Support only if the Qt3Support.framework is in use + if (deployedFrameworks.indexOf("Qt3Support.framework") == -1 && pluginName.contains("accessiblecompatwidgets")) + continue; + + // Deploy the svg icon plugin if QtSvg.framework is in use. + if (deployedFrameworks.indexOf("QtSvg.framework") == -1 && pluginName.contains("svg")) + continue; + + // Deploy the phonon plugins if phonon.framework is in use + if (deployedFrameworks.indexOf("phonon.framework") == -1 && pluginName.contains("phonon")) + continue; + + // Deploy the sql plugins if QtSql.framework is in use + if (deployedFrameworks.indexOf("QtSql.framework") == -1 && pluginName.contains("sql")) + continue; + + // Deploy the script plugins if QtScript.framework is in use + if (deployedFrameworks.indexOf("QtScript.framework") == -1 && pluginName.contains("script")) + continue; + } + + QDir dir; + dir.mkpath(pluginDestinationPath); + + const QString sourcePath = pluginSourcePath + "/" + pluginName; + const QString destinationPath = pluginDestinationPath + "/" + pluginName; + if (copyFilePrintStatus(sourcePath, destinationPath)) { + + runStrip(destinationPath); + + // Special case for the phonon plugin: CoreVideo is not available as a separate framework + // on panther, link against the QuartzCore framework instead. (QuartzCore contians CoreVideo.) + if (pluginName.contains("libphonon_qt7")) { + changeInstallName("/System/Library/Frameworks/CoreVideo.framework/Versions/A/CoreVideo", + "/System/Library/Frameworks/QuartzCore.framework/Versions/A/QuartzCore", + destinationPath); + } + + QList<FrameworkInfo> frameworks = getQtFrameworks(destinationPath, useDebugLibs); + deployQtFrameworks(frameworks, appBundleInfo.path, destinationPath, useDebugLibs); + } + } // foreach plugins + + QStringList subdirs = QDir(pluginSourcePath).entryList(QStringList() << "*", QDir::Dirs | QDir::NoDotAndDotDot); + foreach (const QString &subdir, subdirs) + deployPlugins(appBundleInfo, pluginSourcePath + "/" + subdir, pluginDestinationPath + "/" + subdir, deploymentInfo, useDebugLibs); +} + +void createQtConf(const QString &appBundlePath) +{ + QByteArray contents = "[Paths]\nPlugins = PlugIns\n"; + QString filePath = appBundlePath + "/Contents/Resources/"; + QString fileName = filePath + "qt.conf"; + + QDir().mkpath(filePath); + + QFile qtconf(fileName); + if (qtconf.exists()) { + LogWarning(); + LogWarning() << fileName << "already exists, will not overwrite."; + LogWarning() << "To make sure the plugins are loaded from the correct location,"; + LogWarning() << "please make sure qt.conf contains the following lines:"; + LogWarning() << "[Paths]"; + LogWarning() << " Plugins = PlugIns"; + return; + } + + qtconf.open(QIODevice::WriteOnly); + if (qtconf.write(contents) != -1) { + LogNormal() << "Created configuration file:" << fileName; + LogNormal() << "This file sets the plugin search path to" << appBundlePath + "/Contents/PlugIns"; + } +} + +void deployPlugins(const QString &appBundlePath, DeploymentInfo deploymentInfo, bool useDebugLibs) +{ + ApplicationBundleInfo applicationBundle; + applicationBundle.path = appBundlePath; + applicationBundle.binaryPath = findAppBinary(appBundlePath); + + const QString pluginDestinationPath = appBundlePath + "/" + "Contents/PlugIns"; + deployPlugins(applicationBundle, deploymentInfo.pluginPath, pluginDestinationPath, deploymentInfo, useDebugLibs); +} + + +void changeQtFrameworks(const QList<FrameworkInfo> frameworks, const QString &appBinaryPath, const QString &absoluteQtPath) +{ + LogNormal() << "Changing" << appBinaryPath << "to link against"; + LogNormal() << "Qt in" << absoluteQtPath; + QString finalQtPath = absoluteQtPath; + + if (!absoluteQtPath.startsWith("/Library/Frameworks")) + finalQtPath += "/lib/"; + + foreach (FrameworkInfo framework, frameworks) { + const QString oldBinaryId = framework.installName; + const QString newBinaryId = finalQtPath + framework.frameworkName + framework.binaryPath; + changeInstallName(oldBinaryId, newBinaryId, appBinaryPath); + } +} + +void changeQtFrameworks(const QString appPath, const QString &qtPath, bool useDebugLibs) +{ + const QString appBinaryPath = findAppBinary(appPath); + const QList<FrameworkInfo> frameworks = getQtFrameworks(appBinaryPath, useDebugLibs); + if (frameworks.isEmpty()) { + LogWarning(); + LogWarning() << "Could not find any _external_ Qt frameworks to change in" << appPath; + return; + } else { + const QString absoluteQtPath = QDir(qtPath).absolutePath(); + changeQtFrameworks(frameworks, appBinaryPath, absoluteQtPath); + } +} + + +void createDiskImage(const QString &appBundlePath) +{ + QString appBaseName = appBundlePath; + appBaseName.chop(4); // remove ".app" from end + + QString dmgName = appBaseName + ".dmg"; + + QFile dmg(dmgName); + + if (dmg.exists()) { + LogNormal() << "Disk image already exists, skipping .dmg creation for" << dmg.fileName(); + } else { + LogNormal() << "Creating disk image (.dmg) for" << appBundlePath; + } + + // More dmg options can be found in the hdiutil man page. + QString options = QString("create %1.dmg -srcfolder %1.app -format UDZO -volname %1").arg(appBaseName); + + QProcess hdutil; + hdutil.start("hdiutil", options.split(' ')); + hdutil.waitForFinished(-1); +} |