H2Reg & Instaladores

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

Instalador INNO 

INNO um instalador gratuito popular. Utilizamos o instalador do INNO para empacotar o download do H2Reg. Durante a instalação, a instalação registra nossos arquivos de documento H2 no espaço de nome "hw.H2Reg". Ele registra um filtro em "hw.h2reg" e até mesmo executa um plug-in de "hw.h2reg" na coleção de ajuda do 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 for encontrado. Observe que o filtro aparece no MS.VSCC, já que estamos conectados a essa coleção. Então, quando você desinstala, ele não registra o que foi registrado. A documentação H2Reg também vem no formato de arquivo .CHM.
Nós incluímos nosso arquivo de instalaçã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 obter um exemplo de script de instalação do INNO chamando H2Reg.exe. Obrigado Thomas Kux (www.wxwindows.org).

Wisea para Windows 

Wise Installer 4.02 Professional Edition (http://www.wise.com)
Tim Hitchings da Infragistics escreveu gentilmente algumas instruções para ajudar os usuários Wise.
Comentarios do Tim:
  1. No mesmo local da 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, instale uma cópia de H2Reg.exe e H2Reg.ini.
  3. Usando a seção 'MSI Script' do Wise, escolha a aba 'Executar Diferido'.
  4. Após o item de seqüência 'InstallFiles', adicione uma condição 'Se NÃO instalada'.
  5. Naquele bloco de condição "Se NÃO INSTALADO", adicione uma ação ‘Executar Programa do Destino’.
  6. Defina o diretório de trabalho das ações para a localização de H2Reg.exe e o EXE e a Linha de comando para algo como '[WORKDIR] H2Reg.exe -Q -R "cmdfile = H2Reg_YourProduct_HELP.ini"
  7. Adicione 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 'REMOVER ~ = "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 é um utilitário gratuito para gerar documentação da biblioteca de classes dos assemblies .NET e os arquivos de documentação XML gerados pelo compilador C #. Documentadores de complementos de usuários do NDoc para gerar documentação em vários formatos diferentes, incluindo o formato de Ajuda HTML em formato MSDN (.chm), o formato de Ajuda do Visual Studio .NET (Ajuda HTML 2) e as páginas da Web em estilo online MSDN.

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

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

West Wind Html Help Builder 4.0 (beta 2)

Rick Strahl da West Wind Technologies descreve
criando MS ajuda para documentação enquanto usa 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 pacote de instalação .MSI usando o Visual Studio 2005 (um projeto de instalação), você pode especificar uma "Ação personalizada" para executar H2Reg.exe na instalação e desinstalação. Basta lembrar que H2Reg.exe agora está marcado para ser executado em modo elevado, de modo que a execução pode falhar porque a personificação de MSI está ativada por padrão. A correção mais simples é criar um arquivo Setup.exe para iniciar seu arquivo .MSI. O Setup.exe será executado em modo elevado e, assim, o .MSI, portanto, qualquer auxiliar elevado (assim como H2Reg.exe) também executará corretamente.