Setting desktop application propertiesSet the basic application properties in the application descriptor file. This section covers the properties relevant to desktop AIR applications. The elements of the application descriptor file are fully described in AIR application descriptor files. Required AIR runtime versionSpecify the version of the AIR runtime required by your application using the namespace of the application descriptor file. The namespace, assigned in the application element, determines, in large part, which features your application can use. For example, if your application uses the AIR 1.5 namespace, and the user has AIR 2.5 installed, then your application sees the AIR 1.5 behavior (even if the behavior has been changed in AIR 2.5). Only when you change the namespace and publish an update will your application have access to the new behavior and features. Security and WebKit changes are the primary exceptions to this policy. Specify the namespace using the xmlns attribute of the root application element: <application xmlns="http://ns.adobe.com/air/application/2.5"> Application identitySeveral settings should be unique for each application that you publish. The unique settings include the ID, the name, and the filename. <id>com.example.MyApplication</id> <name>My Application</name> <filename>MyApplication</filename> Application versionIn versions of AIR earlier than AIR 2.5, specify the application in the version element. You can use any string. The AIR runtime does not interpret the string; “2.0” is not treated as a higher version than “1.0.” <!-- AIR 2 or earlier --> <version>1.23 Beta 7</version> In AIR 2.5 and later, specify the application version in the versionNumber element. The version element can no longer be used. When specifying a value for versionNumber, you must use a sequence of up to three numbers separated by dots, such as: “0.1.2”. Each segment of the version number can have up to three digits. (In other words, “999.999.999” is the largest version number permitted.) You do not have to include all three segments in the number; “1” and “1.0” are legal version numbers as well. You can also specify a label for the version using the versionLabel element. When you add a version label, it is displayed instead of the version number in such places as the AIR application installer dialogs. <!-- AIR 2.5 and later --> <versionNumber>1.23.7<versionNumber> <versionLabel>1.23 Beta 7</versionLabel> Main window propertiesWhen AIR starts an application on the desktop, it creates a window and loads the main SWF file or HTML page into it. AIR uses the child elements of the initialWindow element control the initial appearance and behavior of this initial application window.
Desktop featuresThe following elements control desktop installation and update features.
Supported profilesIf your application only makes sense on the desktop, then you can prevent it from being installed on devices in another profile by excluding that profile from the supported profiles list. If your application uses the NativeProcess class, then you must support the extendedDesktop profile. If you leave the supportedProfile element out of the application descriptor, then it is assumed that your application supports all the defined profiles. To restrict your application to a specific list of profiles, list the profiles, separated by whitespace: <supportedProfiles>desktop extendedDesktop</supportedProfiles> For a list of ActionScript classes supported in the desktop and extendedDesktop profile, see Capabilities of different profiles. Application iconsOn the desktop, the icons specified in the application descriptor are used as the application file, shortcut, and program menu icons. The application icon should be supplied as a set of 16x16-, 32x32-, 48x48-, and 128x128-pixel PNG images. Specify the path to the icon files in the icon element of the application descriptor file: <icon>
<image16x16>assets/icon16.png</image16x16>
<image32x32>assets/icon32.png</image32x32>
<image48x48>assets/icon48.png</image48x48>
<image128x128>assets/icon128.png</image128x128>
</icon>
If you do not supply an icon of a given size, the next largest size is used and scaled to fit. If you do not supply any icons, a default system icon is used. Ignored settingsApplications on the desktop ignore application settings that apply to mobile profile features. The ignored settings are:
|
|