The app.xml File

Introduction

The app.xml file contains your application's Title ID, type, and version information. This file is generated automatically by the SDK with default values that are appropriate for most of your development cycle.

When you are ready to master your application, the Wii U Application Configuration Tool helps you gather all of the configuration settings of your application and generates the production version of app.xml. This tool is available separately from the SDK. Contact your local Nintendo developer support group for more information.

NOTE:
The app.xml file is published along with your application. It cannot be changed at runtime.

app.xml is located in your application's /code directory at runtime. When you run your application with the caferun or cafex run launching command using PCFS, /code is mounted from the host PC directory that contains your RPX file, and the launching command creates the CAFE_CODE_DIR environment variable to refer to that host PC directory.

If app.xml does not exist when you run your application, the launching command will create it in $CAFE_CODE_DIR using default values.

Description

This section describes some of the parameters of the app.xml file.

Parameter Type Length
(bytes)
Description
version unsignedInt 4 Data structure version of the app.xml file.
os_version hexBinary 8 Major version of Cafe Core OS (COS) required for the application. Expressed as the (entire) title ID of the required COS.
title_id hexBinary 8 Title ID of the application.
title_version hexBinary 2 Version of the application.
sdk_version unsignedInt 4 Version of SDK used to build the application. Informational only.
app_type hexBinary 4 Application type; reserved for use by Nintendo.
group_id hexBinary 4 Group of which the application is a member; reserved for use by Nintendo.

Version

If the application's app.xml data structure version is older than the version in the SDK, the application's app.xml file will be replaced by the default one. This will occur when you run your application.

OS Version

This parameter specifies the Cafe Core OS (COS) major version required for your application. This value is auto-generated by the SDK and must not be modified.

The COS major version number is incremented with each SDK release.

The COS version is expressed as the title ID of the COS required by your application. For example, for SDK 2.08, this parameter is set to:

000500101000400A

The actual COS version is the last byte in the COS title ID (0x0A).

Title ID

This is the title ID for your application. The SDK provides default values for your application:

NDEBUG: 0005001B10054000
DEBUG : 0005001B10058000

Nintendo will provide the production title ID before your application is ready for mastering.

For more information, refer to the Title ID.

Title Version

The title_version parameter identifies each release of your application. This parameter is ultimately set by the Wii U Application Configuration Tool.

SDK Version

The sdk_version parameter specifies the version of Cafe SDK with which the application was built. This parameter is for information only.

Application Type

The app_type parameter is reserved for use by Nintendo. The default application type for games is 0x80000000.

Group ID

The group_id parameter is reserved for use by Nintendo.

See Also

Application Concepts
The cos.xml file
The meta.xml file

Revision History

2015/01/29 Clarify the setting of CAFE_CODE_DIR.
2013/05/08 Automated cleanup pass.
2011/02/21 Initial version.


CONFIDENTIAL