Getting Started with Marmalade - Marmalade SDK Mobile Game Development Essentials - page 13

The build directory
One of the directories created by the MKB file will be named build_hello_vcxx ,
where the "xx" part is dependent on the version of Visual C++ you are using.

This directory is Marmalade's working directory and is where all the object files
created during building are stored. It will also be the home to our deployment
packages when it comes to making device builds.

A Visual C++ solution file created from the MKB file also lives in this directory,
and while you can use these files to switch between projects, you should never
add files or change project settings using the options in the Visual C++ IDE.

Always make project changes to the MKB file, then either close
Visual C++ and double-click the MKB file to rebuild the solution,
or alternatively perform a build inside Visual C++ to update the
solution file with any changes. You should not make changes
directly within the Visual C++ IDE as they will be lost the next
time that the MKB file is used to recreate the project file.

The data directory
The MKB file will also generate a directory called data , and this is where Marmalade
requires you to place any files that your application will need to load, such as
images, 3D model data, sound files, and others. While you can create this directory
and these files yourself, and it will not cause a problem, we might as well let the
makefile builder do it for us!

If you take a look inside the data directory, you will see that the build process has
also created two more files called app.icf and app.config.txt . These files are
used to configure your application and are explained in the following sections.

The app.config.txt file
This file provides a list of all the application-specific settings that can be made in the
app.icf file, along with a description of what each setting does and how it is used.
There are two reasons for using this file:

1. Adding entries to this file keeps your project settings documented in a single
place, so other coders can check this file to see what a particular setting does.

2. Any setting contained in the app.icf file that is not documented in the app.

config.txt file will generate a runtime error message when you try to
specify or access it in your program.