Calendar

March 2007
S M T W T F S
« Feb   Apr »
 123
45678910
11121314151617
18192021222324
25262728293031

Tag Cloud

Categories

Archives

Recent Posts

Recent Comments


« Deploy an AIR file with FlexBuilder | Main | Write your first file to the file system using Apollo »

Editing the Apollo Descriptor File

By Rich Tretola | March 19, 2007
2,791 views

The descriptor file is used by the installer to define the application name, publisher, description, copyright, and icons. Open the project named MyApolloApp that was created in the “Creating your first Apollo Application with Flex Builder” and edit the publisher, description, and copyright information within the properties section of MyApolloApp-App.xml.

Your file should look something like this:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<properties>
<!–
The application name displayed by the operating system
when the appication is running. The name is also used in
the application installation path and must conform to
Windows and Mac OS X folder naming restrictions.
>
<name>MyApolloApp</name>
<!–
The description displayed in the Apollo application installer.
>
<description>This is my first Apollo Application</description>
<!–
The publisher string displayed in the Apollo application installer. On
Windows, the publisher string is also used the application installation
path and must conform to Windows folder naming restrictions.
>
<publisher>EverythingFlex</publisher>
<!–
The application copyright information. (Optional)
>
<copyright>EverythingFlex 2007 - Rich Tretola</copyright>
</properties>

Now Export the application (see “Deploy an AIR with FlexBuilder“). The results will be that the installer now looks like this:

installer1.jpg

The About MyAppolloApp will now look like this:

myapolloapp.jpg

OK, now lets add some custom icons to the installation. You can test with these if you wish:

e16.png e32.png e48.png e128.png

Add these icons to the root of your project and edit the icon section of the MyApolloApp-App.xml file so it looks like this:

1
2
3
4
5
6
<icon>
<image16×16>e16.png</image16×16>
<image32×32>e32.png</image32×32>
<image48×48>e48.png</image48×48>
<image128×128>e128.png</image128×128>
</icon>

Be sure to uncomment the icon section so it is included when you export the application to the new AIR file. You may also wish to change the version number of the application to .5 so that it will automatically update the installed version to the newer version.

<application xmlns=”http://ns.adobe.com/apollo/application/1.0.M3″ appId=”MyApolloApp” version=”.5″>

Export the application and be sure to include these icons in the AIR package.

icons1.jpg

Run the installer again and you will now see the new icons when you view the installed application and when running the application.

MAC

installer2.jpg

installer3.jpg

WINDOWS XP

myapolloapp2.png

myapolloapp.png

Topics: Adobe AIR, Tutorials | 6 Comments »

6 Responses to “Editing the Apollo Descriptor File”

  1. argv Says:
    March 22nd, 2007 at 5:06 am

    hi,

    that doesn’t work by me. the iconspath is correct and i include them also when i deplay the air file…but when i install my application, my icons don’t appear… :-(

    Reply to this comment

  2. everythingflex Says:
    March 22nd, 2007 at 6:15 am

    Just put the icons in the root of your application and be sure to include them when you generate the air file as shown in the pictures in this tutorial.

    Reply to this comment

  3. argv Says:
    March 22nd, 2007 at 7:01 am

    —> Be sure to uncomment the icon section so it is included when you export the application to the new AIR file.

    Reply to this comment

  4. everythingflex Says:
    March 22nd, 2007 at 7:08 am

    yes, that is in the tutorial above, right after the XML block

    Reply to this comment

  5. Marco Gutierrez Says:
    September 5th, 2007 at 3:21 pm

    Hello,

    I am working in Apollo, but it there a problem with the icons of application (.air). I modify the file descriptor, but the icons do not appear. Very thanks for the collaboration.

    Reply to this comment

  6. everythingflex Says:
    September 5th, 2007 at 10:22 pm

    You need to include the icons in the build of the AIR package and make sure the path to them is set correctly in the configuration file.

    Reply to this comment

Comments