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

Статья
05/11/2010

Microsoft Corporation

Июль 2006 г.

Содержимое

Сводка
Введение
Требования установки
   Требования к программному обеспечению
   Требования к оборудованию
Где получить распространяемый пакет платформа .NET Framework 3.0
Распространение платформа .NET Framework 3.0 с помощью проекта установки Visual Studio 2005
Установка пользователем платформа .NET Framework вручную
Связывание распространяемого пакета в программе установки приложения
Распространение платформа .NET Framework 3.0 для веб-приложений
Обнаружение Microsoft платформа .NET Framework 3.0
   Чтение разделов реестра
   Чтение строки агента пользователя в Обозреватель Интернета
Параметры командной строки для распространяемого компонента платформа .NET Framework 3.0
Коды ошибок для распространяемого компонента платформа .NET Framework 3.0

Сводка

В этой статье описывается развертывание приложений Microsoft платформа .NET Framework 3.0 с помощью Dotnetfx3.exe, распространяемого пакета платформа .NET Framework 3.0. (10 печатных страниц)

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

Введение

Microsoft.NET Framework 3.0 предоставляет распространяемый установщик, содержащий платформа .NET Framework привязки 2.0 к необходимым API Windows Vista для запуска приложений платформа .NET Framework 3.0.

Распространяемый пакет платформа .NET Framework 3.0 доступен в виде автономного исполняемого файла. Имя файла зависит от типа целевой платформы. Для 32-разрядных платформ файл называется Dotnetfx3.exe. Для 64-разрядных платформ файл называется Dotnetfx3_x64.exe. Вы также можете развернуть небольшой распространяемый пакет с именем Dotnet3setup.exe, который загружает необходимые компоненты во время установки.

Примечание Поддержка IA64 в платформа .NET Framework 3.0 ограничена Microsoft Windows Server с кодовым именем Longhorn. Longhorn уже включает платформа .NET Framework 3.0, поэтому распространяемый пакет не требуется.

Вы можете вручную запустить и установить распространяемый компонент на компьютере или его можно запустить и установить в рамках программы установки для приложения платформа .NET Framework 3.0.

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

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

В этом разделе описываются требования к программному обеспечению и оборудованию для компьютера, на котором должен быть установлен распространяемый пакет Microsoft платформа .NET Framework 3.0. Если минимальные требования не выполнены, Dotnetfx3.exe заблокируют установку распространяемого пакета.

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

Чтобы установить Microsoft платформа .NET Framework 3.0, на целевом компьютере должна быть установлена одна из следующих операционных систем:

Microsoft Windows XP Home или Microsoft Windows XP Professional с пакетом обновления 2 (SP2) или более поздней версии.
Семейство Microsoft Windows Server 2003 с пакетом обновления 1 (SP1) или более поздней версии.

Для Microsoft Windows Vista (не включая платформу IA64) и Microsoft Windows Server с кодовым названием Longhorn IA64 Edition платформа .NET Framework 3.0 является функцией операционной системы.

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

В следующей таблице перечислены требования к оборудованию для работы платформа .NET Framework 3.0.

	Требуется ЦП	Требуется ОЗУ
Минимальные	400 МГц	96 МБ
Рекомендуется	Процессор 1 ГГц или выше	256 МБ или более

Где получить распространяемый пакет платформа .NET Framework 3.0

Распространяемый пакет Microsoft платформа .NET Framework 3.0 можно скачать из Центра загрузки Microsoft Vista или с веб-сайта Microsoft клиентский компонент Центра обновления Windows.

Примечание Сайт Microsoft клиентский компонент Центра обновления Windows предлагает только официально выпущенную версию платформа .NET Framework 3.0; она не предлагает бета-версии.

Если вам нужно, чтобы пользователи устанавливали Microsoft платформа .NET Framework 3.0 из Интернета, не публикуйте распространяемый пакет в собственной сети. Вместо этого направляйте пользователей в Центр загрузки Microsoft Vista или на веб-сайт Microsoft клиентский компонент Центра обновления Windows.

Распространение платформа .NET Framework 3.0 с помощью проекта установки Visual Studio 2005

При развертывании приложений, созданных с помощью Visual Studio 2005 и требующих платформа .NET Framework 3.0, платформа .NET Framework необходимо установить на целевом компьютере перед установкой приложения. Вы можете включить платформа .NET Framework 3.0 в исполняемый файл установки, который создается с помощью проекта установки Visual Studio 2005. Если это нецелесообразно, пользователи могут установить платформа .NET Framework вручную, как описано далее.

