De updatedescriptorbestanden definiëren en het AIR-bestand aan uw webserver toevoegen

Wanneer u het AIR-updateframework gebruikt, definieert u de basisgegevens over de beschikbare update in updatedescriptorbestanden die worden opgeslagen op uw webserver. Een updatedescriptorbestand is een eenvoudig XML-bestand. Het updateframework dat is opgenomen in de toepassing, controleert dit bestand om na te gaan of een nieuwe versie is geüpload.

De indeling van het updatedescriptorbestand is gewijzigd voor AIR 2.5. De nieuwe indeling maakt gebruik van een andere naamruimte: De oorspronkelijke naamruimte is “http://ns.adobe.com/air/framework/update/description/1.0”. De naamruimte van AIR 2.5 is "http://ns.adobe.com/air/framework/update/description/2.5".

AIR-toepassingen die vóór AIR 2.5 zijn gemaakt, kunnen alleen de updatedescriptor van versie 1.0 lezen. AIR-toepassingen die zijn gemaakt met het updaterframework van AIR 2.5 of hoger, kunnen alleen de updatedescriptor van versie 2.5 lezen. Vanwege deze oncompatibiliteit in versies moet u vaak twee updatedescriptorbestanden maken. De updatelogica in de AIR 2.5-versies van uw toepassing moet een updatedescriptor downloaden die gebruikmaakt van de nieuwe indeling. Eerdere versies van uw AIR-toepassing moeten de oorspronkelijke indeling blijven gebruiken. Beide bestanden moeten worden bewerkt voor elke update die u uitbrengt (totdat u stopt met het ondersteunen van versies die zijn gemaakt vóór AIR 2.5).

Het update-descriptorbestand bevat de volgende gegevens:

  • versionNumber —De nieuwe versie van de AIR-toepassing. Gebruik het element versionNumber in updatedescriptors die worden gebruikt om AIR 2.5-toepassingen bij te werken. De waarde moet dezelfde tekenreeks zijn die wordt gebruikt in het element versionNumber van de nieuwe AIR-toepassingdescriptorbestand. Als het versienummer in het update-descriptorbestand niet overeenkomt met het versienummer van het geüpdate AIR-bestand, produceert het framework een uitzonderingsfout.

  • version —De nieuwe versie van de AIR-toepassing. Gebruik de version -elementen in updatedescriptors die worden gebruikt om toepassingen bij te werken die vóór AIR 2.5 zijn gemaakt. De waarde moet dezelfde reeks zijn die wordt gebruikt in het element version van het nieuwe AIR-toepassingsdescriptorbestand. Als de versie in het update-descriptorbestand niet overeenkomt met de versie van het geüpdate AIR-bestand, produceert het framework een uitzonderingsfout.

  • versionLabel —De leesbare versietekenreeks, bedoeld om te worden weergegeven aan gebruikers. Het versionLabel is optioneel, maar kan alleen worden opgegeven in updatedescriptorbestanden versie 2.5. Gebruik dit als u een versionLabel in de toepassingsdescriptor gebruikt en stel in op dezelfde waarde.

  • url —De locatie van het geüpdate AIR-bestand. Dit is het bestand dat de geüpdate versie van de AIR-toepassing bevat.

  • description —Meer informatie over de nieuwe versie. Deze informatie kan tijdens het bijwerken worden weergegeven aan de gebruiker.

De elementen version en url zijn verplicht. Het element description is optioneel.

Dit is een voorbeeld van een update-descriptorbestand versie 2.5: 

<?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/2.5"> 
       <versionNumber>1.1.1</versionNumber> 
       <url>http://example.com/updates/sample_1.1.1.air</url> 
       <description>This is the latest version of the Sample application.</description> 
    </update>

En hier volgt een voorbeeld van een update-descriptorbestand versie 1.0: 

<?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/1.0"> 
       <version>1.1.1</version> 
       <url>http://example.com/updates/sample_1.1.1.air</url> 
       <description>This is the latest version of the Sample application.</description> 
    </update>

Als u de tag description wilt definiëren voor meerdere talen, gebruikt u meerdere text -elementen die allemaal een lang -attribuut definiëren: 

<?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/2.5"> 
       <versionNumber>1.1.1</versionNumber> 
       <url>http://example.com/updates/sample_1.1.1.air</url> 
       <description> 
           <text xml:lang="en">English description</text> 
           <text xml:lang="fr">French description</text> 
           <text xml:lang="ro">Romanian description</text> 
       </description> 
    </update>

Plaats het update-descriptorbestand samen met het geüpdate AIR-bestand op uw webserver.

De map templates die wordt opgenomen bij de update-descriptor, bevat voorbeelden van update-descriptorbestanden. Hierbij zijn eentalige en meertalige versies.