Framework knowledge base

Create your first app using KikApp

This document will show you how to create your first app using KikApp.IMPORTANT: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 AndroidConfiguration.properties 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.

#Android properties.
#You must register path the android sdk and if you work in windows you must register path jdk.
#unix ie.:
jdk_directory=/usr/lib/jvm/java-7-oracle/bin
android_sdk=/home/user/android-sdk
#win ie.:
#jdk_directory=C:\\Program Files\\Java\\jdk1.7.0_21
#android_sdk=C:\\Users\\AppData\\Local\\Android\\android-sdk

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 https://wiki.kikapptools.com/sign-up/
If you forgot your password, you can recover it at https://wiki.kikapptools.com/wp-login.php?action=lostpassword
User > kikappuser
Password > ******
Hi, kikappuser!!
Now you can use KikApp to develop mobile apps.
You can read framework documentation and examples at https://wiki.kikapptools.com/
If you need help with command line try 'help' for further information.

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.

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.