Пример разработки одного пакета

Пример PUASample.msi — это пример пакета установщика Windows с двойной целью 5.0, который может быть установлен в контексте установки на пользователя или на компьютер в Windows Server 2008 R2 и Windows 7. Этот пример пакета следует рекомендациям по разработке, описанным в статье "Разработка отдельных пакетов".

Получение копии примера

Копия этого примера и редактор таблицы базы данных установщика Windows, Orca.exe, находятся в компонентах пакета SDK для Windows для разработчиков установщика Windows. Пример и редактор таблиц предоставляются в комплекте средств разработки программного обеспечения Windows для Windows Server 2008 R2 и Windows 7 в качестве файлов установки установщика Windows PUASample1.msi и Orca.msi.

Требования к системе

Редактор базы данных Orca.exe требует Windows Server 2008 R2 и более ранних версий и Windows 7 и более ранних версий. Пакет двойного назначения PUASample1.msi можно установить в контексте установки на компьютер или на пользователя в Windows Server 2008 R2 и Windows 7. PUASample1.msi можно установить только в контексте на компьютере в Windows Server 2008 и более ранних версиях и Windows Vista и более ранних версиях. Редактор базы данных можно установить для проверки содержимого PUASample1.msi без установки примера. Чтобы установить пример или пакеты редактора, убедитесь, что политика DisableMSI не задана для значения, которое блокирует установку приложений.

Определение пакета двойного назначения

Пакеты двойного назначения должны инициализировать значение свойства MSIINSTALLPERUSERER ДО 1. Это определяет пакет как способный устанавливаться в контексте для каждого компьютера или пользователя в Windows Server 2008 R2 и Windows 7. Задайте свойство MSIINSTALLPERUSER в пакете только в том случае, если оно было написано в соответствии с рекомендациями по разработке отдельных пакетов, и если вы планируете предоставить пользователям возможность установить пакет в контексте каждого пользователя или на компьютер. Пакет двойного назначения также должен инициализировать значение свойства ALLUSERS до 2. Это указывает на пользователя в качестве контекста установки по умолчанию для приложения. Если значение свойства ALLUSERS имеет значение, отличное от 2, установщик Windows игнорирует свойство MSIINSTALLPERUSERERER.

Используйте редактор базы данных установщика Windows, например Orca.exe, для изучения содержимого PUASample1.msi. Таблица свойств в примере пакета содержит следующие две записи.

Таблица свойств (частично)

Настраиваемое диалоговое окно для контекста установки

Пользовательский интерфейс примера пакета содержит пример настраиваемого диалогового окна VerifyReadyDialog, который позволяет пользователям выбирать контекст установки для каждого пользователя или на компьютер во время установки. Таблица диалогового окна содержит запись, описывающую диалоговое окно VerifyReadyDialog. Значение, введенное в поле "Атрибуты", равно 39, так как в этом диалоговом окне используется msidbDialogAttributesVisible (1), msidbDialogAttributesModal (2), msidbDialogAttributesMinimize (4) и msidbDialogAttributesTrackDiskSpace (32). В строке заголовка диалогового окна отображается название, заданное значением свойства ProductName .

Таблица диалоговых окон (частичное)

Таблица control содержит записи для элементов управления , отображаемых в диалоговом окне VerifyReadyDialog. В диалоговом окне отображаются элементы управления PushButton и элемент управления Text . Все элементы управления используют атрибуты элемента управления msidbControlAttributesEnabled (2) и msidbControlAttributesVisible (1). Элемент управления InstallPerMachine также использует атрибут элемента управления ElevationShield, msidbControlAttributesElevationShield (8388608.) Этот атрибут элемента управления добавляет в элемент управления InstallPerMachine значок повышения прав пользователей (UAC) и сообщает пользователю, что учетные данные UAC необходимы для установки приложения в контексте каждого компьютера. Значение в текстовом поле таблицы Control — это текстовый стиль и текст, отображаемый элементом управления. Дополнительные сведения о добавлении текста в элемент управления с помощью предопределенных стилей см. в описании поля "Текст" в разделе "Элемент управления".

Таблица управления (частично)

Таблица ControlEvent указывает controlEvents или действия, установщик выполняется при взаимодействии пользователя с элементом управления. Когда пользователь активирует push-кнопку InstallPerUser, пользовательский интерфейс отображает диалоговое окно OutOfDisk, если свойство OutOfDiskSpace равно 1, задает значение свойства MSIINSTALLPERUSERERER значение 1, задает значение свойства ALLUSERS равным 2, задает для свойства MSIFASTINSTALL значение 1 и возвращает . Так как свойство MSIFASTINSTALL задано, точка восстановления системы не создается для установки. Когда пользователь активирует pushbutton InstallPerMachine, пользовательский интерфейс отображает диалоговое окно OutOfDisk, если свойство OutOfDiskSpace равно 1, задает значение свойства ALLUSERS значение 1 и возвращает значение.

