Вторник, 19.03.2024, 04:20
Приветствуем Вас Гость | Регистрация | Вход

Portable Punsh (портативные программы). Создание портативных программ. Как сделать /как создать portable? Скачать портативные программы, игры rus бесплатно.

● см. Информация о сайте

Вы можете оказать материальную поддержку сайту "Punsh Portable"! Если наш сайт помог вам в создании портативных/портабельных сборок, то любая сумма от вас сподвигнет команду сайта (Punsh + CheshireCat) на дальнейшее развитие сайта и на создание новых портативных программ.



Меню сайта
Пожертвовать
Форма входа

Поиск
Portable RUS
Про портативный софт [7]
Портативный софт-создание [12]
Фотошоп (Photoshop)-уроки [2]
Работа с программами [5]
Компьютер с нуля - Уроки [3]
Притчи [2]
Любовь (о Любви) [0]
Психология [7]
Новости [41]
Опросы
Оцените сайт Punsh.at.ua
Всего ответов: 515
Статистика
Онлайн всего: 1
Гостей: 1
Пользователей: 0

Статьи, Обзоры, Уроки

Главная » Статьи, Уроки » Портативный софт-создание

Создание Portable программ - PortableApps.com Format ™ 2.0 (2011-11-13) на русском


Описание формата PAF от Джона Халлера (John Haller)
Что такое PortableApps.com Format? Как работает PortableApps?

Если вы хотите научиться создавать Portable (портативные) программы в ручном формате PAF (Portable Apps.com Format), то эта статья вам просто необходима! И не важно, какой вариант создания Portable (портативных) программ вы выберете: Portable на основе NSIS-скриптов или Portable, используя программу PortableApps.com Launcher… Из этой статьи вы получите массу полезных знаний, которые пригодятся вам при создании портативных программ  в ручном формате PAF.

PortableApps.com Format (PAF) отличается от других "ручных" портативных программ чётким определением структуры размещения файлов и папок, а так же требований к портативным программам (приложениям), которые управляют поведением портативной программы (Portable soft) в директориях операционной системы.
Описание PortableApps.com Format разбито на разделы для удобного и легкого чтения.
Авторский оригинал на английском языке от Джона Халлера (John Haller) читайте здесь.

Разделы спецификации PortableApps.com Format:

● 1. Directory and File Layout - (Схема размещения файлов и папок в Portable программе)
● 2. AppInfo.ini (App Configuration) - (AppInfo.ini - Конфигурация приложения Portable)
● 3. Icons – (Иконки для Portable)
● 4. PortableApps.com AppCompactor и AppCompactor.ini – (сжатие Portable)
● 5. PortableApps.com Installer and installer.ini – (PortableApps.com Установщик/Инсталлятор и installer.ini)
● 6. Host PC Modifications & Portability – (Изменения в ОС и Портативность в Portable soft)
● 7. Plugin Installers – (Плагин Установщик/Инсталлятор)
● 8. Version History and Discussion – (История версий PortableApps.com Format и обсуждение)


Просьба: Замечания по ошибкам и неточности перевода с английского - пишите в комментариях.



1. Схема размещения файлов и папок в PortableApps.com Format (PAF)

Схема каталога портативного приложения состоит из основной папки AppNamePortable и входящих в нее папок App, Data и Other.
Code
AppNamePortable  
+ App  
  + AppInfo  
  + AppName  
  + DefaultData  
+ Data  
+ Other  
  + Help  
  + Images  
  + Source


AppNamePortable: содержит файл Launcher'а портативной программы (приложения), обычно называемого AppNamePortable.exe и файл справки help.html. Другие файлы в данной папке не содержатся.

App: содержит все файлы портативной программы (приложения,) которые лежат в папке AppName. Папка AppInfo содержит иконки портативного приложения, а так же данные для конфигурации PortableApps.com Platform и PortableApps.com Installer. Еще может содержать папку Launcher с файлом Launcher.ini для PortableApps.com Launcher. Третья папка DefaultData содержит файлы, которые по умолчанию должны лежать в папке Data. При запуске Portable (портативной) программы Launcher проверяет есть ли файлы в папке Data и если папка пуста, Launcher копирует файлы из папки DefaultData.

Data: содержит все пользовательские данные для Portable (портативной) программы,  включая настройки и все прочие файлы, которые обычно хранятся в папке $APPDATA$ локально установленного приложения. Настройки могут содержать поддиректории. При этом если удалить папку Data и запустить портативную программу, то она запустится, как будто вы только что  изначально установили её портативную версию.

Other: содержит файлы и папки Portable программы, которые не вписываются в остальные директории. Подпапка Help содержит картинки и другие файлы, используемые в файле help.html. Папка Source может содержать исходники для Launcher'а или файла установки, лицензию или файл readme.txt.


