khafile.js

Kha uses a javascript file called khafile.js where you configure your project. A basic khafile.js looks like this:

var project = new Project('ProjectName');

project.addAssets('Assets/**');
project.addSources('Sources');

resolve(project);

This set the Assets and Source folders, and uses the default configuration for other options.

Adding Assets

Basic

Set the Assets folder:

project.addAssets('Assets/**');

Advanced

khamake will flatten your directory structure during preprocessing. Suppose you have some non-unique files like map.txt in folder1 and folder2. Using the basic version will actually give you an error during preprocessing, as khamake will try to create kha.Assets.blobs.map_txt twice. To fix that, specify some patterns to actually keep the folder structure in the generated sources.

Asset folder layout

/assets
   /folder1
      map.txt
   /folder2
      map.txt

khafile.js

project.addAssets('assets/**', {
    nameBaseDir: 'assets',
    destination: '{dir}/{name}',
    name: '{dir}/{name}'
});

Now access them with

kha.Assets.blobs.folder1_map_txt
kha.Assets.blobs.folder2_map_txt

Add a Source folder

project.addSources('Sources');

You can use multiple source folders, including external folders.

Add a library to the project

project.addLibrary('Kha2D');

The library needs to be in a folder called 'Libraries' in the root of your project, or can be a haxelib library.

You may also define your own libraries folder with:

project.localLibraryPath = 'libs';

Add a Shader folder

project.addShaders('Sources/Shaders/**');

Add a Compiler Flag

project.addParameter('-dce full');
project.addParameter('-main Main');

Register callbacks for build events

khafiles can react to specific events during the build process.

callbacks.preAssetConversion = () => { };
callbacks.preShaderCompilation = () => { };
callbacks.preHaxeCompilation = () => { };
callbacks.postHaxeCompilation = () => { };
callbacks.postCppCompilation = () => { };

Add a Conditional Compililation Flag

project.addDefine('debug_collisions');

Set the initial window size in flash and html5

project.windowOptions.width = 1366;
project.windowOptions.height = 768;

Set specific options for the flash target

project.targetOptions.flash.swfVersion = 11.6;
project.targetOptions.flash.framerate = 42;
project.targetOptions.flash.stageBackground = 'ff0000';

Set specific options for the android-native target

project.targetOptions.android_native.package = 'com.example.app';
project.targetOptions.android_native.screenOrientation = 'portrait';

Set specific options for the android (Java) target

project.targetOptions.android.package = 'com.example.app';
project.targetOptions.android.screenOrientation = 'portrait';

Set specific options for the iOS target

project.targetOptions.ios.bundle = 'com.example.$(PRODUCT_NAME:rfc1034identifier)';
project.targetOptions.ios.organizationName = 'Your Awesome Organization';

Set specific options for the HTML5 target

project.targetOptions.html5.canvasId = 'my-custom-canvas-id';
project.targetOptions.html5.scriptName = 'my-custom-script-name';
project.targetOptions.html5.webgl = false;