Paketera ett systemspecifikt installationsprogram för skrivbordet

Från och med AIR 2 kan du använda ADT för att skapa systemspecifika installationsprogram för distribution av AIR-program. Du kan t.ex. skapa en EXE-installationsfil för distribution av ett AIR-program för Windows. Du kan skapa en DMG-installationsfil för distribution av ett AIR-program för Mac OS. I AIR 2.5 and AIR 2.6 kan du skapa en DEB- eller RPM-installationsfil för distribution av ett AIR-program för Linux.

Program som installeras med ett internt installationsprogram kallas för program med utökade skrivbordsprofiler. Du kan inte använda ADT för att paketera ett internt installationsprogram för ett AIR-program om programbeskrivningsfilen inte har stöd för den utökade skrivbordsprofilen. Du kan begränsa profilen med elementet supportedProfiles i programbeskrivningsfilen. Läs mer i Enhetsprofiler och supportedProfiles .

Du kan skapa ett internt installationsprogram för AIR-programmet på två sätt:

Du kan skapa det interna installationsprogrammet baserat på programbeskrivningsfilen och andra källfiler. (Andra källfiler kan inkludera SWF-filer, HTML-filer och andra resurser.)
Du kan skapa det interna installationsprogrammet baserat på en AIR-fil eller en AIRI-fil.

Du måste använda ADT i samma operativsystem som det för den interna installationsfilen som du vill generera. Om du vill skapa en EXE-fil för Windows ska du köra ADT i Windows. Om du vill skapa en DMG-fil för Mac OS ska du köra ADT i Mac OS. Om du vill skapa en DEB- eller RPG-fil för Linux ska du köra ADT från AIR 2.6 SDK i Linux.

När du skapar ett internt installationsprogram för att distribuera ett AIR-program får programmet följande funktioner:

Det kan starta och samverka med interna processer med klassen NativeProcess. Se följande för mer information:
- Kommunicera med interna processer i AIR (för ActionScript-utvecklare)
- Communicating with native processes in AIR (för HTML-utvecklare)
Det kan använda ANE-tillägg.
Det kan använda metoden File.openWithDefaultApplication() för att öppna filer med det standardprogram som definierats i systemet, oavsett filtyp. (Det finns begränsningar för program som inte installeras med ett internt installationsprogram. Mer information finns under File.openWithDefaultApplication() i språkreferensen.)

När det paketeras som ett systemspecifikt installationsprogram förlorar det dock några av fördelarna med AIR-filformatet. En enda fil kan inte längre distribueras till alla stationära datorer. Den inbyggda uppdateringsfunktionen (liksom uppdateringsramverket) fungerar inte.

AIR-programmet installeras när användaren dubbelklickar på den interna installationsfilen. Om den nödvändiga versionen av Adobe AIR inte är installerad på maskinen, hämtar installationsprogrammet den från nätverket och installerar den först. Installationen misslyckas om det inte finns en nätverksanslutning med vilken rätt version av Adobe AIR kan hämtas (om det behövs). Installationen misslyckas även om Adobe AIR 2 saknar stöd för operativsystemet.

Obs! Om du vill att en fil ska kunna köras i det installerade programmet bör du kontrollera att den är körbar i filsystemet när du paketerar programmet. (På Mac och Linux kan du använda chmod för att ange den körbara flaggan, om detta behövs.)

Skapa ett internt installationsprogram med programmets källfiler

För att skapa ett internt installationsprogram med hjälp av programmets källfiler ska du använda -package -kommandot med följande syntax (på en kommandorad):

adt -package AIR_SIGNING_OPTIONS 
    -target native 
    [WINDOWS_INSTALLER_SIGNING_OPTIONS] 
    installer_file 
    app_xml 
    [file_or_dir | -C dir file_or_dir | -e file dir ...] ...

Syntaxen liknar den för paketering av en AIR-fil (utan ett internt installationsprogram). Det finns dock några skillnader:

Du kan lägga till alternativet -target native i kommandot. (Om du anger -target air genererar ADT en AIR-fil i stället för en intern installationsfil.)
Du kan ange DMG- eller EXE-målfilen som installer_file .
I Windows kan du alternativt lägga till ytterligare en uppsättning signeringsalternativ som [WINDOWS_INSTALLER_SIGNING_OPTIONS] i syntaxen. I Windows kan du även signera Windows installationsfilen i tillägg till AIR-filen. Använd samma typ av certifikat och syntax för signeringsalternativ som du gör för att signera AIR-filen (se ADT-kodsigneringsalternativ ). Du kan använda samma certifikat för att signera AIR-filen och installationsfilen eller ange olika certifikat. När en användare hämtar en signerad Windows installationsfil från nätet, identifierar Windows källan till filen baserat på certifikatet.

Information om andra ADT-alternativ än -target finns i AIR Developer Tool (ADT) .

Exemplet nedan skapar en DMG-fil (en intern installationsfil för Mac OS):

