Application Configuration

Introduction

When you are ready to master your application, the Wii U Application Configuration Tool generates the final, "official" versions of these files. This tool is a separate package from the SDK, and is available from Nintendo Developer Support.

Your application is accompanied by several files and metadata that specify various configuration settings. The SDK auto-generates most of these with common values that are appropriate for most of your development cycle. However, some applications may need to be customized; this volume describes that process.

As your application nears completion, also include other items such as icon data, audio and video for boot-up, and a user "e-manual". This volume will also describe how to develop and preview these items using the SDK.

Configuration Files

Application-specific configuration information is contained within the following XML files.

Item Description
app.xml Application configuration settings; includes Title ID, application type, and version information.
cos.xml Detailed settings related to your application binary; includes code and data sizes, program parameters, and various COS-related features.
meta.xml Product information and settings that are referenced by system titles. Includes permissions, parental controls, file system quotas, etc.

app.xml and cos.xml are located in the $CAFE_CODE_DIR directory of each application.

Application Configuration in Code Directory

If the files do not exist when the application is executed, the files are created with default values and placed in $CAFE_CODE_DIR.

All Cafe applications have an app.xml and an cos.xml configuration files.

Application Configuration in Meta Directory

Of application-specific information, information referenced by the system applications is stored in meta.xml. The following information is contained in the meta.xml:

Ultimately, a tool called an application configuration tool should be used to create meta.xml.

In the product, meta.xml should be stored in the meta directory on the application disc. In the dev environment, meta.xml should be stored in the $CAFE_META_DIR directory emulating the meta directory on PC.

In the development environment, if you run the application when a meta.xml does not exist, meta.xml is automatically created in $CAFE_META_DIR. If required by the application, default parameters may be modified in meta.xml using any text editor.

Configuration Parameters

meta.xml contains many parameters; this section explains only those of importance.

The meta.xml file captures the following application settings:

Parameter Type Length Description
version UnsignedInt 4 Data structure version of the meta.xml file. If the default meta.xml file is newer than the meta.xml file for the application (located in $CAFE_META_DIR), the meta.xml for the application is replaced by the default version.
title_id hexBinary 8 Unique identifier of the application. Title ID is specified in the app.xml for the application. The meta.xml file contains a copy. The meta.xml is generated automatically when the application executes. The Title ID parameter is copied from app.xml to meta.xml automatically. The Title ID for the application may be in the range of 0x0005000010010000-0x000500001F6FFF00.
group_id hexBinary 4 Unique identifier for the group to which the application belongs. group ID is specified in the app.xml for the application. The meta.xml file contains a copy. The meta.xml is generated automatically when the application executes. The Group ID is copied from app.xml to meta.xml automatically.
os_version hexBinary 8 Major version of Cafe OS that is required for the application. OS version is specified in the app.xml for the application. The meta.xml file contains a copy. The meta.xml is generated automatically when the application executes. The OS version is copied from app.xml to meta.xml automatically.
common_save_size hexBinary 8 The quota size of the common save directory (bytes). This is the upper limit for all of the common files, directories, and management information that can be stored in the common save directory.1
account_save_size hexBinary 8 The quota size of the save directory per account (bytes). This is the upper limit for all of the files, directories, and management information that can be stored in the save directory for each account.1

1For information about quotas and appropriate quota sizes, see Save Data Handling Guide and Quota Size Calculation Sheet in Overview under Game Save Library.

Icon Data

The icon is displayed by the Cafe Launcher Menu. Users select on the icon to run the application.

Item Description
iconTex.tga 32-bit TGA with alpha channel (RGBA), 128 × 128 (col × row).

The Wii U Application Configuration Tool converts and packages the icon data when you are ready to master your application.

Transition Data

The transition data is the audio and video that are played while your application is booting.

Item Description
bootSound.btsnd Stereo sound, 20 seconds or less, played while your application is booting.
bootTvTex.tga Static image displayed on television (1280 × 720 pixels) while your application is booting.
bootDrcTex.tga Static image displayed on the DRC (854 × 480 pixels) while your application is booting.

See Also

The app.xml file
The cos.xml file
The meta.xml file

Revision History

2013/08/06 Removed references to older SDKs and cleanup.
2013/05/08 Automated cleanup pass.
2011/02/21 Initial version.


CONFIDENTIAL