Просьба: Замечания по неточности перевода с английского - пишите в комментариях.




2. AppInfo.ini (Конфигурация приложения в PortableApps.com Format)

Сведения о конфигурации приложения необходимы для PortableApps.com Platform и PortableApps.com Installer. Они расположены в папке AppInfo, находящейся в директории AppNamePortable\App. В данной папке расположен файл appinfo.ini и иконки приложения.

Файл appinfo.ini состоит из следующих параметров:
Code
[Format]  
Type=PortableApps.comFormat  
Version=2.0  

[Details]  
Name=AppName Portable  
AppId=AppNamePortable  
Publisher=App Developer & PortableApps.com  
Homepage=PortableApps.com/AppNamePortable  
Category=Utilities  
Description=AppName Portable is a tool that does something.  
Language=Multilingual  
Trademarks=  
InstallType=  

[License]  
Shareable=true  
OpenSource=true  
Freeware=true  
CommercialUse=true  
EULAVersion=1  

[Version]  
PackageVersion=1.2.0.1  
DisplayVersion=1.2 Release 1  

[SpecialPaths]  
Plugins=NONE  

[Dependencies]  
UsesJava=false  
UsesDotNetVersion=  

[Control]  
Icons=1  
Start=AppNamePortable.exe  
ExtractIcon=App\AppName\AppName.exe


Раздел [Format]
Type=Тип файла конфигурации (На данный момент только PortableApps.comFormat)
Version=Версия формата файла (На данный момент актуальна 2.0)

Раздел [Details]
Name=Название портативного приложения, какое будет отображаться в PortableApps.com Menu
AppId=Уникальный идентификатор приложения. Как правило название без пробелов
Publisher=Издатель приложения. Если вы перепаковывали приложение необходимо перечислить всех издателей.
Homepage=Сайт портативного приложения. Не базового (портатируемого).
Category=Категория приложения в PortableApps.com Platform. Может быть: Accessibility, Development, Education, Games, Graphics & Pictures, Internet, Music & Video, Office, Security or Utilities.
Description=Краткое описание приложения. До 512 символов.
Language=Язык приложения. Может быть как multilingual, так и определенной страны: Afrikaans, Albanian, Arabic, Armenian, Basque, Belarusian, Bosnian, Breton, Bulgarian, Catalan, Cibemba, Croatian, Czech, Danish, Dutch, Efik, English, Estonian, Farsi, Finnish, French, Galician, Georgian, German, Greek, Hebrew, Hungarian, Icelandic, Igbo, Indonesian, Irish, Italian, Japanese, Khmer, Korean, Kurdish, Latvian, Lithuanian, Luxembourgish, Macedonian, Malagasy, Malay, Mongolian, Norwegian, NorwegianNynorsk, Pashto, Polish, Portuguese, PortugueseBR, Romanian, Russian, Serbian, SerbianLatin, SimpChinese, Slovak, Slovenian, Spanish, SpanishInternational, Swahili, Swedish, Thai, TradChinese, Turkish, Ukranian, Uzbek, Valencian, Vietnamese, Welsh, Yoruba.
Trademarks (при необходимости)=Торговые марки. Например HappyApp является торговой маркой компании Acme, Inc
InstallType (при необходимости)=

Раздел [License] (Все значения только true или false)
Shareable=Имеете ли вы право скопировать приложение с одного диска на другой. (За исключением папки Data)
OpenSource=Является ли приложение с полностью открытым кодом под лицензией OSI.
Freeware=Является ли приложение свободным.(Бесплатным)
CommercialUse=Имеете ли вы право использовать приложение в коммерческих целях.
EULAVersion (при необходимости)=Используется ли Лицензионное соглашение. Если да, то необходимо положить файл EULA.txt или EULA.rtf с текстом соглашения. Оно будет приниматься при установке.

Раздел [Version]
PackageVersion=Версия пакета. Должно быть в формате 1.2.3.4 и увеличиваться с каждым публичным релизом.
DisplayVersion=Вариант для описания версии. Например может быть DisplayVersion: 2.4 Revision 2, а PackageVersion: 2.4.0.2.

Категория [SpecialPaths]
Plugins (при необходимости)=Путь к папке с плагинами приложения, если она находится в каталоге App.(Как например с Firefox)

Раздел [Dependencies]
UsesJava (при необходимости)=Определяет использует ли приложение Java Portable.(true или false)
UsesDotNetVersion(при необходимости)=Определяет какая минимальная версия .NET framework должна быть установлена. (Поддерживаются значения 1,1, 2,0, 3,0, 3,5)

