Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Se você usar o IIS (Serviços de Informações da Internet) no Windows Server e sua implantação contiver um tipo de arquivo que o Windows não reconhece, como um arquivo do Microsoft Word, o IIS se recusará a transmitir esse arquivo e sua implantação não terá êxito.
Além disso, alguns servidores Web e software de aplicativos Web, como ASP.NET, contêm uma lista de arquivos e tipos de arquivo que você não pode baixar. Por exemplo, ASP.NET impede o download de todos os arquivos Web.config . Esses arquivos podem conter informações confidenciais, como nomes de usuário e senhas.
Embora essa restrição não deva causar problemas para baixar os principais arquivos ClickOnce, como manifestos e assemblies, essa restrição pode impedir que você baixe arquivos de dados incluídos como parte do seu aplicativo ClickOnce. No ASP.NET, você pode resolver esse erro removendo o manipulador que proíbe o download de tais arquivos do gerenciador de configuração do IIS. Consulte a documentação do servidor IIS para obter detalhes adicionais.
Alguns servidores Web podem bloquear arquivos com extensões como .dll, .confige .mdf. Os aplicativos baseados no Windows geralmente incluem arquivos com algumas dessas extensões. Se um usuário tentar executar um aplicativo ClickOnce que acessa um arquivo bloqueado em um servidor Web, ocorrerá um erro. Em vez de desbloquear todas as extensões de arquivo, ClickOnce publica cada arquivo de aplicativo com uma extensão de arquivo .deploy por padrão. Portanto, o administrador só precisa configurar o servidor Web para desbloquear as seguintes três extensões de arquivo:
.aplicação
.manifest
.implantar
No entanto, você pode desabilitar essa opção desmarcando a opção Usar extensão de arquivo ".deploy" na caixa de diálogo Opções de publicação, caso em que você deve configurar o servidor Web para desbloquear todas as extensões de arquivo usadas no aplicativo.
Você terá que configurar .manifest, .application e .deploy, por exemplo, se estiver usando o IIS onde não instalou o .NET Framework ou se estiver usando outro servidor Web (por exemplo, Apache).
ClickOnce e Secure Sockets Layer (SSL)
Um aplicativo ClickOnce funcionará bem sobre SSL, exceto quando o navegador gera um prompt sobre o certificado SSL. O prompt pode ser gerado quando há algo errado com o certificado, como quando os nomes dos sites não correspondem ou o certificado expirou. Para fazer com que o ClickOnce funcione em uma conexão SSL, verifique se o certificado está up-to-date e se os dados do certificado correspondem aos dados do site.
ClickOnce e autenticação de proxy
ClickOnce fornece suporte para autenticação de proxy integrada do Windows a partir do .NET Framework 3.5. Não são necessárias diretivas machine.config específicas. ClickOnce não fornece suporte para outros protocolos de autenticação, como Basic ou Digest.
Você também pode aplicar um hotfix para o .NET Framework 2.0 para habilitar esse recurso. Para obter mais informações, consulte CORREÇÃO: Mensagem de erro ao tentar instalar um aplicativo ClickOnce que você criou no .NET Framework 2.0 em um computador cliente que está configurado para usar um servidor proxy: "Autenticação de proxy necessária".
Para obter mais informações, consulte <elemento defaultProxy> (configurações de rede).
ClickOnce e compatibilidade com navegadores da Web
Atualmente, as instalações do ClickOnce serão iniciadas somente se a URL para o manifesto de implantação for aberta usando o navegador. Uma implantação cuja URL é iniciada a partir de outro aplicativo, como o Microsoft Office Outlook, será iniciada com êxito somente se o Internet Explorer estiver definido como o navegador da Web padrão.
Observação
O Mozilla Firefox é suportado se o provedor de implantação não estiver em branco ou se a extensão Microsoft .NET Framework Assistant estiver instalada. Esta extensão é fornecida com o .NET Framework 3.5 SP1. Para suporte a XBAP, o plug-in NPWPF é ativado quando necessário.
Ativar aplicativos ClickOnce por meio de scripts do navegador
Se você desenvolveu uma página da Web personalizada que inicia um aplicativo ClickOnce usando scripts ativos, você pode achar que o aplicativo não será iniciado em algumas máquinas. O navegador contém uma configuração como Solicitação automática de downloads de arquivos, que afeta esse comportamento. Essa configuração do navegador normalmente está listada abaixo da categoria Downloads e é ativada por padrão. Quando essa configuração é desabilitada, qualquer tentativa de ativar um aplicativo ClickOnce programaticamente (por exemplo, atribuindo sua URL à document.location propriedade) será bloqueada. Nessa circunstância, os usuários podem iniciar aplicativos somente por meio de um download iniciado pelo usuário, por exemplo, clicando em um hiperlink definido para a URL do aplicativo.
Problemas adicionais de configuração do servidor
Permissões de administrador necessárias
Você deve ter permissões de Administrador no servidor de destino se estiver publicando com HTTP. O IIS requer esse nível de permissões. Se não estiveres a publicar usando HTTP, só precisarás de permissão de gravação no caminho de destino.
Problemas de autenticação do servidor
Ao publicar em um servidor remoto que tenha o "Acesso Anônimo" desativado, você receberá o seguinte aviso:
"The files could not be downloaded from http://<remoteserver>/<myapplication>/. The remote server returned an error: (401) Unauthorized."
Observação
Você pode fazer a autenticação NTLM (desafio-resposta NT) funcionar se o site solicitar credenciais diferentes das credenciais padrão e, na caixa de diálogo de segurança, clique em OK quando for solicitado se deseja salvar as credenciais fornecidas para sessões futuras. No entanto, essa solução alternativa não funcionará para autenticação básica.
Usar servidores Web de terceiros
Se você estiver implantando um aplicativo ClickOnce de um servidor Web diferente do IIS, poderá ter um problema se o servidor estiver retornando o tipo de conteúdo incorreto para os principais arquivos ClickOnce, como o manifesto de implantação e o manifesto do aplicativo. Para resolver esse problema, consulte a documentação da Ajuda do servidor Web sobre como adicionar novos tipos de conteúdo ao servidor e certifique-se de que todos os mapeamentos de extensão de nome de arquivo listados na tabela a seguir estão no lugar.
| Extensão de nome de arquivo | Tipo de conteúdo |
|---|---|
.application |
application/x-ms-application |
.manifest |
application/x-ms-manifest |
.deploy |
application/octet-stream |
.msu |
application/octet-stream |
.msp |
application/octet-stream |
ClickOnce e unidades mapeadas
Se você usar o Visual Studio para publicar um aplicativo ClickOnce, não poderá especificar uma unidade mapeada como o local de instalação. No entanto, você pode modificar o aplicativo ClickOnce para instalar a partir de uma unidade mapeada usando o gerador de manifesto e editor (Mage.exe e MageUI.exe). Para obter mais informações, consulte Mage.exe (Ferramenta de Geração e Edição de Manifesto) e MageUI.exe (Ferramenta de Geração e Edição de Manifesto, Cliente Gráfico).
Protocolo FTP não suportado para instalação de aplicações
O ClickOnce suporta a instalação de aplicações a partir de qualquer servidor Web HTTP 1.1 ou servidor de ficheiros. FTP, o File Transfer Protocol, não é suportado para a instalação de aplicativos. Você pode usar FTP para publicar somente aplicativos. A tabela a seguir resume essas diferenças:
| Tipo de URL | Description |
|---|---|
| ftp:// | Você pode publicar um aplicativo ClickOnce usando este protocolo. |
| http:// | Você pode instalar um aplicativo ClickOnce usando este protocolo. |
| https:// | Você pode instalar um aplicativo ClickOnce usando este protocolo. |
| file:// | Você pode instalar um aplicativo ClickOnce usando este protocolo. |
Windows Firewall
Por padrão, o Windows habilita o Firewall do Windows. Se estiver a desenvolver a sua aplicação num computador com o Windows instalado, ainda poderá publicar e executar aplicações ClickOnce a partir do servidor local que está a executar o IIS. No entanto, você não pode acessar esse servidor que está executando o IIS de outro computador, a menos que abra o Firewall do Windows. Consulte a Ajuda do Windows para obter instruções sobre como gerir a Firewall do Windows.
Windows Server: Habilitar extensões de servidor do FrontPage
As Extensões de Servidor do FrontPage da Microsoft são necessárias para publicar aplicativos em um servidor Web do Windows que usa HTTP.
Por padrão, o Windows Server não tem as Extensões de Servidor do FrontPage instaladas. Se você quiser usar o Visual Studio para publicar em um servidor Web do Windows Server que usa HTTP com extensões de servidor do FrontPage, você deve instalar as extensões de servidor do FrontPage primeiro. Você pode executar a instalação usando a ferramenta de administração Gerenciar seu servidor no Windows Server.
Windows Server: Tipos de conteúdo bloqueados
O IIS no Windows Server 2003 bloqueia todos os tipos de arquivo, exceto determinados tipos de conteúdo conhecidos (por exemplo, .htm, .html, .txte assim por diante). Para habilitar a implantação de aplicativos ClickOnce usando esse servidor, você precisa alterar as configurações do IIS para permitir o download de arquivos do tipo .application, .manifest e quaisquer outros tipos de arquivo personalizados usados pelo seu aplicativo.
Se você implantar usando um servidor IIS, execute inetmgr.exe e adicione novos tipos de arquivo para a página da Web padrão:
Para as extensões .application e .manifest , o tipo MIME deve ser "application/x-ms-application". Para outros tipos de arquivo, o tipo MIME deve ser "application/octet-stream".
Se você criar um tipo MIME com a extensão "<em>" e o tipo MIME "application/octet-stream", ele permitirá que arquivos do tipo de arquivo desbloqueado sejam baixados. (No entanto, tipos de arquivo bloqueados, como *.aspx e *.asmx , não podem ser baixados.)
Para obter instruções específicas sobre como configurar tipos MIME no Windows Server, consulte Como adicionar um tipo MIME a um site ou aplicativo.
Mapeamentos de tipo de conteúdo
Ao publicar por HTTP, o tipo de conteúdo (também conhecido como tipo MIME) para o arquivo .application deve ser "application/x-ms-application". Se você tiver o .NET Framework 2.0 instalado no servidor, isso será definido para você automaticamente. Se isso não estiver instalado, você precisará criar uma associação de tipo MIME para o vroot do aplicativo ClickOnce (ou servidor inteiro).
Se você implantar usando um servidor IIS, execute inetmgr.EXE e adicione um novo tipo de conteúdo de "application/x-ms-application" para a extensão .application .
Problemas de compressão HTTP
Com o ClickOnce, você pode realizar downloads que usam compactação HTTP, uma tecnologia de servidor Web que usa o algoritmo GZIP para compactar um fluxo de dados antes de enviar o fluxo para o cliente. O cliente — neste caso, ClickOnce — descompacta o fluxo antes de ler os arquivos.
Se você estiver usando o IIS, poderá habilitar facilmente a compactação HTTP. No entanto, quando você habilita a compactação HTTP, ela só é habilitada para determinados tipos de arquivo, ou seja, arquivos HTML e de texto. Para habilitar a compactação para assemblies (.dll), XML (.xml), manifestos de implantação (.application) e manifestos de aplicativo (.manifest), você deve adicionar esses tipos de arquivo à lista de tipos para o IIS compactar. Até que você adicione os tipos de arquivo à sua implantação, somente arquivos de texto e HTML serão compactados.
Para obter instruções detalhadas sobre o IIS, consulte Como especificar tipos de documentos adicionais para compactação HTTP.