Таблица ControlEvent (частично)

Элемент управления InstallPerUser должен быть удален из пользовательского интерфейса любой установки с помощью версии установщика Windows до установщика Windows установщика Windows 5.0. Таблица ControlCondition в примере пакета содержит четыре записи, которые отключают и скрывают элемент управления InstallPerUser, если текущая версия меньше установщика Windows 5.0. В таблице используется значение свойства VersionMsi и синтаксис условной инструкции для определения этого условия. Действие, указанное в поле Action, выполняется только в том случае, если оператор в поле "Условие" имеет значение true.

Таблица ControlCondition (частично)

Указание структуры каталогов

Используйте редактор базы данных для проверки таблицы каталогов PUASample1.msi. Запись таблицы каталогов с пустой строкой в поле Directory_Parent представляет корневой каталог деревьев исходного и целевого каталогов. Если свойство TARGETDIR не определено, установщик задает значение во время установки значение свойства ROOTDRIVE. Если свойство SourceDir не определено, установщик устанавливает его значение в расположение каталога, содержащего пакет установщика Windows (MSI-файл).) Имена каталогов указываются с помощью короткого|длинного формата.

Таблица каталогов (частичная)

В источнике эта таблица каталогов разрешает следующие пути к каталогу.

\[SourceDir\]\\Msft\\Sample1 \[SourceDir\]

В целевой папке таблица каталогов разрешает пути в следующей таблице. Установщик задает значения свойств ProgramFilesFolder и ProgramMenuFolder в расположения, которые зависят от контекста установки и являются ли система 32-разрядными или 64-разрядными версиями Windows Server 2008 R2 и Windows 7. Пути к целевым папкам зависят от того, выбирает ли пользователь установку на отдельный пользователь или на компьютер.

Приложения для каждого пользователя должны храниться в вложенных папках в папке "Программы", указанной значением свойства ProgramFilesFolder . Как правило, путь к приложению принимает следующую форму.

%LOCALAPPDATA%\Program\ISV name\AppName.

Данные конфигурации для каждого пользователя должны храниться в папке "Программы", указанной значением свойства ProgramMenuFolder . Как правило, эта папка расположена по следующему пути.

%APPDATA%\Microsoft\Windows\Пуск меню\Программы

При установке 32-разрядных компонентов пакета установщика Windows используйте свойство ProgramFilesFolder и CommonFilesFolder в таблице каталогов. При установке 64-разрядных компонентов пакета установщика Windows используйте свойства ProgramFiles64Folder и CommonFiles64Folder. Если приложение содержит 32-разрядные и 64-разрядные версии одного компонента с одинаковым именем, убедитесь, что эти версии сохраняются в разных каталогах или присваивают им разные имена.

В следующей таблице каталогов представлен пример макета каталога, совместимого с пакетом, который включает 32-разрядные и 64-разрядные компоненты и включает некоторые компоненты, которые совместно используются в приложениях.

В источнике эта таблица каталогов разрешает следующие пути к каталогу.

\[SourceDir\]Prog32\\Msft\\Sample1\\x32\\myapp \[SourceDir\]Share32\\Common Files\\Msft\\Sample1\\x32\\shared \[SourceDir\]Prog64\\Msft\\Sample1\\x64\\myapp \[SourceDir\]Share64\\Common Files\\Msft\\Sample1\\x64\\shared \[SourceDir\]Sample1

В целевой папке эта таблица каталогов разрешает следующие пути к каталогу. Целевые пути зависят от контекста установки и системы.

Регистрация приложения

PuASample.msi добавляет подраздел в раздел реестра путей приложений для приложения и выполняет регистрации, которые позволяют сохранять сведения о приложении в реестре под этим разделом. Дополнительные сведения о путях приложений и регистрации приложений см. в разделе "Путь к приложениям" и "Регистрация приложений" в разделе "Расширяемость оболочки" руководства разработчика оболочки. Во время установки пользователь принимает решение установить приложение в контексте установки каждого пользователя или на компьютер. Во время разработки пакета двойного назначения разработчик пакета не может знать, следует ли выполнять регистрацию в HKEY_LOCAL_MACHINE или HKEY_CURRENT_USER ключах.

Разработчик пакета определяет идентификатор файла исполняемого файла приложения в поле "Файл" таблицы файлов .

Таблица файлов (частичная)

