Quick tip (AIR): Updating an existing AIR app for using a new certificate

First of all thanks Adobe for sponsoring a Thawte certificate after adding ThunderBolt AS3 Console to the new Adobe Marketplace!

If you will ever certificate an existing AIR app with a new certificate, such as a Thawte certificate, you have to migrate it.

What does “migrate” mean? It’s like an injection for an AIR app with all needed information about old and new certificate. You have to do it to avoid any troubles updating an existing AIR app by users. Just follow the next steps:

1. Build your AIR app as always using Flex Builder and signing it up with the new certificate ( Project -> Export Release Build )
2. Open Terminal and go to project folder typing cd {pathToYourProject}
3. Migrate your new AIR app with the old certificate using -migrate command. Note: To run this command make sure that you have added the bin folder of Flex SDK as a PATH environment variable before.

   Run:

   adt -migrate -storetype {fileTypeOfOldCertificate} -keystore {pathToOldCertificate} {appJustCreated}.air {newMigratedApp}.air

4. Type password of the old certificate and that’s it!
5. For updating ThunderBoltAS3 Console I did it as follow:

adt -migrate -storetype pkcs12 -keystore air_websector_certificate.p12 ThunderBoltAS3Console.air ThunderBoltAS3Console_v2.2.air

Some notes:
- pkcs12 – store type of the old certificate (such as JKS, PKCS12, PKCS11, KeychainStore, Windows-MY or Windows-ROOT)
- air_websector_certificate.p12 – path to the old certificate
- ThunderBoltAS3Console.air – app which has been built before with a new certificate
- ThunderBoltAS3Console_v2.2.air – app which has to migrate

6. For more information check “Changing certificates” and “Signing an AIR file to change the application certificate” at LiveDocs for Adobe AIR.

-Jens

AIR