KuneriLite Wizard Beginner's Guide

From KuneriLite wiki

Contents

Introduction

KuneriLite is made easy for you to install and use on your PC. Setting up KuneriLite is as simple as installing any other application, and usage doesn't require any advanced knowledge.


Minimum requirements

  • Windows XP SP2
  • 1GHz Pentium PC
  • 256MB RAM (512 recommended)
  • 500MB HDD space
  • Internet connection


Download and Install

Get the latest version of KuneriLite from KuneriLite website. After downloading the package, double click the package and install it on your system. Rest is very easy; just follow the steps.


Setup your PC

Java runtime

If you already do not have Java runtime installed on your system, go to J2SE v 1.4.x download page and get the latest version of J2SE JRE package (1.4.x_xx). After your download is complete, install the package with default settings. It's recommended that you restart your machine after installation. When installation is completed successfully, proceed to next step.


Active Perl

If you already do not have Active Perl installed on your system, go to Active Perl 5.8.x download page and get the latest version of Windows(x86) MSI package. After it's downloaded, install it with typical settings and restart your machine. Now you can proceed to next step.


Symbian S60 3rd edition SDK Maintenance Release

Now you have Java and Active Perl installed on your PC. It's time to go to Forum Nokia site and get S60 3rd edition SDK Maintenance Release. If it's your first time on Forum Nokia, you will need to register (it's free) and download the package. It's almost 400MB, therefore be patient.

When package is downloaded, install it on your PC with typical settings and CSL ARM Toolchain (GCCE). As installation is completed, reboot your machine.

Note: KuneriLite is compatible also with S60 3rd Edition FP1 SDK, but using it does not have any benefit, plus start.cmd has to be modified for FP1 SDK paths.

Environment variables

In order to ensure everything is done correctly, check your Path Environment Variables. Easiest way to do that is to run cmd.exe from Run in Start and type “Path”. Then compare the results with the list below:

Image:Path.GIF

These should be exactly in same order. If all fine, we are almost done.

In case these variables are not in your path, go to KuneriLite\ directory in your C: drive and find start.cmd. Edit this file and make it look like that:

Image:startcmd.gif


Just replace the “Missing Path x” texts with the missing paths. Such as;

Image:path_added.GIF

For MS Vista support, please see here.


If you want to use S60 3rd Edition FP1 SDK instead of MR, 
modify start.cmd accordingly: \9.1\S60_3rd_MR -> \9.2\S60_3rd_FP1


If you want to automatically switch between SDKs (devices), 
for e.g. from S60 3rd Edition FP1 SDK into MR SDK and back,
add this to start.cmd:
devices -setdefault @S60_3rd_MR:com.nokia.s60

and add this to end.cmd:
devices -setdefault @S60_3rd_FP1:com.nokia.s60

Test your installation

You downloaded and installed everything, now it's time to give it a try. Launch KuneriLite application and select “Test your KuneriLite setup” from main menu. Click on the big icon and a command line window should open and display the compilation process. When all progress finishes, Testing KuneriLite Setup command line window will close (success) or remain open and wait for you to press a key (failure). Go to KuneriLiteTest directory that is located in \KuneriLite\Projects\KuneriLiteTest and see if KuneriLiteTest_3rd_edition_signed.sis exists. If you see the file, voila! You successfully installed KuneriLite on your machine.

Creating your first project

You installed KuneriLite, created test application, developed a Flash Lite application using KuneriLite and now you are ready to create your first KuneriLite project.


Prepare your project folder

There are 3 basic steps preparing your project;


Create your project folder

You can either manually create your project folder by going to C:\KuneriLite\Projects and create your project folder MyFirstProject or let KuneriLite create the folder (if doesn't exist) in Create Project screen.

When you are done, it should look like this:

Image:ProjectFolder.png

Create project

Open KuneriLite and select Create a new KuneriLite project in main menu. Fill Project Name and select KuneriLite plug-ins you used in your project. Release notes is mandatory to fill, therefore leave it as it is, or enter a convenient text to that field. This text will be shown to user before installation. You can also choose "Use external player" option, if you developed for a development player (2.x or 3.x) and would like to launch the application using one of those players. It is recommended to always enable the option "Use stub".
This is for advanced use: Force Flash Lite. When enabled, application can be required to launch only devices having Flash Lite 2 or 3 player. I.e. not supporting Flash Lite 1.x devices. Maximum memory: Defines maximum possible RAM value for application. It should be close to actual value which application needs.

Check information again and proceed to next step.

Image:CreateProject.png

Add project files

In many projects, we have more than one SWF file or other project files. We need to add these file to our package, after creating the basic package.

Create a subfolder in project directory, and place all files as you would like them to be placed on device.

Suppose we have a database file MyFirstProject.db in our first project. To include this database file to our final package, we need to add it to our project. Place the additional file (MyFirstProject.db) to a subfolder.

Press on Browse button and browse to the subfolder you created and put MyFirstProject.db. If you wan't to install files into other that application install directory (default) you can also enter Target path. When you are ready, just proceed to next step.

Image:AddProjectFiles.png

Enter Application parameters

Main SWF (required)
Press Browse button and add your Flash Lite SWF file, it will be executed when application starts.

Grid Icon
If you wish, you can create your custom icon for your installation package. This icon will show up in the phone menu with your application. If you do not create a custom icon, KuneriLite will use its default icon for you, so no worries. You can put your icon file (i.e MyFirstProject.svg) in MyFirstProject in Projects folder and browse to the directory using Browse button.

Grid Menu
Specifies the folder for the application icon in phone main menu. It can be for example: "Games", "Office", etc.

Grid Caption
This is the name of the application.

Install Path
If you wish to change your applications target installation path (by default it is \data\[name] ), input the path here (for e.g. \MyApp\)

UID (required for final applications)
In case you wan't to enter UID (recommended for final released applications). UID must be given in form: A0001234. For test projects and not signed applications, it should be from unprotected range. If you enter UID from protected range (2*******), you need to sign your application (see Signing arguments below).

Pkg UID (optional)
You don't need to fill this value. KuneriLite will automatically use the same value than UID as Package UID, which is preferred by Symbian.

Port (optional)
The port number for KuneriLite localhost communication. Use the same port as found in Flash Lite loadVariables() implementation.

Signing arguments (optional)
(Certificate, Key file, Password) Needed when application will be signed using Developer certificate (Publisher-Id is required). By default applications will be automatically selfsigned, no certificate needs to be given. However, the GPS plug-in needs always signing.
If you don't own a Publisher-Id, you need to follow SymbianSigned Open Signed process and request a non/commercial version of GPS-plugin from Kuneri. http://wiki.kunerilite.net/index.php?title=Signing

KL Path
Required only when the Professional or Commercial KuneriLite version is used. In such a case, browse to your specific KuneriLite package directory (rsc).

Compiler (optional)
Use this if you have a compiler other than GCCE in use (ARMI). GCCE is used by default and it is included in S60 SDK.

Version (optional)
This will be shown to users during the application installation process. It is given in the string format, "x.x.x" (e.g. 1.0.1)


When the arguments are ready, SIS creation is ready to start.

Create SIS file

Now the last step of the project; we will create the SIS installation package. Under Main text field, browse and select the MyFirstProject.swf. Likewise, browse and use MyFirstProject.svg for the Grid Icon text field. By entering these, we tell the application that we will launch MyFirstProject.swf, first, and use MyFirstProject.svg as the application icon. For any empty fields, default values will be used and assumed.

When you are done, press Compile button. It will take couple of minutes to complete. Please be patient and try not to interrupt the process until it's done. If everything goes fine, you will see MyFirstProject_3rd_edition_signed.SIS file in your project folder. Now you are done and you can test your project on any Nokia S60 3rd edition handset.

Image:CreateSIS.png

Personal tools