Раздел [Control]
Icons=Количество иконок в PortableApps.com Menu.
Start=Какое приложение запускать из PortableApps.com Menu.(Прописывается просто AppNamePortable.exe)
ExtractIcon(при необходимости)=Если в папке AppInfo нет иконки приложения (appicon.ico), то тут указывается путь к исполняемому файлу из которого будет взята иконка. Использовать в редких случаях, так как замедляет работу.(Например App\AppName\AppName.exe)

Если приложение имеет несколько лаунчеров (как в OpenOffice.org Portable) и необходимо чтобы они все отображались в PortableApps.com Menu, тогда раздел [Control] будет иметь вид:
Code
[Control]  
Icons=2  
Start=AppNamePortable.exe  
Start1=AppNamePortable.exe  
Name1=AppName Portable  
Start2=AppNamePortable2.exe  
Name2=AppName Portable Other Part


Icons - Количество иконок
Start - Основное приложение
Start1 - Запускаемое приложение для 1 иконки(обычно тоже что и в Start)
Name1 - Имя приложения в меню для 1 иконки.
Start2 - Запускаемое приложение для 2 иконки.
Name2 - Имя приложения в меню для 2 иконки.


Просьба: Замечания о неточностях перевода с английского - пишите в комментариях.



3. Иконки в PortableApps.com Format

В папке AppNamePortable\App\AppInfo расположены иконки портативного приложения, которые используются в PortableApps.com Installer и PortableApps.com Menu. Иконки имеют ICO и PNG формат. Иконки имеют названия appicon.ico, appicon_16.png, appicon_32.png и appicon_128.png*, где цифры указывают размер иконки. Если приложение использует несколько наборов иконок (например 2 файла запуска), тогда дополнительные иконки должны иметь название appicon1.ico (appicon1_16.png и appicon1_32.png), appicon2.ico, и т.д. Номера иконок соответствуют номерам приложений в разделе [Control] (Start1, Start2, и т.д.) файла AppInfo.ini.

* Обратите внимание, что 128px вариант не является обязательным и не требуется для компиляции. Тем не менее, издатели рекомендуется включать иконку с высоким разрешением для предстоящих особенностей в платформе.

PNG иконки имеют размер 16x16 и 32x32 соответственно названию, формат True Color с альфа-прозрачностью (alpha transparency).

ICO файл в формате Windows ICO и содержит 6 необходимых изображений, а также Vista формат по желанию:
16px - 256 color (8-bit)
32px - 256 color (8-bit)
48px - 256 color (8-bit)
16px - True Color + Alpha (32-bit / XP format)
32px - True Color + Alpha (32-bit / XP format)
48px - True Color + Alpha (32-bit / XP format)
256px - True Color + Alpha PNG (32-bit PNG / Vista format) *ПО ЖЕЛАНИЮ

* 256px размер Alpha PNG не является обязательным. Он используется Windows Vista\7 для отображения больших и очень больших размеров значков. Некоторые издатели, возможно, пожелают включить его.

ExtractIcon Примечание - в пакетах, которые используют функцию ExtractIcon в appinfo.ini, то appicon.ico и PNG версии значков не будут использоваться, и могут быть пропущены. Общий appicon.ico будет включен для обратной совместимости.


Просьба: Замечания по неточностям перевода с английского - пишите в комментариях.



4. PortableApps.com AppCompactor и AppCompactor.ini

PortableApps.com AppCompactor используется для сжатия программы, чтобы иметь меньший размер и запускаться быстрее при ограниченнной пропускной способности съемных носителей. Как правило, AppCompactor работает полностью автоматически, вы просто выбираете каталог портативного приложения. Иногда, некоторые программы несовместимы с AppCompactor и необходимо указать какие файлы сжимать, а какие нет. Для этого используется файл AppCompactor.ini.

AppCompactor.ini находится в папке App\AppInfo наряду с AppInfo.ini и Installer.ini. Пример файла:
Code
[PortableApps.comAppCompactor]  
FilesExcluded=msvcm90.dll|msvcp90.dll|mscvr90.dll  
AdditionalExtensionsExcluded=pyd|irc  
AdditionalExtensionsIncluded=example|beta


Раздел [PortableApps.comAppCompactor]:

Примечание: Если вы не планируете использовать PortableApps.com AppCompactor или не нужно вносить изменения в стандартную схему сжатия, этот раздел должен быть пропущен.

FilesExcluded какие файлы вы бы хотели пропустить из сжатия AppCompactor. Разделителем выступает "|".
AdditionalExtensionsExcluded дополнительные типы файлов, которые необходимо исключить из сжатия.Разделителем выступает "|".
AdditionalExtensionsIncluded дополнительные типы файлов, которые необходимо включить в сжатие.Разделителем выступает "|".
CompressionFileSizeCutOff определяет размер, в байтах, файлы ниже которого будут игнорироваться. По умолчанию 4096.