При настройке проекта установки Visual Studio 2005 для установки Microsoft платформа .NET Framework 3.0 с приложением платформа .NET Framework 3.0 упаковается вместе с приложением. Условие запуска в программе установки приложения проверяет, whether.NET Framework 3.0 установлена, и при необходимости в процессе установки платформа .NET Framework перед установкой приложения. Microsoft платформа .NET Framework 3.0, в свою очередь, проверяет, установлена ли платформа whether.NET Framework 2.0. В противном случае процесс установки предложит пользователю установить более раннюю версию платформа .NET Framework.

Чтобы включить платформа .NET Framework 3.0 в процесс установки приложения, на компьютере, где создается проект установки, необходимо установить дополнительные расширения Visual Studio для платформа .NET Framework 3.0.

Определение установки расширений Visual Studio для платформа .NET Framework 3.0

В панель управления Windows щелкните Добавить или удалить программы.
В диалоговом окне Установка и удаление программ просмотрите список установленных в настоящее время программ для расширений Microsoft Visual Studio 2005 для платформа .NET Framework 3.0.

Если расширения Visual Studio 2005 для платформа .NET Framework 3.0 отсутствуют в списке, вы можете скачать и установить пакет расширений в составе средств разработки для WinFX, доступных на странице Microsoft Visual Studio Code Имя "Orcas" Community Technology Preview — Средства разработки для WinFX в Центре загрузки Майкрософт.

Убедившись, что на компьютере установлен пакет расширений Visual Studio для платформа .NET Framework 3.0, можно создать проект установки, включающий платформа .NET Framework 3.0.

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

В Visual Studio 2005 создайте новый проект установки, выполнив следующие действия.
1. В меню Файл выберите пункт Создать, а затем — Проект.
2. В разделе Другие типы проектов выберите Настройка и развертывание.
3. Присвойте проекту имя и нажмите кнопку ОК.
Добавьте выходные данные проекта, модули слияния, файлы и сборки.
В Обозреватель решений щелкните правой кнопкой мыши имя проекта и выберите пункт Свойства.

Откроется диалоговое окно Страницы свойств.
Щелкните Предварительные требования.
Установите флажок Создать программу установки для установки необходимых компонентов проверка.
В списке найдите Microsoft платформа .NET Framework 3.0, а затем выберите версию, подходящую для целевых платформ.
Укажите исходное расположение для необходимых компонентов.

Для расположения платформа .NET Framework 3.0 можно указать сайт загрузки Windows Vista или собственный сайт. В URL-адресе также можно указать компакт-диск, на котором распространяется ваше приложение.
Нажмите кнопку ОК.

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

В некоторых ситуациях автоматическая установка платформа .NET Framework 3.0 с приложением может оказаться нецелесообразной. В этом случае можно обязать пользователей установить платформу .NET Framework самостоятельно. Распространяемый компонент доступен из нескольких источников, как указано ранее в разделе Где получить распространяемый пакет the.NET Framework 3.0. Однако не следует предполагать, что пользователи вашего приложения знают, где его можно получить и как установить. В процессе установки дайте пользователям указания о том, как найти и установить .NET Framework.

Связывание распространяемого пакета в программе установки приложения

Если вы не хотите создавать проект установки Visual Studio или пользователи устанавливают платформа .NET Framework 3.0 вручную, вы можете связать процесс установки платформа .NET Framework 3.0 в рамках установки собственного приложения. Чтобы связать процесс установки платформа .NET Framework 3.0, можно запустить распространяемый компонент из командной строки и использовать следующий параметр командной строки автоматической установки:

/q /norestart

Распространение платформа .NET Framework 3.0 для веб-приложений

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

Обнаружение Microsoft платформа .NET Framework 3.0

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

Чтение разделов реестра

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

Имя раздела реестра Значение

Имя раздела реестра	Значение
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup`	Имя: `InstallSuccess` Тип — DWORD Данные: `1`
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform`	Имя: `Version` Тип: REG_SZ Данные: `.NET CLR 3.0.build number`

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup

Имя: InstallSuccess

Тип — DWORD

Данные: 1

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform

Имя: Version

Тип: REG_SZ

Данные: .NET CLR 3.0.build number

Чтение строки агента пользователя в Обозреватель Интернета

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

Примечание Для этого примера страницы требуется Обозреватель в Интернете.

