Руководство по развертыванию .NET Framework для разработчиков

В этом разделе представлены сведения для разработчиков, которые хотят установить .NET Framework 4 со своими приложениями.

Автономный распространяемый пакет .NET Framework 4 и языковые пакеты .NET Framework 4 можно загрузить в Центре загрузки Майкрософт. Ссылки на загрузку указаны в разделах Автономные распространяемые пакеты и Пакеты начального веб-загрузчика.

В этом разделе содержатся следующие подразделы.

• Требования для установки

• Автономные распространяемые пакеты

• Пакеты начального веб-загрузчика

• Распространение .NET Framework 4 с помощью Visual Studio 2010

• Установка платформы .NET Framework вручную

• Привязка распространяемого пакета к процессу установки приложения

• Привязка языковых пакетов к процессу установки приложения

• Обнаружение .NET Framework 4

• Обнаружение языковых пакетов

• Удаление Microsoft .NET Framework 4

• Параметры командной строки

• Устранение неполадок

Дополнительные сведения о способах развертывания администратором платформы .NET Framework 4 и ее системных зависимостей в сети см. в разделе Руководство по развертыванию .NET Framework для администраторов.

Требования для установки

Ниже представлена сводная информация о требованиях к программному обеспечению и оборудованию, необходимых для установки .NET Framework 4. Подробное описание требований см. в разделе Требования к системе для .NET Framework.

Примечание
Для установки .NET Framework 4 требуются права администратора.

Требования к программному обеспечению

Для установки .NET Framework 4 на компьютере должна быть установлена одна из следующих операционных систем:

• Семейство Windows 7.

• Семейство Windows Server 2008 R2.

• Windows Server 2008 Server Core R2 с пакетом обновления 1 или более поздней версии.

• Семейство Windows Vista.

• Семейство Windows Server 2008.

• ОС Microsoft Windows XP Home или Microsoft Windows XP Professional, обе с пакетом обновления 3 (SP3) или более поздней версии.

• Семейство Windows Server 2003 с пакетом обновления 2 (SP2) или более поздней версии.

Для операционной системы Windows Server 2003 необходимо также установить на компьютер Компонент обработки изображений Windows.

• 32-разрядный компонент Windows Imaging Component

• 64-разрядный компонент Windows Imaging Component

Для Windows Server 2008 R2 Server Core необходимо включить следующие компоненты операционной системы.

• Платформа .NET Framework 2.0. Используйте одну из следующих команд ocsetup:

  • start /w ocsetup NetFx2-ServerCore

  • start /w ocsetup NetFx2-ServerCore-WOW64

• Подсистема WOW64 (Windows 32-bit on Windows 64-bit). Используйте следующую команду ocsetup:

  • start /w ocsetup ServerCore-WOW64

Требования к оборудованию

Автономные распространяемые пакеты

Автономные распространяемые пакеты содержат все компоненты, необходимые для развертывания .NET Framework 4 на указанных целевых платформах. Однако эти исполняемые файлы не содержат языковые пакеты. Для установки поддержки дополнительных языков можно использовать автономные языковые пакеты.

В следующей таблице представлен список автономных распространяемых пакетов для каждого профиля и платформы.

Пакеты dotNetFx40_Full_x86_64.exe и dotNetFx40_Client_x86_64.exe разработаны для компьютеров с архитектурой x86 и x64. Это рекомендуемые пакеты, подходящие для большинства сценариев развертывания. Однако эти пакеты не поддерживает компьютеры с IA-64.

Если платформу .NET Framework 4 планируется устанавливать только на компьютеры с архитектурой x86, используйте пакет dotNetFx40_Full_x86.exe или dotNetFx40_Client_x86.exe. Не используйте эти пакеты для установки на 64-разрядных операционных системах. (Пакет клиентского профиля недоступен для распространения на компьютерах с IA-64.)

Пакеты начального веб-загрузчика

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

Примечание
Пакеты начального веб-загрузчика на компьютерах Windows Server 2008 Server Core R2 не работают.

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