adt -package 
    -storetype pkcs12 
    -keystore myCert.pfx 
    -target native 
    myApp.dmg 
    application.xml 
    index.html resources

Exemplet nedan skapar en EXE-fil (en intern installationsfil för Windows):

adt -package 
    -storetype pkcs12 
    -keystore myCert.pfx 
    -target native 
    myApp.exe 
    application.xml 
    index.html resources

Exemplet nedan skapar en EXE-fil och signerar den:

adt -package 
    -storetype pkcs12 
    -keystore myCert.pfx 
    -target native 
    -storetype pkcs12 
    -keystore myCert.pfx 
    myApp.exe 
    application.xml 
    index.html resources

Skapa ett systemspecifikt installationsprogram för ett program där ANE-tillägg används.

Du kan skapa ett internt installationsprogram med hjälp av källfilerna för programmet och det systemspecifika tilläggspaketet som krävs för programmet. Använd kommandot -package med följande syntax (på en kommandorad):

adt -package AIR_SIGNING_OPTIONS 
    -migrate MIGRATION_SIGNING_OPTIONS 
    -target native 
    [WINDOWS_INSTALLER_SIGNING_OPTIONS] 
    installer_file 
    app_xml 
    -extdir extension-directory 
    [file_or_dir | -C dir file_or_dir | -e file dir ...] ...

Detta är samma syntax som används för paketering av ett systemspecifikt installationsprogram, men med ytterligare två alternativ. Använd alternativet -extdir extension-directory för att ange katalogen som innehåller ANE-filerna (systemspecifika tillägg) som används i programmet. Använd den valfria flaggan -migrate och MIGRATION_SIGNING_OPTIONS -parametrarna för att signera en uppdatering av ett program med en flyttningssignatur, när det primära kodsigneringscertifikatet inte är samma certifikat som det som användes av den tidigare versionen. Du hittar mer information i Signera en uppdaterad version av ett AIR-program .

Mer information om ADT-alternativ finns i AIR Developer Tool (ADT) .

I följande exempel skapas en DMG-fil (en systemspecifik installationsfil för Mac OS) för ett program som använder ANE-tillägg:

adt -package 
    -storetype pkcs12 
    -keystore myCert.pfx 
    -target native 
    myApp.dmg 
    application.xml 
    -extdir extensionsDir 
    index.html resources

Skapa ett internt installationsprogram av en AIR-fil eller AIRI-fil

Du kan använda ADT för att generera en intern installationsfil baserad på en AIR-fil eller AIRI-fil. Använd ADT -package -kommandot med följande syntax (på en kommandorad) när du vill skapa en intern installationsfil baserad på en AIR-fil:

adt -package 
    -target native 
    [WINDOWS_INSTALLER_SIGNING_OPTIONS] 
    installer_file 
    air_file

Syntaxen liknar den som används för att skapa en intern installationsfil baserad på AIR-programmets källfiler. Det finns dock några skillnader:

Du anger en AIR-fil som källa i stället för en programbeskrivningsfil och andra källfiler för AIR-programmet.
Ange inte signeringsalternativ för AIR-filen eftersom den redan är signerad

Använd ADT -package -kommandot med följande syntax (på en kommandorad) när du vill skapa en intern installationsfil baserad på en AIRI -fil:

adt AIR_SIGNING_OPTIONS 
    -package 
    -target native 
    [WINDOWS_INSTALLER_SIGNING_OPTIONS] 
    installer_file 
    airi_file

Syntaxen liknar den för att skapa en intern installationsfil baserad på en AIR-fil. Det finns dock vissa skillnader:

Du anger en AIRI-fil som källa.
Du anger signeringsalternativ för AIR-målprogrammet.

Exemplet nedan skapar en DMG-fil (en intern installationsfil för Mac OS) baserad på en AIR-fil:

adt -package -target native myApp.dmg myApp.air

Exemplet nedan skapar en EXE-fil (en intern installationsfil för Windows) baserad på en AIR-fil:

adt -package -target native myApp.exe myApp.air

Exemplet nedan skapar en EXE-fil (baserad på en AIR-fil) och signerar den:

adt -package -target native -storetype pkcs12 -keystore myCert.pfx myApp.exe myApp.air

Exemplet nedan skapar en DMG-fil (en intern installationsfil för Mac OS) baserad på en AIRI-fil:

adt -storetype pkcs12 -keystore myCert.pfx -package -target native myApp.dmg myApp.airi

Exemplet nedan skapar en EXE-fil (en intern installationsfil för Windows) baserad på en AIRI-fil:

adt -storetype pkcs12 -keystore myCert.pfx -package -target native myApp.exe myApp.airi

I exemplet nedan skapas en EXE-fil (baserat på en AIRI-fil) och filen signeras med både en AIR-signatur och en systemspecifik Windows-signatur:

adt -package -storetype pkcs12 -keystore myCert.pfx -target native -storetype pkcs12 -keystore myCert.pfx myApp.exe myApp.airi