Important Notes on Using the AIR Badge Installation

January 25th, 2008

I just had a few emails from someone who was implementing the install badge on a site. The problem he was having was twofold.

First, the application was not launching after installation (even if the launch application button was checked). This made the installation process a bit confusing for the end-user. This leads to my first important point: You must have allowBrowserInvocation set to true in your application descriptor file for the install badge to be able to launch your application after installation (as in Code Example 1).

PLAIN TEXT

XML:

<!-- Whether the application can be launched when the user clicks a link in a web browser.
Optional. Default false. -->
<allowBrowserInvocation>true</allowBrowserInvocation>

Code Example 1 - Enabling Browser Invocation in the Application Descriptor File

The second problem was that the install badge would fail if it needed to install AIR. If the end-user already had AIR installed, it worked fine. This brings up another important point. The AIR installation will fail if your stage is not big enough for the AIR Installer dialog box (see Figure 1). If you keep the default values (width: 217, height: 180) as the minimum, you should not have any problems. I will probably update my InstallBadge.js file to set these as minimum values sometime this week (you can read more about the InstallBadge.js file and how to use the install badge here).

AIR Installer Dialog

Figure 1 - AIR Install Dialog

Reference
Deploying Adobe AIR applications seamlessly with the badge install feature
Launching an Application from the Browser

4 comments on “Important Notes on Using the AIR Badge Installation”

01

Good info to know, I recently added the installer badge following your examples and it was really easy. I had to modify the html page because I was using it as an include file in my blog so I had to adjust the paths and take out the body/header tags simply because I didnt need them. Thanks again for putting those post out there, they helped me a ton!

http://justjoshn.com/extras/examples/contact-manager-air-example

Joshua Rodgers at January 25th, 2008 around 8:29 am
02

Great! I am glad that it helped out.

David Tucker at January 25th, 2008 around 11:22 am
03

I’m annoyed that your instruction PDF says source files are in the SRC directory and what do I find? No FLA files.

Arby at May 1st, 2008 around 4:03 pm
04

@Arby - The source for the install badge is in the Adobe AIR SDK - not in my exercise files. You can download the Adobe AIR SDK here:

http://www.adobe.com/products/air/tools/sdk/

David Tucker at May 1st, 2008 around 4:16 pm