С помощью начального веб-загрузчика можно вручную запустить и установить на компьютер распространяемый пакет. Распространяемый пакет также можно запустить и установить в составе программы установки для приложения .NET Framework 4.

Распространение .NET Framework 4 с помощью Visual Studio 2010

При развертывании приложений, которые созданы с помощью Microsoft Visual Studio 2010 и которым требуется платформа .NET Framework 4, она должна быть установлена до установки приложения. Платформу .NET Framework 4 можно включить в исполняемый файл установки, создаваемый с помощью проекта установки Visual Studio 2010. Это можно сделать тремя способами: с помощью проекта установки Visual Studio, развертывания приложения ClickOnce или проекта InstallShield.

При создании программы установки для .NET Framework ее можно привязать к процедуре установки приложения для контроля установки .NET Framework. Эта процедура рассматривается в разделе Привязка платформы .NET Framework к установке приложения. Кроме того, можно привязать языковые пакеты .NET Framework, если только не используется начальный веб-загрузчик. Эта процедура рассматривается в разделе Привязка языковых пакетов .NET Framework к установке приложения.

Если создание файла установки нецелесообразно, пользователи могут вручную установить .NET Framework в соответствии с описанием в следующем разделе.

Примечание
Сведения об установке платформы .NET Framework 4 на компьютерах Server Core см. в разделе Привязка языковых пакетов к процессу установки приложения.

Включение платформы .NET Framework в проект установки

При настройке проекта установки Visual Studio 2010 для установки платформы .NET Framework 4 с приложением платформа .NET Framework 4 оформляется в один пакет с приложением. Программа установки приложения проверяет, установлена ли платформа .NET Framework 4, и при необходимости в процессе установки перед приложением устанавливается .NET Framework.

В Visual Studio 2010 создайте новый проект установки, выполнив следующие действия.

1. В меню Файл выберите команду Создать, затем выберите пункт Проект.

2. В левой панели выберите пункт Другие типы проектов, затем пункт Установка и развертывание и щелкните элемент Установщик Visual Studio.

3. В поле Имя введите имя проекта и нажмите кнопку ОК.

4. В обозревателе решений щелкните правой кнопкой мыши кнопку Добавить, а затем укажите выходные данные проекты, модули слияния, файлы и сборки.

5. В обозревателе решений щелкните правой кнопкой мыши имя проекта установки и выберите пункт Свойства.

6. В диалоговом окне Страницы свойств щелкните пункт Необходимые компоненты.

7. Убедитесь, что в диалоговом окне Необходимые компоненты установлен флажок Создать программу установки для необходимых компонентов.

8. В списке необходимых компонентов найдите .NET Framework 4 и выберите необходимый профиль (.NET Framework 4 или клиентский профиль .NET Framework 4).

9. Выберите необходимый вариант, чтобы указать расположение необходимых компонентов, и нажмите кнопку ОК.

   При предоставлении URL-адреса в качестве местонахождения файла загрузки .NET Framework 4 можно указать либо Центр загрузки Майкрософт, либо свой сайт. При размещении распространяемого пакета на своем сервере этот пакет должен быть полностью распространенным и не должен являться начальным веб-загрузчиком. Начальный веб-загрузчик можно загрузить только в Центре загрузки Майкрософт. В URL-адресе можно также указать компакт-диск, на котором распространяется ваше приложение.

10. В диалоговом окне Страницы свойств нажмите кнопку ОК.

Включение платформы .NET Framework с развертыванием ClickOnce

Развертывание ClickOnce позволяет публиковать приложения Windows на веб-сервере или в общей сетевой папке с целью упрощения установки. Visual Studio обеспечивает полную поддержку публикации и обновления приложений, развернутых с использованием ClickOnce. Развертывание ClickOnce доступно для проектов, созданных при помощи Visual Basic и Visual C#, но недоступно для Visual C++.

В Visual Studio 2010 выберите развертывание ClickOnce, выполнив следующие действия.

1. Откройте проект приложения, который необходимо опубликовать.

2. В обозревателе решений щелкните правой кнопкой мыши имя проекта и выберите пункт Свойства.

3. Щелкните область Публикация.

