Guia de implantação do Microsoft .NET Framework 3.0

Microsoft Corporation

Julho de 2006

Sumário

Resumo
Introdução
Requisitos de instalação
   Requisitos de software
   Requisitos de hardware
Onde obter o pacote redistribuível do .NET Framework 3.0
Redistribuindo .NET Framework 3.0 usando um projeto de instalação do Visual Studio 2005
Fazer com que os usuários instalem o .NET Framework manualmente
Encadeando o pacote redistribuível na configuração do aplicativo
Redistribuindo .NET Framework 3.0 para aplicativos Web
Detectando o Microsoft .NET Framework 3.0
   Lendo chaves do Registro
   Lendo a cadeia de caracteres do agente de usuário na Internet Explorer
Opções de linha de comando para o .NET Framework 3.0 Redistribuível
Códigos de erro para o .NET Framework 3.0 Redistribuível

Resumo

Este artigo descreve como implantar aplicativos do Microsoft .NET Framework 3.0 com Dotnetfx3.exe, o pacote redistribuível .NET Framework 3.0. (10 páginas impressas)

Nota Esta documentação pode incluir informações para cenários que discutem a distribuição, mas a documentação não concede a você nenhum direito de usar ou distribuir qualquer parte dos Componentes. Seu uso dos Componentes está sujeito ao contrato de licença para os Componentes. Examine o contrato de licença componentes para entender seus direitos e as condições de uso.

Introdução

O Microsoft.NET Framework 3.0 fornece um instalador redistribuível que contém associações .NET Framework 2.0 às APIs necessárias do Windows Vista para executar aplicativos .NET Framework 3.0.

O pacote redistribuível .NET Framework 3.0 está disponível como um arquivo executável autônomo. O nome do arquivo depende do tipo da plataforma de destino. Para plataformas de 32 bits, o arquivo é nomeado Dotnetfx3.exe. Para plataformas de 64 bits, o arquivo é nomeado Dotnetfx3_x64.exe. Você também pode implantar um pequeno pacote redistribuível chamado Dotnet3setup.exe que baixa os componentes necessários durante a instalação.

Nota O suporte a IA64 no .NET Framework 3.0 é limitado ao código do Microsoft Windows Server chamado "Longhorn". Longhorn já inclui .NET Framework 3.0, portanto, nenhum pacote redistribuível é necessário.

Você pode iniciar e instalar manualmente o redistribuível em um computador ou ele pode ser iniciado e instalado como parte do programa de instalação de um aplicativo .NET Framework 3.0.

Nota Os privilégios de administrador são necessários para instalar o .NET Framework 3.0.

Requisitos de instalação

Esta seção descreve os requisitos de software e hardware para um computador em que o pacote redistribuível do Microsoft .NET Framework 3.0 deve ser instalado. Se os requisitos mínimos não forem atendidos, Dotnetfx3.exe bloqueará a instalação do pacote redistribuível.

Requisitos de software

Para instalar o Microsoft .NET Framework 3.0, um dos seguintes sistemas operacionais deve ser instalado no computador de destino:

• Microsoft Windows XP Home ou Microsoft Windows XP Professional, ambos com Service Pack 2 ou posterior.
• Família do Microsoft Windows Server 2003 com Service Pack 1 ou posterior.

Para o Microsoft Windows Vista (sem incluir a plataforma IA64) e o Código do Microsoft Windows Server denominado "Longhorn" IA64 Edition, .NET Framework 3.0 é um recurso do sistema operacional.

Requisitos de hardware

A tabela a seguir lista os requisitos de hardware para executar .NET Framework 3.0.

Onde obter o pacote redistribuível do .NET Framework 3.0

Você pode baixar o pacote redistribuível do Microsoft .NET Framework 3.0 no Centro de Download do Microsoft Vista ou no site do Microsoft Windows Update.

Nota O site do Microsoft Windows Update oferece apenas a versão lançada oficialmente do .NET Framework 3.0; ele não oferece versões beta.

