SW Installer Launcher API

From Forum Nokia Wiki

Reviewer Approved

Note!
This API is not part of the public SDK. It can be found in the SDK API Plug-in.

API Purpose

RSWInstLauncher is the client side handle to access SW Installer UI services.. It handles the installation of SISX packages, and Java MIDlets. During normal installation, various notes are displayed to the user. Through these notes, the user can control the process: continue the installation or cancel it, browse the detail information of the application etc. RSWInstSilentLauncher can be used to silently install the SISX without user intervention. We can control by giving options as parameter to RSWInstSilentLauncher SilentInstall.

Use cases

One of the use case can be to download SISX from a server and then to silently install it. It has been checked in 5500.

Example code

Headers:
 
#include <SWInstApi.h>
#include <SWInstDefs.h>
 
 
SwiUI::RSWInstSilentLauncher iLauncher; 
SwiUI::TInstallOptions iOptions;
SwiUI::TInstallOptionsPckg iOptionsPckg;  
 
    iOptions.iUpgrade = SwiUI::EPolicyNotAllowed;
    iOptions.iOCSP = SwiUI::EPolicyNotAllowed;
    iOptions.iDrive = 'C';   
    iOptions.iUntrusted = SwiUI::EPolicyNotAllowed; 
    iOptions.iCapabilities = SwiUI::EPolicyNotAllowed; 	
 
    iOptionsPckg = iOptions;  
 
 iLauncher.Connect();     
 TBufC<50> FName(KTempPath);		 
 
 iLauncher.SilentInstall(waiter->iStatus,FName,iOptionsPckg);
iLauncher.Close();

Error handling

The API uses Symbian OS's leave mechanism and in certain conditions the client application may panic with category SWInstSvr

Example project

Example application to install Silently: File:SilentInst.zip

Community: Wiki