Calendar

March 2007
M T W T F S S
« Feb   Apr »
 1234
567891011
12131415161718
19202122232425
262728293031  

Tag Cloud

Categories

Archives

Highest Rated

Most Viewed

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, 2007Print This Post Print This Post
1 Star2 Stars3 Stars4 Stars5 Stars (No Ratings Yet)
Loading ... Loading ...
844 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. <properties>
  2. <!–
  3. The application name displayed by the operating system
  4. when the appication is running. The name is also used in
  5. the application installation path and must conform to
  6. Windows and Mac OS X folder naming restrictions.
  7. >
  8. <name>MyApolloApp</name>
  9. <!–
  10. The description displayed in the Apollo application installer.
  11. >
  12. <description>This is my first Apollo Application</description>
  13. <!–
  14. The publisher string displayed in the Apollo application installer. On
  15. Windows, the publisher string is also used the application installation
  16. path and must conform to Windows folder naming restrictions.
  17. >
  18. <publisher>EverythingFlex</publisher>
  19. <!–
  20. The application copyright information. (Optional)
  21. >
  22. <copyright>EverythingFlex 2007 - Rich Tretola</copyright>
  23. </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. <icon>
  2. <image16×16>e16.png</image16×16>
  3. <image32×32>e32.png</image32×32>
  4. <image48×48>e48.png</image48×48>
  5. <image128×128>e128.png</image128×128>
  6. </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

Share/Save/Bookmark

Topics: Adobe AIR, Tutorials |

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… :-(

  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.

  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.

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

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

  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.

  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.

Comments