Значения, сохраненные в реестре, можно указать в поле "Значение" таблицы реестра в виде строки форматирования . Используйте идентификатор файла, определенный в поле "Файл" таблицы "Файл " и соглашение [#filekey] типа Formatted, чтобы указать значение по умолчанию для раздела реестра путей приложений. Действие INSTALL верхнего уровня выполняет действия в таблице InstallExecuteSequence. После завершения действий CostInitialize FileCost и InstallFinalize в этой таблице установщик Windows заменяет отформатированную подстроку [#MyAppFile] в таблице реестра полным путем к файлу приложения.

В примере определяется настраиваемое свойство RegRoot, которое содержит расположение корневого ключа и использует настраиваемое действие для сброса значения свойства, если пользователь выбирает установку на компьютер. Используйте настраиваемое свойство RegRoot в любых отформатированных строковых значениях, ссылающихся на корневое расположение. В таблице свойств пакет PUASample.msi определяет настраиваемое свойство и задает значение RegRoot для HKCU. Это инициализирует значение свойства для контекста установки для каждого пользователя, рекомендуемого контекста по умолчанию для пакетов двойного назначения.

Таблица свойств (частично)

В таблице CustomAction пакет определяет настраиваемое действие с именем Set_RegRoot_HKLM. Значение в поле Type определяет это как стандартное пользовательское действие типа 51 . Значение полей Source и Target в таблице CustomAction зависит от типа пользовательского действия. Дополнительные сведения о стандартных типах пользовательских действий см. в разделе "Типы настраиваемых действий". Поле Source для пользовательского действия Set_RegRoot_HKLM указывает, что значение свойства RegRoot. Если установщик выполняет Set_RegRoot_HKLM пользовательское действие, это сбрасывает значение свойства RegRoot в HKLM.

Таблица CustomAction (частично)

Действие INSTALL верхнего уровня выполняет действия в таблице InstallExecuteSequence в последовательности, указанной в поле последовательности этой таблицы. Значение, созданное в поле "Последовательность" для пользовательского действия Set_RegRoot_HKLM (1501), указывает, что это настраиваемое действие выполняется после действия InstallInitialize (1500) и перед действием ProcessComponents (1600.) Эта последовательность гарантирует, что запись для Set_RegRoot_HKLM настраиваемого действия вычисляется во время установки. Дополнительные сведения о рекомендуемой последовательности действий в таблице InstallExecuteSequence см. в разделе " Рекомендуемая установкаExecuteSequence ". Синтаксис условной инструкции, созданный в поле "Условие", указывает, что действие Set_RegRoot_HKLM выполняется только в том случае, если значение свойства ALLUSERS равно 1 во время установки. Значение свойства ALLUSERS со значением 1 указывает установку на компьютер.

Таблица InstallExecuteSequence (частично)

Следующие записи в таблице реестра выполняют регистрацию, если установлен компонент ProductComponent. Значение -1 в корневом поле требуется для регистрации в HKEY_LOCAL_MACHINE для установки на пользователя и в HKEY_CURRENT_USER для установки каждого пользователя. Запись с пустой строкой в поле реестра добавляет вложенный ключ для приложения в разделе реестра AppPaths и задает для значения "(Default)" полный путь исполняемого файла приложения. Регистрация MyAppPathAlias сопоставляет исполняемый файл с псевдонимом приложения и позволяет запускать приложение, если пользователь вводит псевдоним puapct в командной строке. Регистрация MyAppPathRegistration сопоставляет имя исполняемого файла с полным путем к файлу.

Автоматическая регистрация отмены воспроизведения

PUASample.msi выполняет регистрацию, которая позволяет пользователю приложения запретить запуск аппаратного автозапуска для выбранных устройств. Сведения о регистрации обработчика для отмены автоматического воспроизведения в ответ на событие см. в разделе "Подготовка оборудования и программного обеспечения для использования с автозапуском" в разделе расширяемости оболочки руководства разработчика оболочки. Следующая запись регистрирует обработчик, указанный в поле Name при установке компонента ProductComponent. Значение -1 в корневом поле необходимо указать установщику Windows, что регистрация должна быть перенаправлена в расположение, которое зависит от контекста установки.

Таблица реестра

Регистрация обработчика предварительной версии

PUASample.msi выполняет регистрации, необходимые для установки обработчика предварительной версии, который позволяет просматривать файлы pua только для чтения без запуска приложения. Сведения о регистрации обработчиков предварительной версии см. в разделе "Регистрация предварительных обработчиков предварительного просмотра" в разделе расширения оболочки руководства разработчика оболочки. Следующие записи в таблице реестра регистрируют обработчик при установке компонента ProductComponent. Значение -1 в корневом поле необходимо указать установщику Windows, что регистрация должна быть перенаправлена в расположение, которое зависит от контекста установки.

Таблица реестра