How to create a SIS file
8 nov. 2003 - 00:03
Keywords :

Overview

SIS files is a standard and convenient way to distribute Symbian applications:
-  End users can install/uninstall a SIS package either from a PC using connectivity software, or from an Symbian OS phone using an on-board installation program.
-  SIS files have embedded mechanism that allow deployment of shared libraries or application upgrades
-  The SIS file format is compact (it uses zlib compression)

SIS files are generated on a PC using the makesis tool, available with in all C++ SDKs: pkg.png

The Makesis tool has two inputs:
-  your application files (executables, resources, data files...)
-  a PKG file that contains instructions on how to create the SIS package.

This PKG file is the key to create a correct package. It can be generated automatically using the SISAR tool or written manually. The Nokia Application Wizard creates a default PKG file when you use it to start a project (it is located in the %project directory%\installdirectory).

Makesis usage

The command line syntax for creating a SIS file is :

makesis [flags] source [destination]

Flags Meaning Comment
-v Verbose Prints output to the screen
-h Help Shows the usage information
-s Stub Generates a residual sis file for each language defined in the package file. The extension is .sxx, where xx is the number of the language, e.g. .s10
-p password Password Specifies the password when an encrypted private key file is used to digitally sign the sis file.
-d directory Directory The directory that is searched for source file if its full path is not specified.

source is the name of the pkg file and is the only mandatory parameter.

destination is name of the destination file. If not specified, this is derived from the name of the pkg file, but with a sis file extension.

The PKG file overview

A pkg file is a text file which contains installation information for applications or files. It consists of the following parts:
-  the supported languages
-  the package header, including the name of the component to be installed and its build and version information
-  product / platform version compatibility
-  package signature details (optional)
-  package details

The package details can contains:
-  options line
-  condition blocks
-  language independent files to install
-  language-dependent files, of which only one will be installed
-  capabilities line
-  requisite components
-  embedded SIS files
-  comments

Here is a sample PKG file we will use to browse each of these options:

;
; Installation file for DummyLC application
; (c) NewLC 2003
;
;Languages
&EN,FR
;
; UID is the app's UID
;
#{"DummyLC","BetaLC"},(0x0010D003),1,01,12,TYPE=SISAPP
;
;Supports Series 60 v 0.9
(0x101F6F88), 0, 0, 0, {"Series60ProductID","Series60ProductID"}
;
; Display Release notes
;
"release.txt" - "", FILETEXT, TEXTCONTINUE
;
; Install language dependent data
;
{
"\Symbian\6.1\Series60\Epoc32\release\thumb\urel\DummyLC.r01"
"\Symbian\6.1\Series60\Epoc32\release\thumb\urel\DummyLC.r02"
}-"!:\system\apps\DummyLC\DummyLC.rsc"
;
; Files to install
;
"\Symbian\6.1\Series60\Epoc32\release\thumb\urel\DummyLC.app"          - "!:\system\apps\DummyLC\DummyLC.app"
"\Symbian\6.1\Series60\Epoc32\release\thumb\urel\DummyLC.aif"         -"!:\system\apps\DummyLC\DummyLC.aif"
;
; Install and run a server
;
"\Symbian\6.1\Series60\Epoc32\release\thumb\urel\RunMe.exe"         -"!:\system\apps\DummyLC\RunMe.exe",FR,RI
;
; Install shared component
;
@"..\..\Common\DLL\Install\newlcdll.sis",(0x1000FD000)
;
; Make sure the configuration file is removed on uninstall
;
""-"C:\system\apps\DummyLC\DummyLC.ini",FN

The details of this file will be studied in the next section.

Tutorial posted novembre 8th, 2003 by eric

Soumis par vivek (non vérifié) le jeu, 2004-01-22 06:34.

we want to instal an application using sis file .but we don't no what should be specified in the .pkg file.will u send me a reply us within 2days.our format of the .pkg is: ; ; Basic install file for minimal application ;

