Development/Tutorials/Collaboration/HotNewStuff/Updates

From KDE TechBase


Get Hot New Stuff 3 Introduction
Tutorial Series   HotNewStuff
Previous   Get Hot New Stuff 3 - Download
What's Next   Get Hot New Stuff 3 - Upload
Further Reading   API Documentation

Overview

Just like firefox informs you of updates to your addons, KNewStuff can let you check for updates since KDE SC 4.5.

There is an example in kdeexamples.

DownloadManager

The class in question is DownloadManager.

Use an instance of DownloadManager in your class:

m_downloadManager = new KNS3::DownloadManager("plasmoids.knsrc", this);

// to know when checking for updates is done
connect(m_downloadManager, SIGNAL(searchResult(KNS3::Entry::List)), 
    this, SLOT(slotUpdatesFound(KNS3::Entry::List)));

// to know about finished installations
connect(m_downloadManager, SIGNAL(entryStatusChanged(KNS3::Entry)), 
    this, SLOT(entryStatusChanged(KNS3::Entry)));

// start checking for updates
m_downloadManager->checkForUpdates();

The entryStatusChanged signal informs you when you installed an entry. If you don't want to make use of that possibility, you can ignore the signal.

void UpdateChecker::slotUpdatesFound(const KNS3::Entry::List& updates)
{
    m_updates = updates;
    foreach (const KNS3::Entry& entry, updates) {
        kDebug() << entry.name();
    }
}

To install an entry you can show the download dialog or do it without the dialog by using:

m_downloadManager->installEntry(entry);