QuickStart Guide

Pre-requisites before getting started are:

  1. Nokia PC Suite  [26.2MB]
    Nokia PC Suite is used to install signed Symbian .SISX files onto device.
  2. S60 3rd edition SDK [328 MB]
    The S60 3rd edition SDK is required to gain access to the SignSis &MakeSis tools which are used to create & sign SIS installer packages. A Forum Nokia account is required.
  3. .NET Framework Version 2.0 (Redistributable) [22 MB]
  4. SDK for Windows Mobile 2003-based Smartphones (Visual Studio 2003 users only) [53MB]
  5. ActivePerl 5.8 for Windows 32bit from ActiveState (Symbian Tool Chain has a dependency on it) [14MB]

 

Introduction

The Quick Start guide aims to introduce the process of running a .NET Compact Framework application on an S60 device using Net60. A basic 'hello world' style .NET CF 1.0 application will be used to demonstrate the process.

Please ensure that the Net60.exe is installed on your PC.

Quick Start Guide Contents

Step 1 - Open a sample Smartphone 2003 application


.NET Compact Framework 1.0 applications are created by choosing Smart Device projects for Smartphone 2003 in Visual Studio when creating new solutions.

For convenience such a CF 1.0 application, the "Hello World" sample project, can be found in the default Net60 install path:
C:\Program Files\Red Five Labs\Net60\Sample Projects\Hello World


Building Hello World.exe

  1. Open Visual Studio
  2. Open the "Hello World.sln" file in the \Sample Projects\Hello World folder.
  3. Build the solution. The Hello World.exe output file will be a CF 1.0 application.
 

Step 2 - Add a Genesis Project (and configure its properties)

 

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 and its usage is described below. Customers who do not have Visual Studio 2005 can use a command line version (genesis.exe).

 

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 new 'HelloWorld SIS Builder' project will appear in the Solution Explorer as below:

  3. Right click the project or "HelloWorld SIS Builder" and select 'Add Dependency File'.





  4. Browse to and select the output binary 'HelloWorld.exe". This is the .exe which will be included in the generated .sis file.



  5. Repeat the 'Add dependency' step above for the Net60.licence file which must also be added as a dependency. The licence file is normally provided separately by email.

  6. Add another dependency on the signed Net60.sisx in c:\Program Files\Red Five Labs\Net60

  7. The dependencies will then be displayed in the Visual Studio Solution Explorer as below:

  8. Next the properties of the SIS Builder project need to be configured by right clicking the project and selecting 'Properties' as per below:



  9. The properties on the 'General' tab need to be entered as per the below example. The Application UID is 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.


back to top

Step 3 - Build a SIS

Once the Genesis project is added and configured, it is easy to build the SIS which is output into a sub-folder.

Build Hello World.sis

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


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

back to top

Step 4 - Symbian Sign the SIS file (and deploy to device)


The Genesis Visual Studio plug-in also automates the Symbian Signing of the Hello World.sis file by specifying the .cer, .key and password in the 'Symbian Signing' properties tab.

Sign Hello World.sis


  1. Complete the 'Symbian Signing' properties tab as per below. (Users who do not have .cer & .key files for their device can find out more about Symbian Signed here.

  2. Right click the project file and select 'Build'.


  3. The Hello World.sisx will be output to the same folder as the Hello World.sis as shown below:

  4. Deploy the application to device by double clicking "Hello World.sisx" and accepting the Nokia Application Installer prompt below:

    (it is assumed the device is connected to the PC at this point, and that Nokia PC Suite is installed.

  5. Congratulations! Hello World will now be installed on your S60 device's application menu.
back to top

Pre-requisites

Please make sure that you have installed the S60 3rd edition SDK, and if you're a MS Visual Studio 2003 user, the Smartphone 2003 SDK. If you have any difficulties following this guide or need general support please email support (at) redfivelabs.com.