<HTML>
  <HEAD>
    <TITLE>Test for .NET Framework 3.0</TITLE>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8" />
    <SCRIPT LANGUAGE="JavaScript">
    <!--
    var NETFX3RuntimeVersion = "3.0.50727";
    
    function window::onload()
    {
      if (HasRuntimeVersion(NETFX3RuntimeVersion))
      {
result.innerText = "This machine has the correct version of the .NET 
Framework 3.0 runtime: " + NETFX3RuntimeVersion + "."  + "\n\nThis 
machine's userAgent string is: " + navigator.userAgent + ".";
      } 
      else
      {
        document.write("The .NET Framework version 3.0 is not installed on this computer.<br/>"
+ "<a href='https://msdn.microsoft.com/windowsvista/default.aspx'>"
+ "Click here to get</a> .NET Framework 3.0 now.");      }
    }
    
    //
    // Retrieve the version from the user agent string and compare with specified version.
    //
    function HasRuntimeVersion(versionToCheck)
    {
      var userAgentString = navigator.userAgent.match(/.NET Framework 3.0 RunTime [0-9.]+/g);

      if (userAgentString != null)
      {
        var i;

        for (i = 0; i < userAgentString.length; ++i)
        {
          if (CompareVersions(GetVersion(versionToCheck), GetVersion(userAgentString[i])) <= 0)
            return true;
        }
      }

      return false;
    }

    //
    // Extract the numeric part of the version string.
    //
    function GetVersion(versionString)
    {
      var numericString = versionString.match(/([0-9]+)\.([0-9]+)\.([0-9]+)/i);
      return numericString.slice(1);
    }

    //
    // Compare the version strings by converting them to numeric format.
    //
    function CompareVersions(version1, version2)
    {
      for (i = 0; i < version1.length; ++i)
      {
        var number1 = new Number(version1[i]);
        var number2 = new Number(version2[i]);

        if (number1 < number2)
          return -1;

        if (number1 > number2)
          return 1;
      }

      return 0;
    }
    
    -->
    </SCRIPT>
  </HEAD>
  
  <BODY>
    <div id="result" />
  </BODY>
</HTML>

Если поиск строки "платформа .NET Framework версии 3.0" выполнен успешно, отображается следующее сообщение:

This machine has the correct version of the .NET Framework 3.0: 3.0.50727.
This machine's userAgent string is: Mozilla/4.0 (compatible; MSIE 6.0; 
Windows NT 5.1; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727; .NET CLR 
3.0.50727).

В противном случае появится следующее сообщение:

The .NET Framework version 3.0 is not installed on this computer.
Click here to get the .NET Framework 3.0 now.

Параметры командной строки для распространяемого компонента платформа .NET Framework 3.0

В следующей таблице перечислены параметры, которые можно включить при запуске программы установки распространяемых компонентов платформа .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe или Dotnet3setup.exe) из командной строки.

Параметр	Описание
`/q`	Подавляет весь пользовательский интерфейс. С помощью этого параметра нельзя указать файл .INI.
`/quiet`	Эквивалентно `/q`.
`/qb`	Отображает минимальный пользовательский интерфейс с отображением только хода выполнения.
`/passive`	Эквивалентно `/qb`.
`/uninstall`	Удаляет продукт.
`/remove`	Эквивалентно `/uninstall`.
`/f`	Восстанавливает все установленные компоненты платформа .NET Framework 3.0.
`/nopatch`	Указывает, что исправления не применяются и обходят проверку исправлений.
`/norollback`	Указывает, что при сбое компонента установки не выполняется откат.
`/norestart`	Указывает, что установщик не перезагрузит компьютер после завершения установки. Установщик распространяемого компонента возвращает ERROR_SUCCESS_REBOOT_REQUIRED (3010), если требуется перезагрузка.
`/?`	Отображает этот список параметров.

Коды ошибок для распространяемого компонента платформа .NET Framework 3.0

В следующей таблице перечислены коды ошибок, которые могут быть возвращены распространяемой программой установки платформа .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe или Dotnet3setup.exe). Коды ошибок одинаковы для всех версий установщика.

Код ошибки	Значение	Описание
`ERROR_SUCCESS`	0	Действие успешно завершено.
`ERROR_INSTALL_USEREXIT`	1602	Пользователь отменил установку.
`ERROR_INSTALL_FAILURE`	1603	Во время установки произошла неустранимая ошибка.
`ERROR_UNKNOWN_PRODUCT`	1605	Это действие допустимо только для продуктов, установленных в данный момент.
`ERROR_PATCH_PACKAGE_INVALID`	1636	Не удалось открыть пакет исправлений или исправление не применимо к платформа .NET Framework 3.0.
`ERROR_INVALID_COMMAND_LINE`	1639	Недопустимый аргумент командной строки.
`ERROR_SUCCESS_REBOOT_INITIATED`	1641	Установщик инициировал перезагрузку. Это указывает на успешное выполнение, и установка продолжится после перезапуска. (Перезагрузка не выполняется, `/norestart` если указан параметр.)
`ERROR_PATCH_PACKAGE_REJECTED`	1643	Пакет исправлений не разрешен системной политикой.
`ERROR_SUCCESS_REBOOT_REQUIRED`	3010	Для завершения установки необходима перезагрузка. Сообщение указывает на успешное завершение действия.

Поделиться через