KuneriLite Wizard Beginner's Guide
From KuneriLite wiki
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.
- 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
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.
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.
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:
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:
Just replace the “Missing Path x” texts with the missing paths. Such as;
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:
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.
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.
Enter Application parameters
Main SWF (required)
Press Browse button and add your Flash Lite SWF file, it will be executed when application starts.
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.
Specifies the folder for the application icon in phone main menu. It can be for example:
This is the name of the application.
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.
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
Required only when the Professional or Commercial KuneriLite version is used. In such a case, browse to your specific KuneriLite package directory (rsc).
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.
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.