Se você precisar que os usuários instalem o Microsoft .NET Framework 3.0 da Internet, não poste o pacote redistribuível em sua própria rede. Em vez disso, direcione os usuários para o Centro de Download do Microsoft Vista ou o site do Microsoft Windows Update.

Redistribuindo .NET Framework 3.0 usando um projeto de instalação do Visual Studio 2005

Quando você implanta aplicativos criados com o Visual Studio 2005 e que exigem .NET Framework 3.0, o .NET Framework deve ser instalado no computador de destino antes que seu aplicativo seja instalado. Você pode incluir o .NET Framework 3.0 em um arquivo executável de instalação criado usando um projeto de instalação do Visual Studio 2005. Se isso não for prático, você poderá fazer com que os usuários instalem o .NET Framework manualmente, conforme descrito posteriormente.

Quando você configura um projeto de instalação do Visual Studio 2005 para instalar o Microsoft .NET Framework 3.0 com seu aplicativo, o .NET Framework 3.0 é empacotado com seu aplicativo. Uma condição de inicialização nas verificações de instalação do aplicativo whether.NET Framework 3.0 está instalada e, se necessário, o processo de instalação instala o .NET Framework antes de instalar seu aplicativo. Por sua vez, o Microsoft .NET Framework 3.0 verifica se whether.NET Framework 2.0 está instalado. Caso contrário, o processo de instalação solicitará que o usuário instale a versão anterior do .NET Framework também.

Para incluir .NET Framework 3.0 com o processo de instalação do aplicativo, as Extensões opcionais do Visual Studio para .NET Framework 3.0 devem ser instaladas no computador em que você cria o projeto de instalação.

Para determinar se as Extensões do Visual Studio para .NET Framework 3.0 estão instaladas

1. Na Painel de Controle do Windows, clique em Adicionar ou Remover Programas.
2. Na caixa de diálogo Adicionar ou Remover Programas, examine a lista Programas instalados no momento para Extensões do Microsoft Visual Studio 2005 para .NET Framework 3.0.

Se as Extensões do Visual Studio 2005 para .NET Framework 3.0 não estiverem listadas, você poderá baixar e instalar o pacote de extensões como parte das Ferramentas de Desenvolvimento para WinFX, disponíveis na página Microsoft Visual Studio Code Nome "Orcas" Community Technology Preview – Ferramentas de Desenvolvimento para WinFX no Centro de Download da Microsoft.

Quando tiver certeza de que tem o pacote Extensões do Visual Studio para .NET Framework 3.0 instalado no computador, você pode criar um projeto de instalação que inclua o .NET Framework 3.0.

Para incluir o .NET Framework 3.0 com um projeto de instalação

1. No Visual Studio 2005, crie um novo projeto de instalação seguindo estas etapas:

   1. No menu Arquivo , clique em Novo e, em seguida, clique em Projeto.
   2. Em Outros Tipos de Projeto, selecione Instalação e Implantação.
   3. Nomeie seu projeto e clique em OK.

2. Adicione a saída do projeto, os módulos de mesclagem, o arquivo e os assemblies.

3. Em Gerenciador de Soluções, clique com o botão direito do mouse no nome do projeto e clique em Propriedades.

   A caixa de diálogo Páginas da Propriedade é exibida.

4. Clique em Pré-requisitos.

5. Selecione a caixa Criar programa de instalação para instalar componentes de pré-requisito marcar.

6. Na lista, localize o Microsoft .NET Framework 3.0 e selecione a versão apropriada para as plataformas de destino.

7. Especifique o local de origem para os pré-requisitos.

   Para o local do .NET Framework 3.0, você pode especificar o site de Download do Windows Vista ou um site próprio. A URL também pode especificar um CD no qual seu próprio aplicativo está sendo distribuído.

8. Clique em OK.

Fazer com que os usuários instalem o .NET Framework manualmente

