void ConfigLoader::readConfig ()
{
UpdatersList l;
settings_->sync();
settings_->beginGroup ("PRODUCTS");
foreach (const QString & group, settings_->childGroups()) {
settings_->beginGroup (group);
Config config;
config ["ProductID"] = group;
config.unite (loadConfig (settings_));
AbstractUpdater *updater = getUpdater (config);
if (updater && updater->config() != config) {
updater->setConfig (config);
}
l.push_back (updater);
settings_->endGroup();
}
settings_->endGroup();
clearExcessUpdaters (updaters_);
updaters_ = l;
emit configReaded (l);
}
/**
* If the \a enabled parameter is set to \c true, the \c Updater instance
* registered with the given \a url will open the integrated downloader
* if the user agrees to install the update (if any).
*
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
void QSimpleUpdater::setDownloaderEnabled (const QString& url,
const bool enabled)
{
getUpdater (url)->setDownloaderEnabled (enabled);
}
/**
* Changes the module \version of the \c Updater instance registered at the
* given \a url.
*
* \note The module version is used to compare it with the remove version.
* If the module name is empty, then the \c Updater instance will use the
* application version.
*/
void QSimpleUpdater::setModuleVersion (const QString& url,
const QString& version)
{
getUpdater (url)->setModuleVersion (version);
}
/**
* Changes the platform key of the \c Updater isntance registered at the given
* \a url.
*
* If the platform key is empty, then the system will use the following keys:
* - On iOS: \c ios
* - On Mac OSX: \c osx
* - On Android: \c android
* - On GNU/Linux: \c linux
* - On Microsoft Windows: \c windows
*
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
void QSimpleUpdater::setPlatformKey (const QString& url,
const QString& platform)
{
getUpdater (url)->setPlatformKey (platform);
}
/**
* If \a notify is set to \c true, then the \c Updater instance registered with
* the given \a url will notify the user when it has finished interpreting the
* update definitions file.
*
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
void QSimpleUpdater::setNotifyOnFinish (const QString& url,
const bool notify)
{
getUpdater (url)->setNotifyOnFinish (notify);
}
/**
* Returns \c true if the \c Updater instance registered with the given \a url
* shall try to open the downloaded file.
*
* If you want to implement your own way to handle the downloaded file, just
* bind to the \c downloadFinished() signal and disable the integrated
* downloader with the \c setUseCustomInstallProcedures() function.
*
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
bool QSimpleUpdater::usesCustomInstallProcedures (const QString& url) const
{
return getUpdater (url)->useCustomInstallProcedures();
}
/**
* Returns \c true if the \c Updater instance registered with the given \a url
* has an update available.
*
* \warning You should call \c checkForUpdates() before using this function
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
bool QSimpleUpdater::getUpdateAvailable (const QString& url) const
{
return getUpdater (url)->updateAvailable();
}
/**
* Returns \c true if the \c Updater instance registered with the given \a url
* uses a custom appcast format and/or allows the application to read and
* interpret the downloaded appcast file
*
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
bool QSimpleUpdater::usesCustomAppcast (const QString& url) const
{
return getUpdater (url)->customAppcast();
}
/**
* Returns the remote module version of the \c Updater instance registered with
* the given \a url.
*
* \warning You should call \c checkForUpdates() before using this function
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
QString QSimpleUpdater::getLatestVersion (const QString& url) const
{
return getUpdater (url)->latestVersion();
}
/**
* Returns the platform key of the \c Updater registered with the given \a url.
* If you do not define a platform key, the system will assign the following
* platform key:
* - On iOS: \c ios
* - On Mac OSX: \c osx
* - On Android: \c android
* - On GNU/Linux: \c linux
* - On Microsoft Windows: \c windows
*
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
QString QSimpleUpdater::getPlatformKey (const QString& url) const
{
return getUpdater (url)->platformKey();
}
/**
* Returns the download URL of the \c Updater instance registered with the given
* \a url.
*
* \warning You should call \c checkForUpdates() before using this function
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
QString QSimpleUpdater::getDownloadUrl (const QString& url) const
{
return getUpdater (url)->downloadUrl();
}
/**
* Returns the module name of the \c Updater instance registered with the given
* \a url.
*
* \note If the module name is empty, then the \c Updater will use the
* application name as its module name.
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
QString QSimpleUpdater::getModuleName (const QString& url) const
{
return getUpdater (url)->moduleName();
}
/**
* Returns the changelog of the \c Updater instance registered with the given
* \a url.
*
* \warning You should call \c checkForUpdates() before using this function
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
QString QSimpleUpdater::getChangelog (const QString& url) const
{
return getUpdater (url)->changelog();
}
/**
* Returns the URL to open in a web browser of the \c Updater instance
* registered with the given \a url.
*
* \note If the module name is empty, then the \c Updater will use the
* application name as its module name.
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
QString QSimpleUpdater::getOpenUrl (const QString& url) const
{
return getUpdater (url)->openUrl();
}
/**
* If the \a customAppcast parameter is set to \c true, then the \c Updater
* will not try to read the network reply from the server, instead, it will
* emit the \c appcastDownloaded() signal, which allows the application to
* read and interpret the appcast file by itself.
*
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
void QSimpleUpdater::setUseCustomAppcast (const QString& url,
const bool customAppcast)
{
getUpdater (url)->setUseCustomAppcast (customAppcast);
}
/**
* If the \a custom parameter is set to \c true, the \c Updater instance
* registered with the given \a url will not try to open the downloaded file.
*
* If you want to implement your own way to handle the downloaded file, just
* bind to the \c downloadFinished() signal and disable the integrated
* downloader with the \c setUseCustomInstallProcedures() function.
*
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
void QSimpleUpdater::setUseCustomInstallProcedures (const QString& url,
const bool custom)
{
getUpdater (url)->setUseCustomInstallProcedures (custom);
}
/**
* Returns the module version of the \c Updater instance registered with the
* given \a url.
*
* \note If the module version is empty, then the \c Updater will use the
* application version as its module version.
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
QString QSimpleUpdater::getModuleVersion (const QString& url) const
{
return getUpdater (url)->moduleVersion();
}
/**
* Returns \c true if the \c Updater instance registered with the given \a url
* shall notify the user when it finishes checking for updates.
*
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
bool QSimpleUpdater::getNotifyOnFinish (const QString& url) const
{
return getUpdater (url)->notifyOnFinish();
}
/**
* Instructs the \c Updater instance with the registered \c url to download and
* interpret the update definitions file.
*
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
void QSimpleUpdater::checkForUpdates (const QString& url)
{
getUpdater (url)->checkForUpdates();
}
/**
* Changes the module \a name of the \c Updater instance registered at the
* given \a url.
*
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
* \note The module name is used on the user prompts. If the module name is
* empty, then the prompts will show the name of the application.
*/
void QSimpleUpdater::setModuleName (const QString& url, const QString& name)
{
getUpdater (url)->setModuleName (name);
}
/**
* Returns \c true if the \c Updater instance registered with the given \a url
* has the integrated downloader enabled.
*
* \note If an \c Updater instance registered with the given \a url is not
* found, that \c Updater instance will be initialized automatically
*/
bool QSimpleUpdater::getDownloaderEnabled (const QString& url) const
{
return getUpdater (url)->downloaderEnabled();
}
