Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]


Application registration files

[Top]


Introduction

An application registration file defines information about an application that is required by the application launcher or system shell. This includes the application’s name, UID and properties. Other information required by the shell, for instance the icons and captions, is defined separately; the location of the icon/caption definitions is provided in the registration file. Before v8.1, all of this information was provided by aif files. In v8.1, both aif files and registration files are supported, but from v9.0 onwards, only registration files are supported.

Registration files


Registration files

This diagram shows:

  • a registration file that specifies the name and location of the file (excluding extension) that defines the icons and captions, (\resource\apps\AppName_loc). By convention, the registration file has the same filename as the application, but with a _reg suffix. All registration files on the emulator are located in \private\10003a3f\apps, on the same drive as the application.

  • three versions of the localisable icon/caption definition file. One of them only will be loaded, depending on the phone's language setting. AppName_loc.rsc is the default, meaning that it will be used if there is no version whose extension matches the current system language. By convention the icon/caption definition file has the same name as the application, but with a _loc suffix. Note that icon/caption information may alternatively be defined in the UI resource file, in which case an icon/caption definition file is not required.

  • Two icon files, whose location is specified in the the icon/caption definition file. AppName_loc.r01 and AppName_loc.r02 share the same icon file.

A registration file is required by every application, even if it has default properties, icons and caption. Minimally, it must specify the application's UID and the name of the application’s executable.

For an example, see An example registration file and icon/caption file.

[Top]


Registration information

A registration file defines the following non-localisable application information; in other words, information that never varies according to the phone’s language setting:

All of these properties are defined using an APP_REGISTRATION_INFO resource struct. See its declaration in AppInfo.rh for the default values. For more information about these properties, see Defining application icons, captions and properties.

Most applications also need to define localisable information, for instance non-default captions and icons and possibly a group name (described above). The registration file specifies its location. This can be done in one of two ways: