Create your first app using KikApp

This document will show you how to create your first app using KikApp.

Before creating your app you should check out KikApp requirements.
In this tutorial we named KIKAPP_PATH to the place where you have downloaded KikApp.

1. First you need to modify the file under KIKAPP_PATH. Next to jdk_directory, you will have to put the path where you installed the jdk. The same happens for android_sdk.

For example (remember to erase the # comment tag in your platform values):
jdk_directory= C:\\Program Files (x86)\\Java\\jdk1.7.0_79
android_sdk= C:\\Program Files (x86)\\Android\\android-sdk

#Android properties.
#You must register path the android sdk and if you work in windows you must register path jdk.

#unix ie.:

#win ie.:
#jdk_directory=C:\\Program Files\\Java\\jdk1.7.0_21

2. Now, open a terminal and go to KIKAPP_PATH.. Then, type kikapp and press enter to start KikApp CLi.
If you are using unix platform you should type ./kikapp.
You will be asked to login, if you don’t remember your user details you can recover it here.

> ./kikapp
You need to login
If you do not have an account, you can create it at
If you forgot your password, you can recover it at

User > kikappuser
Password > ******
Hi, kikappuser!!
Now you can use KikApp to develop mobile apps.
You can read framework documentation and examples at
If you need help with command line try 'help' for further information.

3. After that, you can create a new project, typing:

KikApp > new -myAppName -/home/myFirstApp/
========== Create project ==========
Reserving space on the server, please wait...
Creating project, please wait...

4. After doing all of the past steps, you are able to compile your app. In the console, type “build” and your app will start to compile.

Note: After your app has compiled you will need to copy the services folder from your project folder into the root of your web server (“http://localhost/services/”). This must be done every time you build your app. Additionally, if you rename the services folder when you copy it to your web server you will have to update the Manifest.xml file in your program to contain the new name path, then you should build again. By default Manifest.xml points to http://localhost/services/

* The services folder for the myAppName example can be found here:
Linux/Unix: /home/myAppName/project/services
Windows: C:\myAppName\project\services

* The Manifest.xml file for the myAppName example can be found here:
Linux/Unix: /home/myAppName/config/Manifest.xml
Windows: C:\home\myAppName\config\Manifest.xml

Compile platform: If you want to compile and run on iOS you must set generateiOS=”true” and generateAndroid=”false” on your project’s Manifest.xml. If you want to compile and run on Android you must set generateiOS=”false” and generateAndroid=”true” on your project’s Manifest.xml.

KikApp > build
========== Build project started ==========
========== Generation Smart Devices started ==========
Generating to main.php
========== Generation CSS started ==========
Generating to Android.css
========== Generation Spec started ==========
Generating to main
Generating to main_Level_Detail
Generating success
========== Generation PHP Services started ==========
========== Generation htaccess started ==========
Generating success
========== Uploading project, please wait ==========
Upload success
Building project, please wait...
16384 bytes read from stream
17011 bytes read from stream
33395 bytes read from stream
34419 bytes read from stream
50803 bytes read from stream
51827 bytes read from stream
68211 bytes read from stream
69235 bytes read from stream
85619 bytes read from stream
86643 bytes read from stream
103027 bytes read from stream
104051 bytes read from stream
108156 bytes read from stream
Total Size of file in bytes = 108156
info: Remember to update rest services /home/myFirstApp/myAppName/project/services/ in your server

5. If you want to run the app in your device or an Android Emulator, type “run”. You can also type “build-run” and it will compile and run it automatically. Before execute run command you need to build your app.

KikApp > run
========== Run project started ==========
Starting a new Gradle Daemon for this build (subsequent builds will be faster).
Generated Settings applied.
Parallel execution is an incubating feature.
Pre-dex enabled.
:main:processReleaseJavaRes UP-TO-DATE
jar signed.
Installing apk on devices
	pkg: /data/local/tmp/main.apk
Installed Application
Starting Application
Starting: Intent { cmp=com.kikapp.myappname/.Main }

6. If you do not remember a command, you can always type “help” and you will get the key words plus the correct format.



If you get any error, please let us know. You can submit a ticket to our support team.

Rate This Article

(2 out of 4 people found this article helpful)