H2Reg & Instaladores

Aqui estão algumas dicas para executar o H2Reg.exe de vários instaladores populares.

Instalador INNO 

INNO um instalador livre popular. Usamos o instalador INNO para empacotar o download H2Reg. Durante a instalação, a Instalação registra nossos arquivos de documento H2 sob o espaço de nome "hw.H2Reg". Registra um Filtro em "hw.h2reg" e executa até mesmo um plug-in de "hw.h2reg" na coleção de ajuda VS .NET "ms.vscc" (VS 7.0) ou "ms.vscc.2003" ( VS 7.1), ou "ms.vsipcc.v80" (VS 2005), ou "ms.vsipcc.v90" (VS 2008) o que quer que seja encontrado. Observe que o filtro aparece no MS.VSCC, uma vez que temos conectado a essa coleção. Em seguida, quando você desinstalar, ele cancela o registro do que foi registrado. A documentação H2Reg também vem no formato de arquivo .CHM.
Incluímos nosso arquivo de configuração INNO (h2reg_setup_script.iss) para ajudá-lo a começar. 
INNO site de configuração: http://www.jrsoftware.org/isinfo.htm

Clique aqui para um exemplo de script instalador INNO chamando H2Reg.exe. Obrigado Thomas Kux (www.wxwindows.org).

Wise para Windows 

Wise Instalador 4.02 edição profissional (http://www.wise.com)
Tim Hitchings de Infragística tenha gentilmente escrito algumas instruções para ajudar os usuários do Wise.
Comentarios de Tim:
  1. No mesmo local de sua coleção e arquivos de ajuda, instale um arquivo h2Reg_CmdFile.ini para cada coleção que você está instalando.
  2. No mesmo local instalar uma cópia de H2Reg.exe e H2Reg.ini.
  3. Usando a seção 'MSI Script' do Wise, escolha a guia 'Execute Deferred'.
  4. Após o item de instalação 'InstallFiles' adicionar uma condição 'Se não instalado'.
  5. No bloco de condições "Se não instalado", adicione uma ação "Execute Program From Destination".
  6. Defina o diretório de trabalho das ações para o local do H2Reg.exe e o EXE e linha de comando para algo como '[WORKDIR] H2Reg.exe -Q -R "cmdfile = H2Reg_YourProduct_HELP.ini"'
  7. Adicionar uma ação para cada arquivo ini.
  8. Para criar um conjunto de ações que serão chamadas durante a desinstalação adicione um bloco de condição antes do item de seqüência 'RemoveFiles'.
  9. A condição deve ser 'REMOVE ~ = "ALL"', o que fará com que os itens dentro do bloco sejam executados somente durante uma desinstalação.
  10. Adicione o mesmo tipo de ações que foram criadas acima para a instalação.

NDOC

NDoc e um utilitário gratuito para a geração de documentação de biblioteca de classes a partir de assemblies .NET e os arquivos de documentação XML gerados pelo compilador C #. NDoc add-on documenters para gerar documentação em vários formatos diferentes, incluindo o formato MSDN-estilo HTML Help (.chm), o Visual Studio.NET ajuda formato (HTML Help 2), e MSDN-online estilo páginas da Web.

O seguinte artigo por Fons Sonnemans descreve como integrar NDoc HTML Help 2 em Visual Studio.NET com a ajuda de H2Reg.
http://www.reflectionit.nl/NDoc.aspx

O site do NDOC descreve como configurar o NDOC para gerar o script H2Reg.
http://ndoc.sourceforge.net/content/vsnet-deploying.htm

West Wind Html Ajuda Builder 4.0 (beta 2)

Rick Strahl da West Wind Technologies descreve
Construindo a documentação do MS help 2 enquanto estiver usando o H2Reg.exe para registrar os arquivos de ajuda.

Doc-O-Matic

Doc-O-Matic é outra ferramenta de autoria popular que usa H2Reg
http://www.doc-o-matic.com/art_help2plugin.html

MSI (Instalador Microsoft)

Se você criar um .MSI instalar pacote usando dizer Visual Studio 2005 (um projeto de instalação), então você pode especificar um "ações personalizadas" para executar H2Reg.exe na instalação e desinstalação. Basta lembrar que H2Reg.exe agora está marcado para ser executado no modo elevado, portanto a execução pode falhar porque a representação MSI está ativada por padrão. A correção mais simples é criar um arquivo Setup.exe para iniciar seu arquivo .MSI. Setup.exe será executado em modo elevado e assim será o .MSI para que qualquer auxiliares elevados (shuch como H2Reg.exe) também será executado corretamente.