Просьба: Замечания по неточности перевода с английского - пишите в комментариях.



5. PortableApps.com Installer и installer.ini

Инсталлер (установщик) получает настройки из файла appinfo.ini, а также, при необходимости, дополнительные настройки указываются в файле installer.ini, который также находится в папке AppInfo. При помощи installer.ini можно более детально настроить процесс установки.

installer.ini состоит из:

Обратите внимание, что этот пример показывает все возможные опции! Для каждого проекта используйте только необходимые параметры.

Code
[CheckRunning]  
CloseEXE=Custom.exe  
CloseName=AppName  

[Source]  
IncludeInstallerSource=false  

[MainDirectories]  
RemoveAppDirectory=true  
RemoveDataDirectory=false  
RemoveOtherDirectory=true  

[OptionalComponents]  
OptionalComponents=true  
MainSectionTitle=AppName Portable (English) [Required]  
MainSectionDescription=Install the portable app  
OptionalSectionTitle=Additional Languages  
OptionalSectionDescription=Add multilingual support for this app  
OptionalSectionSelectedInstallType=Multilingual  
OptionalSectionNotSelectedInstallType=English  
OptionalSectionPreSelectedIfNonEnglishI nstall=true  
OptionalSectionInstalledWhenSilent=true  
OptionalDirectory1=  
OptionalFile1=  

[CopyLocalFiles]  
CopyLocalFiles=true  
CopyFromRegPath=HKLM\Software\AppName  
CopyFromRegKey=AppPath  
CopyFromRegRemoveDirectories=2  
CopyFromDirectory=%PRO GRAMFILES%\AppName  
CopyToDirectory=App\AppName  

[DownloadFiles]  
DownloadURL=  
DownloadName=  
DownloadFilename=  
DownloadMD5=  
DownloadTo=  
AdditionalInstallSize=  
Extract1To=  
Extract1File=  
AdvancedExt ract1To=  
AdvancedExtract1Filter=  
DoubleExtractFilename=  
DoubleExtract1To=  
DoubleExtract1Filter=  

[Languages]  
ENGLISH=true  
AFRIKAANS=true  
ALBANIAN=true  
ARABIC=true  
ARMENIAN=true  
BASQUE=true  
BELARUSIAN=true  
BOSNIAN=true  
BRETON=true  
BULGARIA N=true  
CATALAN=true  
CIBEMBA=true  
CROATIAN=true  
CZECH=true  
DANISH=true  
DUTCH=true  
EFIK=true  
ESPERANTO=true  
ESTONIAN=true  
FARSI= t r ue  
FINNISH=true  
FRENCH=true  
GALICIAN=true  
GEORGIAN=true  
GERMAN=true  
GREEK=true  
HEBREW=true  
HUNGARIAN=true  
ICELANDIC=true  
IGB O = true  
I NDONESIAN=true  
IRISH=true  
ITALIAN=true  
JAPANESE=true  
KHMER=true  
KOREAN=true  
KURDISH=true  
LATVIAN=true  
LITHUANIAN=true  
LUXEMBOURGISH =true  
MACEDONIAN=true  
MALAGASY=true  
MALAY=true  
MONGOLIAN=true  
NORWEGIAN=true  
NORWEGIANNYNORSK=true  
PASHTO=true  
POLISH=true  
PORT U G UE SE=true  
PORTUGUESEBR=true  
ROMANIAN=true  
RUSSIAN=true  
SERBIAN=true  
SERBIANLATIN=true  
SIMPCHINESE=true  
SLOVAK=true  
SLOVENIAN=true  
S PA NISH=true  
SPANISHINTERNATIONAL=true  
SWAHILI=true  
SWEDISH=true  
THAI=true  
TRADCHINESE=true  
TURKISH=true  
UKRAINIAN=true  
UZBEK=tru e  
V AL ENCIAN=true  
VIETNAMESE=true  
WELSH=true  
YORUBA=true  

[DirectoriesToPreserve]  
PreserveDirectory1=  

[DirectoriesToRemove]  
RemoveDirectory1=  

[FilesToPreserve]  
PreserveFile1=  

[FilesToRemove]  
RemoveFile1=


Раздел [CheckRunning]
CloseEXE (опционально) проверяет не запущен ли указанный exe файл. Если файл EXE является таким же, как указано в [Control] - Start файла appinfo.ini (ваш лаунчер), эта запись должна быть исключена из installer.ini. Если вы хотите, чтобы проверка не проводилась, установите CloseEXE = NONE (в верхнем регистре), но это должно быть сделано с осторожностью, так как пользователь может попробовать обновить приложение, пока оно выполняется.
CloseName (опционально) позволяет назначить имя приложения, что будет закрыто при обновлении. Если имя такое же, как имя портативного приложения, как указано в appinfo.ini то эта запись должна быть исключена из installer.ini.