; Languages ; none - English only by default

; Installation header ; Only one component name as we only support English ; UID is the app's UID - see Simple.mmp

#"Minimal application",(0x100039ce),2,0,0 ; Only two files to install for the minimal application "Simple.app"-"!:\system\apps\Simple\Simple.app" "Simple.rsc"-"!:\system\apps\Simple\Simple.rsc"

; Required files ; None

; Component .sis files ; None


Soumis par Flan_Rojo (non vérifié) le lun, 2004-04-05 09:32.

Hi just wondering if u know on how to create new sis file. ? i have problems under standing the terms that they are talking abt here hope u can assist me in creating the file if u can pls reply to me thanks

Soumis par Anonymous le mer, 2004-04-07 16:05.

Hey,

You first need to create a .pkg file with directives for creating the sis file. Then you create the sis file using the makesis utility form the SDK. See the SDK topic "How to create a simple installation file" for more details

Regards, Aljaz


Soumis par alex (non vérifié) le jeu, 2004-09-16 02:45.

hi mate iv got some files and all i whant 2 do is make a .sis file ithe all them files in it. is there any way i can do it or if i send u the files could u do it for me plz? thanks

Soumis par Anonymous le dim, 2004-12-19 07:51.

How can i run an sis file on my computer. If there is any software please tell me where to download it

Soumis par Mailan (non vérifié) le mer, 2005-01-05 18:13.

Does anyone know how I can uninstall an application programmatically, i.e. without using the phone or PC UI? I understand that the .sis file created on system\install holds info on the files to be removed at uninstall, but is there a command that is run with this .sis file as a parameter which will remove the application related to the .sis file?

I need to be able to remove applications for Sony Ericsson P900/P910 remotely using a third party software without user intervention.

Thanks


Soumis par shri (non vérifié) le jeu, 2006-05-11 08:56.

can any one give me the pr requisites to start coding asis file as im new i want to knw which tools will be best for that n wht all thinga re required

Soumis par eric le jeu, 2006-05-11 09:01.

You don't code a pkg file, you just have to write it. For this, you almost need four things:
-  a text editor
-  a symbian SDK installed on your machine
-  an application ready for deployment
-  reading the PKG file syntax in the SDK help

Soumis par vinay sagar (non vérifié) le mar, 2004-02-24 10:42.

Hi All, I am using Symbian OS 7.0 and UIQ 2.1. My makesis.exe version is 2.0 . I created a sis file and tried to install, I am getting the error " incompatible installer version". Which version of makesis should i use ? thanking you vinay

Soumis par Anonymous le lun, 2004-12-27 10:10.

The version (UID) of your application should be compatible with the phone you are using or with UIQ version..... you can find common UID here (http://www.newlc.com/article.php3?id_article=149&var_recherche=UID)

Dennis


Soumis par Cuong Nguyen (non vérifié) le mer, 2004-03-03 19:43.

Is there anyway to un-pack sis file, replace some file and then re-pack it again?

Soumis par wonder (non vérifié) le ven, 2004-03-05 18:13.

There is a simple packer plugin for Total Commander for extracting *.sis files: http://www.dalibor.cz/epoc/sisview.htm

Soumis par giangcui (non vérifié) le lun, 2004-05-10 13:05.

I can't utilise with Wincmd. Help_me

Soumis par Gokcer Gokdal (non vérifié) le mar, 2004-03-23 19:37.

You can check unmakesis if you use windows. A nice free tool.

Soumis par Desperate College Student in Need of Help (non vérifié) le dim, 2004-05-23 05:57.

Hi, I am in desperate need of help to finish up my final senior project. I have been trying to find the program in which I installed using the .sis file. After sending the .sis file to my nokia 6600 phone and installing it, I have not been able to find where the application is. I searched the 'Menu' bar, but that doesnt work. Any idea on where the program was installed? Any help would be greatly appreciated! THANKS


copyright 2003-2009 NewLC SARL