Em algumas situações, pode ser impraticável instalar automaticamente o .NET Framework 3.0 com seu aplicativo. Nesse caso, você pode fazer os usuários instalarem o .NET Framework por conta própria. O redistribuível está disponível em várias fontes, conforme observado anteriormente na seção Where to Obtain the.NET Framework 3.0 Redistributable Package. No entanto, você não deve assumir que os usuários do seu aplicativo saibam onde obtê-lo ou como instalá-lo. Em seu processo de instalação, forneça instruções de como os usuários devem localizar e instalar o .NET Framework.

Encadeando o pacote redistribuível na configuração do aplicativo

Se você não quiser criar um projeto de instalação do Visual Studio ou fazer com que os usuários instalem o .NET Framework 3.0 manualmente, você poderá encadear o processo de instalação do .NET Framework 3.0 como parte de sua própria configuração de aplicativo. Para encadear o processo de instalação do .NET Framework 3.0, você pode executar o redistribuível na linha de comando e usar a seguinte opção de linha de comando de instalação silenciosa:

/q /norestart

Redistribuindo .NET Framework 3.0 para aplicativos Web

Em aplicativos baseados na Web que dependem .NET Framework recursos 3.0, o .NET Framework pode precisar ser baixado e instalado no computador do usuário. Você pode determinar se .NET Framework 3.0 está instalado no computador do usuário consultando a cadeia de caracteres usuário-agente no cabeçalho do navegador. Se a versão correta do .NET Framework não estiver instalada, você poderá direcionar os usuários para o Centro de Download do .NET Framework 3.0 para obter o pacote .NET Framework 3.0.

Detectando o Microsoft .NET Framework 3.0

Você pode detectar se o .NET Framework 3.0 está instalado lendo uma chave do Registro e consultando a cadeia de caracteres de agente do usuário na Internet Explorer.

Lendo chaves do Registro

O instalador do .NET Framework 3.0 grava chaves do Registro quando a instalação é bem-sucedida. Você pode testar whether.NET Framework 3.0 está instalado verificando as chaves do Registro listadas na tabela a seguir.

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

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

Lendo a cadeia de caracteres do agente de usuário na Internet Explorer

Quando .NET Framework 3.0 é instalado em um computador, o número de versão .NET Framework 3.0 aparece como parte da cadeia de caracteres de agente do usuário relatada nos cabeçalhos do navegador. O exemplo a seguir mostra uma página de exemplo que usa JavaScript para detectar e relatar whether.NET Framework 3.0 está instalado.

Nota Esta página de exemplo requer Explorer da Internet.

<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>

Se a pesquisa da cadeia de caracteres ".NET Framework versão 3.0" for bem-sucedida, a seguinte mensagem será exibida:

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).

Caso contrário, a seguinte mensagem será exibida:

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

Opções de linha de comando para o .NET Framework 3.0 Redistribuível

A tabela a seguir lista as opções que você pode incluir ao executar o programa de instalação redistribuível do .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe ou Dotnet3setup.exe) na linha de comando.

/q

/quiet

/qb

/passive

/uninstall

/remove

/f

/nopatch

/norollback

/norestart

/?

Códigos de erro do .NET Framework 3.0 Redistribuível

A tabela a seguir lista os códigos de erro que podem ser retornados pelo programa de instalação redistribuível do .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe ou Dotnet3setup.exe). Os códigos de erro são os mesmos para todas as versões do instalador.

ERROR_SUCCESS

ERROR_INSTALL_USEREXIT

ERROR_INSTALL_FAILURE

ERROR_UNKNOWN_PRODUCT

ERROR_PATCH_PACKAGE_INVALID

ERROR_INVALID_COMMAND_LINE

ERROR_SUCCESS_REBOOT_INITIATED

ERROR_PATCH_PACKAGE_REJECTED

ERROR_SUCCESS_REBOOT_REQUIRED