Раздел [Source] (значение true или false)
IncludeInstallerSource (опционально) позволяет включать исходные коды PortableApps.com Installer для установки их вместе с портативным приложением. При необходимости установите "true".

Раздел [MainDirectories] (Все значения только true или false)
Позволяет указать, следует ли удалять указанные папки при установке новой версии поверх уже существующей. По умолчанию, App и Other папки удаляются, а папка Data сохраняется.
Если вы хотите использовать эти значения по умолчанию, не указывайте этот раздел в installer.ini.
RemoveAppDirectory=Очищать ли папку App?
RemoveDataDirectory=Очищать ли папку Data?
RemoveOtherDirectory=Очищать ли папку Other?

Раздел [OptionalComponents]
OptionalComponents - когда установлено в True, это дает возможность при установке выбрать дополнительный компонент установки. Это обычно используется для установки дополнительных языков приложения.
MainSectionTitle (необязательно): имя основного приложения в окне выбора компонентов установки. По умолчанию он будет выглядеть так: "AppName Portable (English) [Required]". AppName Portable берется из appinfo.ini. Если вас устраивают настройки по умолчанию, можете пропустить эту запись.
MainSectionDescription (необязательно): описание основного приложения в окне выбора компонентов установки. По умолчанию: "Install the portable app". Если вас устраивают настройки по умолчанию, можете пропустить эту запись.
OptionalSectionTitle (необязательно): имя компонента приложения в окне выбора компонентов установки. По умолчанию: "Additional Languages". Если вас устраивают настройки по умолчанию, можете пропустить эту запись.
OptionalSectionDescription (необязательно): описание компонента приложения в окне выбора компонентов установки. По умолчанию: "Add multilingual support for this app". Если вас устраивают настройки по умолчанию, можете пропустить эту запись.
OptionalSectionSelectedInstallType (необязательно) что будет записано в appinfo.ini и отображаться в PortableApps.com Platform, если пользователь устанавливает приложение с дополнительным компонентом. По умолчанию: "Multilingual". Если вас устраивают настройки по умолчанию, можете пропустить эту запись.
OptionalSectionNotSelectedInstallType (необязательно) что будет записано в appinfo.ini и отображаться в PortableApps.com Platform, если пользователь устанавливает приложение без дополнительного компонента. По умолчанию: "English". Если вас устраивают настройки по умолчанию, можете пропустить эту запись.
OptionalSectionPreSelectedIfNonEnglishInstall (опционально) определяет, будет ли дополнительный компонент выбран по умолчанию, если пользователь выбрал установку на любом другом языке, кроме английского. По умолчанию: "true". Если вас устраивают настройки по умолчанию, можете пропустить эту запись.
OptionalSectionInstalledWhenSilent (опционально) определяет, будет ли дополнительный компонент установлен, если была запущена тихая установка в автоматическом режиме. По умолчанию: "true".
OptionalDirectory1 позволяет указать, какие папки входят в дополнительный компонент программы установки. OptionalDirectory1 и выше доступны для использования(OptionalDirectory2,..). Путь должен быть относительным.
Пример: OptionalDirectory1=App\AppName\locales
OptionalFile1 позволяет указать, какие конкретно файлы входят в дополнительный компонент программы установки. OptionalFile1 и выше доступны для использования(OptionalFile2,..). Путь должен быть относительным. Если, например, вы хотите выбрать все .Lang файлы в папке AppName, укажите: OptionalFile1=App\AppName\*.Lang

[OptionalComponents] Примечание: Вы должны использовать либо OptionalDirectory1 или OptionalFile1 чтобы указать файлы для включения в дополнительный компонент программы установки.

Чтобы было более понятно про раздел OptionalComponents, посмотрите пример из файла installer.ini для программы QIP:
Code
[OptionalComponents]  
OptionalComponents=true  
MainSectionTitle=Qip 2010  
MainSectionDescription=Только Qip 2010  
OptionalSectionTitle=Плагины  
OptionalSectionDescription=Плагины для Qip 2010  
OptionalSectionSelectedInstallType=QIP 2010  
OptionalSectionNotSelectedInstallType=QIP 2010  
OptionalSectionPreSelectedIfNonEnglishInstall=True  
OptionalDirectory1=app\Qip2010\Plugins\Checkers  
OptionalDirectory2=app\Qip2010\Pl ugins\gtForm  
OptionalDirectory3=app\Qip2010\Plugins\QipSea  
OptionalDirectory4=app\Qip2010\Plugins\QiPSpeller  
OptionalDirectory5=app\Qip20 10\Plugins\UmorList  
OptionalDirectory6=app\Qip2010\Plugins\smssend  
OptionalDirectory7=app\Qip2010\Plugins\sTypograph  
OptionalDirectory8=a pp\Qip2010\Plugins\WInfo


