Introduction to Genesis

The Hello World.exe application must be converted into a Hello World.SIS (Symbian Installation Source ) installer package for deployment to device. Genesis is a tool shipped with Net60 that generates .SIS packages from .exe files.

Genesis is a Visual Studio plug in, supporting VS 2005 & 2008 and its usage is described below. A command line version (genesis.exe) can be used for scripted builds.

Genesis in Visual Studio

1. Add a new 'Genesis' project to the Hello World solution.
   
   File -> Add -> New Project
   Specify a name for the project to be created and click 'OK', as per below. eg. HelloWorld SIS Builder
   
   
2. The Genesis Wizard will then assist you to complete the necessary configuration properties.


3. The first page of the wizard requires a short name for the application (Max 8 chars), a UID (one is auto-generated for you), and the path to the .NET .exe to be added as a dependency to the Genesis Project. In this example, we have navigated to the Hello World.exe.
   





4. Next is information pertaining to the SIS file which will be generated, namely the name and signed name. If the 'Self Sign' option is checked, you do not need to provide a Symbian Signed certificate which makes the evaluation process much easier. However, for development and distribution purposes, it is suggested that a Symbian Signed certificate is obtained.
   
   Note: In order to install 'Self Signed' applications, you must first configure your device App Manager, Software installation setting, to 'All' instead of 'Signed only'. The App Manager is normally found under 'Tools'. 
   
   Note 2: It is possible that a time difference exists between your PC and your device. This affects 'Self Signed' applications in that if the SIS is created at a time in the future, it will not install on device. The suggestion here is to set your phone's time setting to slighty ahead of your PC's time.  



5. There is a wizard screen dedicated to selecting which security capabilities your application will require. For the purposes of the Hello World.exe example, it is not necessary to select any. Leave them all unchecked.
   
   
   
6. Dependencies added to the Genesis project are embedded in the SIS file generated and are installed to device along with it. Most commonly the signed Net60.sisx in c:\Program Files\Red Five Labs\Net60 is added as a dependency as this ensures the Net60 framework is installed on the target device.
   
   Net60 is activated by means of including the net60.licence file as a dependency. Evaluators of Net60 would receive such a license file by email for a specific device IMEI.
   
   
7. Finally, additional information such as the descriptive application name, application menu icon, vendor and version number can be supplied. The icon should be provided in a Tiny SVG 1.1 or 1.2 format.



8. Once the wizard process is complete, the Hello World SIS Builder Project and its dependencies appear in the Visual Studio Solution Explorer as below: 
   

9. Properties of the SIS Builder project may be configured at a later stage by right clicking the project and selecting 'Properties' as per below:




10. The properties on the 'General' tab, as per the below example, can be edited or verified accordingly. A custom application UID may be obtained from Symbian Signed. The SVG file specifies the icon to be displayed on the S60 applications menu. An example SVG file can be found in each sample application project folder.
    
    

Build the Hello World SIS Builder Genesis Project

1. The "HelloWorld SIS Builder" project can be built by selecting the project, then right clicking and selecting 'Build'.



2. The HelloWorld.SIS and the signed HelloWorld_signed.SISX output of the build process can be found in the project folder as per below:

Deploying the HelloWorld_signed.sisx