Упаковка собственного установщика для настольной системы

Начиная с версии AIR 2, можно использовать ADT для создания собственных установщиков приложения для распространения приложений AIR. Например, можно создать EXE-файл установщика для установки приложения AIR в ОС Windows. Можно создать DMG-файл установщика для установки приложения AIR в ОС Mac OS. В AIR 2.5 и AIR 2.6 можно создать DEB- или RPM-файл установщика для установки приложения AIR в ОС Linux.

Приложения, устанавливаемые с помощью собственной программы установки, называются приложениями с профилем расширенного рабочего стола. Нельзя использовать ADT для упаковки собственного установщика для приложения AIR, если файл дескриптора приложения не поддерживает расширенный профиль настольного компьютера. Этот профиль можно запретить путем использования элемента supportedProfiles в файле дескриптора приложения. См. раздел Профили устройств и supportedProfiles .

Создать версию собственного установщика приложения AIR можно двумя основными способами:

  • Собственный установщик можно создать на основе файла дескриптора приложения и других исходных файлов. (В число других исходных файлов могут входить SWF-файлы, HTML-файлы и прочие активы.)

  • Собственный установщик можно создать на основе AIR- или AIRI-файла.

Необходимо использовать ADT в той же ОС, для которой создается собственный файл установщика. Таким образом, чтобы создать EXE-файл для ОС, необходимо запустить ADT в ОС Windows. Чтобы создать DMG-файл для ОС Mac OS, необходимо запустить ADT в ОС Mac OS. Чтобы создать DEB- или RPG-файл для ОС Linux, необходимо запустить ADT из AIR 2.6 SDK в ОС Linux.

При создании собственного установщика для распространения приложения AIR оно приобретает следующие свойства.

  • Оно может запускать и взаимодействовать с собственными процессами, используя класс NativeProcess. Дополнительные сведения см. в следующих ресурсах.

  • Оно может использовать собственные расширения.

  • Оно может вызывать метод File.openWithDefaultApplication() для открытия любого файла в предназначенном для его открытия приложении независимо от его типа. (Существуют ограничения на приложения, которые не устанавливаются собственным установщиком. Дополнительные сведения см. в справочнике ActionScript® 3.0 для Adobe® Flash® Professional CS5 в разделе, посвященном методу File.openWithDefaultApplication() .)

Однако при упаковке в качестве собственного установщика теряются некоторые преимущества формата файлов AIR. Больше нельзя будет использовать один файл для распространения приложения на все настольные системы. Встроенная функция обновления (а также платформа обновления) не работает.

При двойном нажатии файла собственного установщика производится установка приложения AIR. Если на компьютере не установлена требуемая версия среды Adobe AIR, перед установкой приложения производится ее загрузка и установка. Если подключение к сети отсутствует, и загрузить требуемую версию Adobe AIR (если требуется) нельзя, установка прекращается. Установка также невозможна, если операционная система не поддерживается Adobe AIR 2.

Примечание. Если необходимо, чтобы файл в установленном приложении являлся исполняемым, то при создании пакета приложения убедитесь, что он является исполняемым в данной файловой системе. (В ОС Mac и Linux для установки флага executable можно использовать команду 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] в примере синтаксиса). Помимо подписи файла AIR в ОС Windows можно подписать файл установщика Windows. Используйте тот же тип сертификата и синтаксис параметров подписи, что и для подписи файла AIR (см. раздел « Параметры подписания кода ADT »). Для подписи файла AIR и файла установщика можно использовать один и тот же или разные сертификаты. Когда пользователь загружает подписанный файл установщика Windows из Интернета, ОС Windows определяет источник файла по его сертификату.

Подробные сведения о параметрах ADT, кроме параметра -target , представлены в разделе 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.

Ниже приведен пример создания DMG-файла (файла собственного установщика в ОС Mac OS) на основе файла AIR: 

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

Ниже приведен пример создания EXE-файла (файла собственного установщика в ОС Windows) на основе файла AIR: 

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

Ниже приведен пример создания (на основе файла AIR) и подписи EXE-файла: 

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

Ниже приведен пример создания DMG-файла (файла собственного установщика в ОС Mac OS) на основе файла AIRI: 

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

Ниже приведен пример создания EXE-файла (файла собственного установщика в ОС Windows) на основе файла AIRI: 

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

В следующем примере создается файл EXE (на основе файла AIR), который подписывается с использованием подписи AIR и исходной подписи Windows: 

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