(К сожалению пока можно сделать только один компонент для установки.)

Раздел [CopyLocalFiles]:
Этот раздел (секция) используется для копирования файлов от локальной (местной) установки приложений.
CopyLocalFiles используется, чтобы указать, что этот раздел (секция) включен. Он должен быть установлен в действительности.
CopyFromRegPath используется, когда путь к локальным (местным) файлам указан в разделе реестра. Как правило, это будет в виде HKLM\Software\AppName.
CopyFromRegKey используется в сочетании (соединении) с CopyFromRegPath. Это указывает, что путь Ключа регистрации выше этого должен быть использован.
CopyFromRegRemoveDirectories используется, чтобы указать количество каталогов, которые полоску из ключевых читать прибыть в каталог, который должен быть скопирован. Если ключ указывает путь к файлу, а не к каталогу, он должен быть увеличен на один.
Например, если ключевое правило указывает на C:\Program Files\AppName\bin\AppName.exe, и вы хотите скопировать все файлы в C:\Program Files\AppName, это было бы установлено на 2: один для удаления имя файла AppName.exe и один, чтобы удалить "мусор" в каталоге из пути.
CopyFromDirectory используется, чтобы указать локальный (местный) каталог для копирования в портативное приложение. Если используется в сочетании с записями реестра выше, она будет использоваться в качестве запасного варианта, если запись реестра отсутствует или не указывает на правильный путь. Этот вход (запись) обычно находится в виде %PROGRAMFILES%\AppName. Некоторые переменные окружения доступны в том числе: %PROGRAMFILES%, %COMMONFILES%, %DESKTOP%, %WINDIR%, %SYSDIR%, %APPDATA%, %LOCALAPPDATA% and %TEMP%.
CopyToDirectory указывает относительный путь в пределах портативного приложения, в которое будут скопированы файлы. Это обычно находится в виде App\AppName . Если каталог не существует, он будет создан.

Раздел [DownloadFiles]:

Этот раздел используется для загрузки и (при необходимости) извлечения файлов из Интернета.
DownloadURL указывает URL (путь, адрес) к файлу, который будет загружен. Это обычно в виде http://example.com/path/filename
DownloadName - имя, которое будет отображаться во время загрузки файла. Это должно быть действительным именем DOS (ДОСА) и не должны включать в себя специальные символы, такие как: ",, \ и т.д.
DownloadFilename - название файла, который будет использоваться во время, как это работает локально. Это должно обычно быть тем же самым как именем файла из DownloadURL. Это обычно в форме filename.exe или filename.zip.
DownloadMD5 используется для указания MD5 хэш загруженного файла. Это позволяет установщику (инсталлятору) убедиться (проверить), что файл не изменился с создания Установки (Инсталлятора). Использование этой запись - рекомендуется *highly* (очень).
DownloadTo необязательно использовать, если загруженный файл должен быть просто скопирован в портативное приложение как есть. Запись обычно находится в форме App\AppName. Эта запись не будет (не должна) использоваться с записями извлечением, которые следуют.
AdditionalInstallSize используется, чтобы определить размер файлов, которые будут добавлены в файлы, содержащиеся в программе установки (в инсталляторе). Запись должна иметь только номер и быть в KB (КБ).
Extract1To и Extract1File (НЕ РЕКОМЕНДУЕТСЯ!) используются только для простого извлечения файлов из ZIP файлов. Записи Extract#To (Извлечение#) должны определить (указать) относительный путь, где файлы будут идти в пределах установленного портативного приложения (как правило, App\AppName). Extract#File (Извлечение # Файлов) используется для указания имени файла для извлечения. Не разрешено использование никаких шаблонов (групповых символов). Может быть сделано до 10 записей в форме Extract1To/Extract1File, Extract2To/Extract2File. Extract#To (Извлечение #) поддерживают использование , чтобы указать на корневой каталог приложения. Запрещены - Примечание: ExtractTo и ExtractFile являются устаревшими в пользу AdvancedExtractTo и AdvancedExctractFilter. Методы, используемые для ExtractTo не полностью совместимы с non-ANSI именами каталогов (директорий). Данная функция остается для этой версии PA.c Format для обеспечения совместимости. Заявки будут автоматически преобразованы в новый метод в более поздней версии.
AdvancedExtract1To и AdvancedExtract1Filter используются для более продвинутого извлечения из ZIP файлов, а также из многих установщиков (инсталляторов) EXE-файлов. Записи AdvancedExtract #To должны определить (указать) относительный путь туда, где файлы пойдут в пределах установленного портативного приложения (как правило App\AppName). Записи AdvancedExtract #Filter используются для определения (указания) фильтра для файлов, которые будут извлечены, и находятся в том же самом формате, что и 7-Zip. Некоторые примеры включают *.txt для всех текстовых файлов, * для всех файлов, *a* для файлов, которые содержат письма a, Src\*.cpp для всех CPP файлов в пределах каталога SRC и т.д. ** может быть использовано, чтобы указать на все файлы в архиве рекурсивно (включая подкаталоги). Может быть сделано до 10 записей. AdvancedExtract #To поддерживает использование , чтобы указать на корневой каталог приложения.
DoubleExtractFilename используется, когда загруженный файл содержит архив в архиве. DoubleExtractFilename должен быть установлен в название архива внутри архива. Например, если Вы загружаете файл под названием setup.exe, содержащий файл data.zip, которому необходимы файлы в его пределах, то DoubleExtractFilename будет установлен в data.zip. DoubleExtract #To и DoubleExtract #Filter выполняется на извлеченном (распакованном) архиве и находятся в том же самом формате, как и AdvancedExtract1To и AdvancedExtract1Filter выше. Могут использоваться до 10 записей. DoubleExtract #To поддерживает использование , чтобы указать на корневой каталог приложения.

