/************************************************************************** ** ** This file is part of Installer Framework ** ** Copyright (c) 2011-2012 Nokia Corporation and/or its subsidiary(-ies). ** ** Contact: Nokia Corporation (qt-info@nokia.com) ** ** ** GNU Lesser General Public License Usage ** ** 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.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** Other Usage ** ** Alternatively, this file may be used in accordance with the terms and ** conditions contained in a signed written agreement between you and Nokia. ** ** If you have questions regarding the use of this file, please contact ** Nokia at qt-info@nokia.com. ** **************************************************************************/ #include "registerdocumentationoperation.h" #include #include #include #include #include #include using namespace QInstaller; RegisterDocumentationOperation::RegisterDocumentationOperation() { setName(QLatin1String("RegisterDocumentation")); } void RegisterDocumentationOperation::backup() { } // get the right filename of the qsettingsfile (root/user) static QString settingsFileName() { #if defined(Q_OS_UNIX) && !defined(Q_OS_MAC) // If the system settings are writable, don't touch the user settings. // The reason is that a doc registered while running with sudo could otherwise create // a root-owned configuration file a user directory. QScopedPointer settings(new QSettings(QSettings::IniFormat, QSettings::SystemScope, QLatin1String("Nokia"), QLatin1String("QtCreator"))); // QSettings::isWritable isn't reliable enough in 4.7, determine writability experimentally settings->setValue(QLatin1String("iswritable"), QLatin1String("accomplished")); settings->sync(); if (settings->status() == QSettings::NoError) { // we can use the system settings if (settings->contains(QLatin1String("iswritable"))) settings->remove(QLatin1String("iswritable")); } else { // we have to use user settings settings.reset(new QSettings(QSettings::IniFormat, QSettings::UserScope, QLatin1String("Nokia"), QLatin1String("QtCreator"))); } #else QScopedPointer settings(new QSettings(QSettings::IniFormat, QSettings::UserScope, QLatin1String("Nokia"), QLatin1String("QtCreator"))); #endif return settings->fileName(); } bool RegisterDocumentationOperation::performOperation() { const QStringList args = arguments(); if (args.count() != 1) { setError(InvalidArguments); setErrorString(tr("Invalid arguments in %0: %1 arguments given, 1 expected.") .arg(name()).arg(args.count())); return false; } const QString helpFile = args.at(0); QFileInfo fileInfo(settingsFileName()); QDir settingsDir(fileInfo.absolutePath() + QLatin1String("/qtcreator")); if (!settingsDir.exists()) settingsDir.mkpath(settingsDir.absolutePath()); const QString collectionFile = settingsDir.absolutePath() + QLatin1String("/helpcollection.qhc"); if (!QFileInfo(helpFile).exists()) { setError(UserDefinedError); setErrorString(tr("Could not register help file %1: File not found.").arg(helpFile)); return false; } QHelpEngineCore help(collectionFile); QString oldData = help.customValue(QLatin1String("AddedDocs")).toString(); if (!oldData.isEmpty()) oldData.append(QLatin1Char(';')); const QString newData = oldData + QFileInfo(helpFile).absoluteFilePath(); if (!help.setCustomValue(QLatin1String("AddedDocs"), newData)) { qWarning() << "Can't register doc file:" << helpFile << help.error(); // setError(UserDefinedError); // setErrorString(help.error()); // return false; } return true; } bool RegisterDocumentationOperation::undoOperation() { const QString helpFile = arguments().first(); QFileInfo fileInfo(settingsFileName()); QDir settingsDir(fileInfo.absolutePath() + QLatin1String("/qtcreator")); if (!settingsDir.exists()) settingsDir.mkpath(settingsDir.absolutePath()); const QString collectionFile = settingsDir.absolutePath() + QLatin1String("/helpcollection.qhc"); if (!QFileInfo( helpFile ).exists()) { setError ( UserDefinedError ); setErrorString( tr("Could not unregister help file %1: File not found.").arg( helpFile ) ); return false; } QHelpEngineCore help(collectionFile); const QString nsName = help.namespaceName(helpFile); return help.unregisterDocumentation(nsName); } bool RegisterDocumentationOperation::testOperation() { return true; } Operation *RegisterDocumentationOperation::clone() const { return new RegisterDocumentationOperation(); }