De tekenreeks die is opgegeven voor de parameter
version
van de methode
update()
, moet overeenkomen met de tekenreeks in het element
version
of
versionNumber
van het toepassingsdescriptorbestand voor het AIR-bestand dat moet worden geïnstalleerd. Uit veiligheidsoverwegingen is het verplicht de parameter
version
op te geven. Doordat u eist dat het versienummer in het AIR-bestand wordt geverifieerd door de toepassing, wordt er niet per ongeluk een oudere versie geïnstalleerd. (Een oudere versie van de toepassing bevat misschien een zwakte in de beveiliging die is gecorrigeerd in de huidige geïnstalleerde toepassing.) De toepassing moet ook de tekenreeks version in het AIR-bestand vergelijken met de tekenreeks version in de geïnstalleerde toepassing om te voorkomen dat de computer van de gebruiker wordt aangevallen en er ten onrechte een downgrade wordt uitgevoerd.
In oudere versies van AIR dan 2.5 kan de versiereeks elke indeling hebben. De tekenreeks kan bijvoorbeeld bestaan uit cijfers, zoals '2.01', maar ook uit cijfers en letters, zoals 'versie 2'. In AIR 2.5 of hogere versie moet de versiereeks een sequentie zijn van hoogstens drie getallen van drie cijfers, gescheiden door putnen. ".0", "1.0" en "67.89.999" zijn bijvoorbeeld alle drie geldige versienummers. U moet de updateversiereeks verifiëren voordat u de toepassing bijwerkt.
Als een Adobe AIR-toepassing een AIR-bestand via het web downloadt, is het een goede gewoonte om een mechanisme te gebruiken waarmee de webservice de Adobe AIR-toepassing kan informeren over de versie die wordt gedownload. De toepassing kan deze tekenreeks vervolgens gebruiken voor de parameter
version
van de methode
update()
. Als het AIR-bestand op een andere manier wordt verkregen, waarbij de versie van het AIR-bestand onbekend blijft, kan de AIR-toepassing het AIR-bestand onderzoeken om de versiegegevens vast te stellen. (Een AIR-bestand is een met ZIP gecomprimeerd archief en het descriptorbestand van de toepassing is de tweede record in het archief.)
Zie
AIR-toepassingsdescriptorbestanden
voor meer informatie over het descriptorbestand van een toepassing.