Раздел [Languages] (Языки):
Каждая запись используется для указания того, что язык доступен, когда пользователь устанавливает портативное приложение и appinfo.ini установлен как Многоязычный. Если этот раздел (секция) отсутствует, то все языки включены. Если этот раздел включен, АНГЛИЙСКИЙ = не требуется. Все остальные языки не являются обязательными (дополнительными) и по умолчанию (ложно).

Раздел [DirectoriesToPreserve]:
Этот раздел (секция) определяет каталоги, которые будут сохранены, даже если какой-то каталог (App, Data, Other) устанавливается и будет удалён для обновления (модернизации). Доступны до 10 записей в форме PreserveDirectory1, PreserveDirectory2, и т.д. Каждый должен быть в относительных путях в пределах приложения. Если Вы хотите сохранить каталог App\AppName\plugins (плагины), это должно быть введено (сохранено) в этом разделе как PreserveDirectory1=App\AppName\plugins. Если никакие каталоги не нуждаются в сохранении, эта секция должна быть пропущена.

Раздел [DirectoriesToRemove]:
Этот раздел (секция) определяет каталоги, которые будут удалены, даже если указанный каталог (App, Data, Other) установлен и не должен быть удалён на обновление (модернизацию). До 10 записей в форме RemoveDirectory1, RemoveDirectory2, и т.д. доступны. Каждый из них должен быть в относительных путях в пределах приложения. Если бы Вы хотите удалить каталог App\AppName\locales, он вводится в этом разделе как RemoveDirectory1=App\AppName\locales. Если никакие каталоги не нуждаются в удалении, эта секция должна быть пропущена.

Раздел [FilesToPreserve]:

Этот раздел (секция) определяет каталоги, которые будут сохранены, даже если данный каталог (App, Data, Other) установлен и не должен быть удалён на обновление (модернизацию). До 10 записей в форме PreserveFile1, PreserveFile2 и т.д. доступны. Каждый из них должен быть в относительных путях в пределах приложения. Если бы Вы хотите сохранить файлы App\AppName\*.hlp, это вводится в этом разделе как PreserveFile1=App\AppName\*.hlp. Если никакие файлы не нуждаются в сохранении, этот раздел должен быть пропущен.

Раздел [FilesToRemove]:
Этот раздел определяет файлы, которые будут удалены, даже если данный каталог (App, Data, Other) установлен и не должен быть удален на обновление (модернизацию). До 10 записей в форме RemoveFile1, RemoveFile2, и т.д. доступны. Каждый из них должен быть в относительных путях в пределах приложения. Если бы Вы хотите удалить файлы App\AppName\*.lang (язык), это вводится в данном разделе как RemoveFile1=App\AppName\* lang. Если никакие файлы не нуждаются в удалении, этот раздел (секция) должен быть пропущен.

Лицензионное соглашение конечного пользователя (EULA) или другой файл лицензии могут быть отображены в Installer PortableApps.com Installer (Инсталляторе) путем включения EULA.txt или EULA.rtf - файл справки Other\Source (исходный каталог). PortableApps.com Установщик (Инсталлятор) автоматически найдёт и настроит его для использования. Пожалуйста, убедитесь, что лицензия в формате Юникод, а не ANSI.