4. Нажмите кнопку Необходимые компоненты.

5. Убедитесь, что в диалоговом окне Необходимые компоненты установлен флажок Создать программу установки для необходимых компонентов.

6. В списке необходимых компонентов найдите .NET Framework 4 и выберите необходимый профиль (.NET Framework 4 или клиентский профиль .NET Framework 4).

7. Выберите необходимый вариант, чтобы указать расположение необходимых компонентов, и нажмите кнопку ОК.

   При предоставлении URL-адреса в качестве расположения файла загрузки .NET Framework 4 можно указать либо Центр загрузки Майкрософт, либо свой сайт. При размещении распространяемого пакета на своем сервере этот пакет должен быть полностью распространенным и не должен являться начальным веб-загрузчиком. Начальный веб-загрузчик можно загрузить только в Центре загрузки Майкрософт. В URL-адресе можно также указать компакт-диск, на котором распространяется ваше приложение.

8. В диалоговом окне Страницы свойств нажмите кнопку ОК.

Включение платформы .NET Framework с InstallShield

Средство InstallShield позволяет публиковать приложения Windows с помощью Visual Studio 2010.

В Visual Studio 2010 создайте новый проект установки, выполнив следующие действия.

1. В меню Файл выберите команду Создать, затем выберите пункт Проект.

2. В левой панели выберите пункт Другие типы проектов, затем пункт Установка и развертывание, а затем щелкните элемент InstallShield 2010.

3. В поле Имя введите имя проекта и нажмите кнопку ОК.

4. При первом входе в систему необходимо выбрать пункт Перейти к InstallShield, чтобы загрузить пакет InstallShield Limited Edition для Microsoft Visual Studio 2010. Перезапустите Visual Studio 2010.

5. Перейдите к мастеру Помощник по проекту и щелкните пункт Файлы приложения, чтобы добавить их в выходные данные проекта. В окне Помощник по проекту можно настроить другие атрибуты проекта.

6. Перейдите в окно Требования установки и выберите операционные системы и версию платформы .NET Framework, которую необходимо установить.

7. Щелкните правой кнопкой мыши проект установки и выберите пункт Построение.

Установка платформы .NET Framework вручную

Иногда автоматическая установка .NET Framework 4 вместе с приложением может оказаться непрактичной. В этом случае можно обязать пользователей установить платформу .NET Framework самостоятельно. Предусмотрено несколько конфигураций распространяемого пакета (см. разделы Автономные распространяемые пакеты и Пакеты начального веб-загрузчика выше). В процессе установки дайте пользователям указания о том, как найти и установить .NET Framework.

Привязка платформы .NET Framework к процедуре установки приложения

В .NET Framework 4 предусмотрено два способа использования команд командной строки, чтобы включить (привязать) процедуру установки платформы .NET Framework 3.5 в процесс установки приложения. 

• Полный набор файлов .NET Framework можно поместить на распространяемый носитель, чтобы в процессе установки пользователям не пришлось загружать дополнительные файлы из Интернета.

• В процессе установки .NET Framework можно автоматически определить список требуемых компонентов и загрузить из Интернета и установить только их с помощью пакетов начального веб-загрузчика.

Эти два варианта рассматриваются в следующих двух подразделах.

Независимо от выбранного варианта для включения .NET Framework 4 в процесс установки приложения необходимо запустить распространяемый пакет из командной строки, используя соответствующие параметры после имени EXE-файла распространяемого пакета, и обработать коды ошибок следующим образом.

<.NET Framework redistributable> /q /norestart /ChainingPackage <packageName>

Примечание
Примеры в этом разделе предполагают, что имя привязываемого пакета — MyProductName.

Полный список параметров см. в подразделе Параметры командной строки.

Пример привязки пакета см. в разделе Практическое руководство. Получение хода выполнения установщика .NET Framework 4.

Включение файлов платформы .NET Framework с распространяемым носителем

При включении в процесс установки всех компонентов .NET Framework используются автономные распространяемые пакеты. Эти пакеты содержат компоненты, необходимые для установки .NET Framework 4 на компьютерах с архитектурой x86, x64 и IA64 во всех поддерживаемых операционных системах. Например, для привязки процесса установки клиентского профиля .NET Framework на компьютерах с архитектурой x86 или x64 с помощью автономного распространяемого пакета необходимо использовать следующую команду:

dotNetFx40_Client_x86_x64.exe /q /norestart /ChainingPackage "MyProductName"

Примечание
Этот метод не привязывает (не устанавливает) языковые пакеты.(См. раздел Привязка языковых пакетов .NET Framework к установке приложения.)

Принятие решения процедурой установки платформы .NET Framework

В этом варианте пакеты начального веб-загрузчика устанавливают только необходимые компоненты. Можно использовать развертывание начального веб-загрузчикам с языковыми параметрами по умолчанию или указать другой языковой пакет, используя параметр командной строки /LCID.

• Использование языковых параметров по умолчанию

  Если не указывать параметр командной строки /LCID, начальный веб-загрузчик автоматически загрузит языковой пакет, соответствующий параметру многоязыкового пользовательского интерфейса. Например, для привязки полного процесса установки платформы .NET Framework на компьютерах с архитектурой x86 ли x64 с помощью пакета начального веб-загрузчика в процесс установки приложения необходимо добавить следующую команду:

  dotNetFx40_Full_setup.exe /q /norestart /ChainingPackage "MyProductName"
  

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

• Переопределение языковых параметров по умолчанию

  Если указать параметр командной строки /LCID, начальный веб-загрузчик не выполнит автоматическое обнаружение, он загрузит указанный языковой пакет. Например, для привязки полного процесса установки платформы .NET Framework на компьютерах с архитектурой x86 или x64 и установки японского языкового пакета в процесс установки приложения необходимо добавить следующую команду:

  dotNetFx40_Full_setup.exe /q /norestart /ChainingPackage "MyProductName" /LCID 1041
  

  Примечание
  Даты выпусков языковых пакетов могут быть разными.Если в центре загрузки требуемый языковой пакет отсутствует, программа установки установит .NET Framework без языкового пакета.Кроме того, если платформа .NET Framework 4 уже установлена на компьютере пользователя, начальный веб-загрузчик установит только языковой пакет.

Отслеживание и отмена автоматической установки во время процесса установки

Установка .NET Framework 4 часто может быть обязательной при установке приложений. Чтобы создать специальную или универсальную процедуру установки приложений, требующих .NET Framework 4, возможно, потребуется автоматическая установка и отслеживание процесса установки .NET Framework 4 с особым отображением хода установки. Способ разрешения такой процедуры см в библиотеке MSDN.

Привязка языковых пакетов к процессу установки приложения

В следующей таблице представлен список исполняемых файлов автономного языкового пакета, содержащих локализованные ресурсы для конкретных целевых платформ. Эти исполняемые файлы не содержат не зависящие от языка двоичные файлы, необходимые для установки языковых пакетов .NET Framework 4. Обозначение язык определяет поддерживаемый язык.

При использовании начального веб-загрузчика привязка языковых пакетов не требуется.

Примечание
Языковые пакеты клиентского профиля недоступны для распространения на компьютерах с IA-64.

Некоторые примеры таких пакетов представлены на страницах dotNetFx40LP_Full_x86_x64de.exe и dotNetFx40LP_Full_x86_x64ja.exe.

Например, чтобы развернуть полный вариант платформы .NET Framework 4 с немецким языковым пакетом на компьютерах с архитектурой x86 или x64, необходимо использовать следующую команду:

dotNetFx40LP_Full_x86_x64de.exe /q /norestart /ChainingPackage "MyProductName"

Полный список параметров командной строки см. в подразделе Параметры командной строки.

Обнаружение .NET Framework 4

Установщик .NET Framework 4 считывает разделы реестра, если установка выполнена успешно. Чтобы проверить, установлена ли платформа .NET Framework 4, просмотрите разделы реестра, указанные в приведенной ниже таблице.

Обнаружение языковых пакетов

Чтобы проверить, установлен ли на компьютере определенный языковой пакет, проверьте разделы реестра, указанные в приведенной ниже таблице. Параметр LCID задает код языка; список кодов см. на странице поддерживаемых языков.

