封裝桌上型原生安裝程式

如 AIR 2 中,您可以使用 ADT 建立原生應用程式安裝程式,進而散佈 AIR 應用程式。例如,您可以建立 EXE 安裝程式以在 Windows 上發佈 AIR 應用程式。您可以建立 DMG 安裝程式以在 Mac OS 上發佈 AIR 應用程式。在 AIR 2.5 和 AIR 2.6 上,您可以建立 DEB 或 RPM 安裝程式檔案,以便在 Linux 上發佈 AIR 應用程式。

隨原生應用程式安裝程式安裝的應用程式稱為延伸桌上型描述檔應用程式。如果應用程式描述器檔案不支援桌上型延伸描述檔,您便無法使用 ADT 來封裝 AIR 應用程式的原生安裝程式。您可以在應用程式描述器檔案中使用 supportedProfiles 元素來限制此描述檔。請參閱 裝置描述檔 supportedProfiles

有兩種方法可建立 AIR 應用程式的原生安裝程式版本:

  • 您可以根據應用程式描述器檔案與其他來源檔案,建立原生安裝程式 (其他來源檔案可能包括 SWF 檔案、HTML 檔案以及其他資源)。

  • 您可以根據 AIR 檔案或根據 AIRI 檔案,建立原生安裝程式。

您必須在想要產生原生安裝程式的作業系統上使用 ADT。這表示若要建立 Windows 適用的 EXE 檔,請在 Windows 上執行 ADT。若要建立 Mac OS 適用的 DMG 檔,請在 Mac OS 上執行 ADT。若要建立 Linux 適用的 DEB 或 RPG 檔案,請在 Linux 上從 AIR 2.6 SDK 執行 ADT。

當您建立原生安裝程式以發佈 AIR 應用程式時,該應用程式具有下列功能:

  • 應用程式可使用 NativeProcess 類別來啟動原生處理程序並與之互動。如需詳細資訊,請參閱下列其中一項:
  • 它可使用原生擴充功能。

  • 使用 File.openWithDefaultApplication() 方法可使用預設的系統應用程式來開啟檔案,而不論其檔案類型。(不是以原生安裝程式安裝的應用程式會有部分限制。如需詳細資訊,請參閱語言參考中的 File.openWithDefaultApplication() 項目)。

不過,封裝為原生安裝程式時,應用程式會喪失 AIR 檔案格式的部分優點。單一檔案將無法再散佈至所有桌上型電腦。內建更新功能 (以及更新程式架構) 無法運作。

使用者按兩下原生安裝程式檔案時,便會安裝 AIR 應用程式。如果電腦上尚未安裝所需的 Adobe AIR 版本,安裝程式便會先從網路下載該版本,然後予以安裝。如果沒有可取得正確 Adobe AIR 版本 (如有需要) 的網路連線,安裝就會失敗。此外,如果 Adobe AIR 2 不支援該作業系統,安裝也會失敗。

備註: 如果您希望檔案可以在安裝的應用程式中執行,請在封裝應用程式時,確認該檔案可在檔案系統上執行 (您可以在 Mac 和 Linux 上,視需要使用 chmod 設定可執行旗標)。

從應用程式來源檔案建立原生安裝程式

若要從應用程式的來源檔案建立原生安裝程式,請使用 -package 命令和下列語法 (單行命令列):

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 ...] ...

此語法和封裝 AIR 檔案 (不包含原生安裝程式) 的語法相似,不過有一些差異:

  • -target native 選項加入命令(如果指定 -target air ,則 ADT 會產生 AIR 檔案,而不是原生安裝程式檔案)。

  • 指定目標 DMG 或 EXE 檔案做為 installer_file

  • 或者是,在 Windows 中加入第二組簽署選項,以 [WINDOWS_INSTALLER_SIGNING_OPTIONS] 語法表示。在 Windows 中,除了簽署 AIR 檔案之外,您還可以簽署 Windows Installer 檔案。請使用和簽署 AIR 檔案時相同的憑證類型與簽署選項語法 (請參閱 ADT 程式碼簽署選項 )。您可以使用相同的憑證來簽署 AIR 檔案與安裝程式檔案,或是您也可以指定不同的憑證。當使用者從網路下載已簽署的 Windows Installer 檔案時,Windows 會根據憑證來識別該檔案的來源。

如需 -target 選項之外的 ADT 選項詳細資訊,請參閱 AIR Developer Tool (ADT)

下列範例會建立 DMG 檔 (Mac OS 適用的原生安裝程式檔案):

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

下列範例會建立 EXE 檔 (Windows 適用的原生安裝程式檔案):

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

下列範例會建立 EXE 檔並予以簽署:

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

建立使用原生擴充功能之應用程式的原生安裝程式

您可從來源檔案建立應用程式的原生安裝程式和應用程式所需的原生擴充功能套件。請使用 -package 命令和下列語法 (在單一命令列中):

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 ...] ...

此語法與用於封裝原生安裝程式的語法相同,但是多兩個選項。使用 -extdir extension-directory 選項可指定包含應用程式所用 ANE 檔案 (原生擴充功能) 的目錄。使用選擇性 -migrate 旗標和 MIGRATION_SIGNING_OPTIONS 參數可在主要程式碼簽署憑證不同於先前版本所使用的憑證時,以移轉簽名簽署應用程式的更新。如需詳細資訊,請參閱 簽署 AIR 應用程式的更新版本

如需 ADT 選項的詳細資訊,請參閱 AIR Developer Tool (ADT)

下列範例會建立使用原生擴充功能之應用程式的 DMG 檔案 (Mac OS X 的原生安裝檔案)。

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

從 AIR 檔案或 AIRI 檔案建立原生安裝程式

您可以使用 ADT,根據 AIR 檔案或 AIRI 檔案建立原生安裝程式檔案。若要根據 AIR 檔案建立原生安裝程式,請使用 ADT -package 命令和下列語法 (單行命令列):

adt -package 
    -target native 
    [WINDOWS_INSTALLER_SIGNING_OPTIONS] 
    installer_file 
    air_file

此語法和根據 AIR 應用程式來源檔案建立原生安裝程式的語法相似,不過有一些差異:

  • 您可以指定 AIR 檔案做為來源,而不是指定 AIR 應用程式的應用程式描述器檔案與其他來源檔案。

  • 不必為 AIR 檔案指定簽署選項,因為該檔案已經簽署

若要根據 AIRI 檔案建立原生安裝程式,請使用 ADT -package 命令和下列語法 (單行命令列):

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

此語法和根據 AIR 檔案建立原生安裝程式的語法相似。不過有一些差異:

  • 您可以指定 AIRI 檔案做為來源。

  • 您需要為目標 AIR 應用程式指定簽署選項。

下列範例會根據 AIR 檔案建立 DMG 檔 (Mac OS 適用的原生安裝程式檔案):

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

下列範例會根據 AIR 檔案建立 EXE 檔 (Windows 適用的原生安裝程式檔案):

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

下列範例會建立 EXE 檔 (根據 AIR 檔案) 並予以簽署:

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

下列範例會根據 AIRI 檔案建立 DMG 檔 (Mac OS 適用的原生安裝程式檔案):

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

下列範例會根據 AIRI 檔案建立 EXE 檔 (Windows 適用的原生安裝程式檔案):

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

下列範例建立 EXE 檔案 (根據 AIRI 檔案) 並使用 AIR 與原生 Windows 簽名來簽署:

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