Custom Code может быть включен с помощью программы установки (инсталлятором), в том числе файла с именем PortableApps.comInstallerCustom.nsh в Other \ Source directory (исходный каталог). Этот файл закодирован в NSIS и может включать в себя 3 макроса: CustomCodePreInstall (которая выполняется /управляется/ перед установкой), CustomCodePostInstall (которая запускается /управляется/ после установки) и CustomCodeOptionalCleanup (которая выполняется /управляется/ в начале установки, если дополнительный раздел установки (инсталлятора) не выбран , предназначенна для использования в приложении обновления, когда существующему приложению, возможно, включали дополнительную секцию /раздел/). В дополнение к стандартным функциям NSIS, в NSIS доступны следующие функции: ConfigRead, ConfigReadS, ConfigWrite, ConfigWriteS, GetParent, GetRoot, VersionCompare и LogicLib особенности NSIS. Пожалуйста, убедитесь, что файл в кодировке Юникод (а не в ANSI / DOS).

Код программы PortableApps.com Installer не должен быть изменён непосредственно в пределах границ PortableApps.com Installer. Однако исходный код доступен под лицензией GPL и может быть свободно модифицирован и использован в других GPL-лицензированных работах.

Каждый выпуск приложения в PortableApps.com Format должен использовать поток PortableApps.com Installer. Если большее заявление собирается, у которого есть более длительное время развития и тестирования, и новая версия PortableApps.com Installer освобожден во время тестирования выпуска версия инсталлятора, который в настоящее время использует приложение, может быть сохранен при условии, что новой версии Инсталлятора меньше чем 30 дней в день, заявление, используя более старую версию выпущено.


Просьба: Замечания по неточности в переводе с английского - пишите в комментариях.



6. Изменения в ОС и Портативность в PortableApps.com Format

Во время работы портативных приложений (Portable-программ) разрешается изменять записи реестра и файлы на локальном диске, однако реестр и локальные файлы должны быть возвращены в их исходное состояние при выходе Portable-программы из системы. Это происходит за счёт резервного копирования, а затем восстановления локальной копии (либо реестра или APPDATA) приложения при запуске и выходе. Портативные приложения (Portable-программы) должны продолжать работать (настройки и предпочтения сохраняться, выбор языка сохраняться), при изменении буквы диска, т.к. устройство перемещается между компьютерами. Список недавно использовавшихся приложений (MRU) должен продолжать работать.



7. Установка плагинов в PortableApps.com Format

В дополнение к стандартным инсталляторам, PortableApps.com Installer (Установщик) может использоваться для инсталляции (вставки) плагинов, чтобы добавить файлы к портативному приложению. Это достигается с помощью файла под названием plugininstaller.ini в каталоге Other\Source (исходный каталог). Этот файл может содержать все элементы в пределах файлов appinfo.ini и installer.ini, описанные выше объединенного в единственный файл. Одно дополнение к файлу в пределах [Details] раздела (секции), где запись под названием PluginName= is made. Это должно быть название плагина, например: Adobe Flash для Firefox Portable. Варианты удаления [MainDirectories] все по умолчанию, к ложным для вставки плагина. Если EULA (лицензионное соглашение) необходимо для плагина, вместо EULA.txt или EULA.rtf, должны использоваться файлы PluginEULA.txt или PluginEULA.rtf.

Чтобы создать плагин установки (вставной инсталлятор), создайте директивное расположение, подобное портативному приложению, где плагин используется с включением App, каталогов App\AppName, Data, Other, и т.д. Затем поместите в нужное (соответствующее) место только те файлы, которые будут включены в плагин установки (во вставной инсталлятор). Каталог App\AppInfo должен быть пустым, поскольку он используется только главным (основным) приложением. Любой пользовательский код должен находиться в файле с названием PortableApps.comInstallerPluginCustom.nsh. Наконец, создайте файл plugininstaller.ini с записями, которые обычно были бы в appinfo.ini и installer.ini выше и собирали бы как нормальный (собрать, как обычно).

Кроме того, установку (инсталляцию) CommonFiles, который будет установлен в X:\PortableApps\CommonFiles, можно путём добавления записи в разделе (секции) entryPluginType = CommonFiles. Это для использования с определенными плагинами, которые используются несколькими приложениями (Java, например), как установлено PortableApps.com. В этом случае возможность удаления [MainDirectories] для App установлена по умолчанию и удалит весь каталог X:\PortableApps\CommonFiles\AppID (который обычно используется для CommonFiles plugins (плагинов).


Просьба: Замечания по неточности в переводе с английского - пишите в комментариях.



8. PortableApps.com Format - История версий



Просьба: Замечания по неточностям в переводе с английского - пишите в комментариях.






Портативный софт-создание | Добавил: Милка (31.01.2012)
Просмотров: 14334 | Комментарии: 1 | Рейтинг: 5.0/5
Всего комментариев: 1
1 koolikoo  
0
Подскажите, если приложение использует свою папку в program files/common files - что тогда делать и куда что писать?

Добавлять комментарии могут только зарегистрированные пользователи.
[ Регистрация | Вход ]