Например, чтобы проверить, установлен ли уже японский полный языковой пакет, необходимо проверить следующие значения в реестре:

Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\1041
Name: Install
Type: DWORD
Data: 1

Удаление платформы .NET Framework 4

Платформу .NET Framework 4 можно удалить в разделе Установка и удаление программ в панели управления. Перед тем как удалить клиентский профиль .NET Framework 4, следует удалить расширенную версию .NET Framework 4.

Для операционных систем Server Core необходимо удалить .NET Framework 4 с помощью следующих операций командной строки.

1. Удаление расширенной версии .NET Framework 4:

   %windir%\Microsoft.NET\Framework64\v4.0.30319\SetupCache\Extended\setup.exe /uninstall /x86 /x64 /ia64 /parameterfolder Extended /q
   

2. Удаление клиентского профиля .NET Framework 4:

   %windir%\Microsoft.NET\Framework64\v4.0.30319\SetupCache\Client\setup.exe /uninstall /x86 /x64 /parameterfolder Client
   

Параметры командной строки

В приведенной ниже таблице перечислены параметры, которые можно указывать при запуске программы установки .NET Framework 4 из командной строки.

Параметр	Описание
/q	Включает автоматический режим.
/norestart	Предотвращает автоматическую перезагрузку программы установки. При использовании этого параметра привязываемое приложение должно захватить код возврата и обработать перезагрузку (см. раздел Отслеживание.NET Framework 4).
/repair	Включение функции исправления
/LCID LCID где параметр LCID задает код языка (список кодов см. на странице поддерживаемых языков).	Устанавливает языковой пакет, определенный параметром LCID, и обеспечивает принудительное отображение пользовательского интерфейса на этом языке (если не включен автоматический режим). Для начального веб-загрузчика этот параметр означает привязку (установку) языкового пакета из Интернета. Примечание Не используйте этот параметр при установке языковых пакетов .NET Framework.
/passive	Задает пассивный режим; отображает индикатор выполнения установки, но не выводит подсказки и сообщения об ошибках. В этом режиме программа установки должна обработать коды возврата.
/showfinalerror	Задает пассивный режим, но отображает сообщения об ошибках в случае ошибки установки. При использовании этого параметра в случае ошибки установки требуется вмешательство пользователя.
/promptrestart	В пассивном режиме, если программа установки требует перезагрузки компьютера, пользователю выводится соответствующий запрос. При использовании этого параметра в случае необходимости перезагрузки требуется вмешательство пользователя.
/CEIPConsent	Перезаписывает поведение по умолчанию и отправляет анонимные сведения об установке в корпорацию Майкрософт для совершенствования процедуры развертывания в будущем. Этот параметр можно использовать, только если программа установки приложения запрашивает согласие пользователя и только если пользователь разрешает отправлять анонимную статистку в корпорацию Майкрософт.
/chainingpackage PackageName	Указывает имя исполняемого файла, осуществляющего привязку. Эти сведения отправляются в корпорацию Майкрософт в качестве анонимной статистики для совершенствования процедуры развертывания в будущем. Если в имени пакета присутствуют пробелы, в качестве разделителей необходимо использовать двойные кавычки (например, /chainingpackage "Chaining Product"). Пример привязываемого пакета см. в разделе Getting Progress Information from an Installation Package в библиотеке MSDN.

Поддерживаемые языки

Устранение неполадок

Коды возврата

В следующей таблице перечислены наиболее распространенные коды возврата программы установки распространяемого пакета .NET Framework 4. Коды возврата одинаковы для всех версий установщика. Подробные сведения см. в следующем подразделе, "Коды ошибок загрузки".

Коды ошибок загрузки

• Background Intelligent Transfer Service (BITS) error codes

• URL moniker error codes

• WinHttp error codes

Другие коды ошибок

• Windows Installer error codes

• Windows Update Agent result codes

См. также

Основные понятия

Установка платформы .NET Framework

Другие ресурсы

Руководство по развертыванию .NET Framework для администраторов

Журнал изменений