H2Reg Hilfe

Original: http://kb.helpwaregroup.com/product-h2reg/h2reg-faq

Fehlerbehebung
Einige typische Probleme bei der Registrierung finden wir mit MS Help 2.
TOC verschwindet. Registrierung funktioniert nur auf dev Maschinen
Sammlungsebene .Hx? Dateien dürfen keine Referenz auf eine DTD-Datei.
Der Kunde gewohnt haben VSHIK installiert und somit gewohnt haben, die DTD-Dateien.

Siehe H2 Sammlung Tutorial – 3.6 fügen Sie nicht die DTD

MSI & Korruption
Leider ist es passiert. MSI (MS Installer) kann oben schrauben und stoppen Sie den Kunden von der Reparatur / Deinstallation / Neuinstallation von Teilen des VS. Obwohl nicht ein H2Reg Problem eine beschädigte VS Installation H2 Registration nicht mehr richtig funktioniert. Oft ist der einzige Weg nach vorne ist, VS oder den Hilfe-2 Motor mit Gewalt zu entfernen und neu zu installieren VS.

Siehe MSHelpWiki: Visual Studio 7.x Installationsprobleme

H2Reg gibt ein „von einem anderen Prozess gesperrt“ Fehler.
Die H2-Registrierung API-Aufrufe nur eine Sache zu tun in einer Zeit auf einem Windows-System.
Jedes Mal, wenn Sie etwas zu registrieren, die Anrufe
1. Sperren (Start H2 Transaktion)
2. Führen Sie eine oder mehrere Anmeldungen
3. Entriegeln (End H2 Transaktion)

Probleme treten auf, wenn eine andere Windows-Anwendung versucht, eine Registrierung Anruf während Schritt 2 durchführen In diesem Fall Anwendungen wie H2Reg und FAR wird immer wieder versuchen, bis sie letztendlich Time-out mit einer Nachricht „von einem anderen Prozess gesperrt“.

Wir finden, dieses Problem in der Regel tritt auf, wenn Sie Ihren Installateur läuft H2Reg.exe in „NoWait Mode“ oder versucht, mehr als ein Programm (das macht H2-API-Aufrufe) gleichzeitig ausführen. Die Lösung wird zwangsläufig Ihre Installer eingestellt H2Reg.exe in ausführen „Run und warten mode“. Löschen Dieser Fehler kann ein Neustart erforderlich ist.

Ein weiterer Fehler „von einem anderen Prozess gesperrt“
H2 API kann sich verwirrt und auch nach einem Neustart nicht gesperrten Dateien freigeben: siehe H2 Beiträge

Verschwinden TOC
Einer unserer Kunden berichtete die verschwinden TOC Problem könnte durch die Registrierung eine Sammlung mit einem leeren TOC unter VS 2002 verursacht werden (sie gesteckt anderen Sammlungen in dieser Sammlung). Sie fanden heraus, dass die Installation von .NET Framework 1.1 SDK aktualisiert die Hilfe von V2.1 zu V2.2 und behebt das Problem. Offensichtlich Help 2.2, die normalerweise von VS 2003 installiert ist stabiler. Siehe auch H2 Registrierung Hilfe

Einige Attribute, erklärte ich nicht arbeiten
In der Dokumentation H2Reg Tim Grantham aus Themo nahm einen ungewöhnlichen Problem. Index.htm verwendet eine HTML-Kommentar in der XML-Dateninsel. Obwohl der Compiler ermöglicht diese Syntax, ist der Effekt, dass diese Attribute mit Namen mehr als einmal verwendet werden effektiv neutralisiert (als ob sie nie erklärt worden war). Also bitte unterlassen Sie HTML-Kommentare in Ihren XML-Dateninseln. Das Problem wurde in VS 2003 entdeckt und ist zu dem MS Hilfeteam berichtet.

<xml>

<!– VS Studio Attributes –>
<MSHelp:Attr Name=“Information Type“ Value=“Orientation“/>
<MSHelp:Attr Name=“Information Type“ Value=“Reference“/>
<MSHelp:Attr Name=“DocSet“ Value=“Visual Basic“/>
<MSHelp:Attr Name=“DocSet“ Value=“Visual Studio“/>
<MSHelp:Attr Name=“TargetOS“ Value=“Windows“/>
<MSHelp:Attr Name=“Locale“ Value=“kbEnglish“/>
<MSHelp:Attr Name=“LinkGroup“ Value=“GettingStarted“/>
</xml>

Kein DExplore automatische Erkennung merge unter VS 2005 Beta 2
Achten Sie auf diese. Unter VS 2005 Beta 2 nur, müssen Sie eine Zusammenführung zu zwingen, so dass Sie Ihre Sammlung kann gesehen werden. Die meisten von uns sind abhängig von DExplorer Durchführen einer automatischen Erkennung / zusammenführen, nachdem wir registrieren unserer Sammlung. VS 2005 RTM (Release to Manufacturing) Version ist OK und wird auto merge. Siehe FAQ für mehr.

VS 2005 – Wo ist mein TOC?
Uns ist aufgefallen, dass unter VS 2005 RTM unserem Inhaltsverzeichnis nicht (Merge) in der Sammlung TOC VS 2005 anzuzeigen. Naja, eigentlich die Einführung Seite dargestellt OK im Inhaltsverzeichnis, aber keine anderen Seiten. Bei näherem Hinsehen zeigte sich, dass nur die Einführung Seite hatte eine volle Ergänzung der XML-Dateninsel-Elemente. Nach dem Hinzufügen dieser XML-Tags zu den anderen Seiten, richtig erschienen alle H2Reg Hilfethemen in der TOC VS 2005. Offensichtlich VS 8 ist wählerisch Attribute. Dies ist der Grund für die H2Reg v1.4.4 kleines Update.

Hier ist der XML-Dateninsel wir in der Kopfzeile jeder Thema unserer Hilfe gelegt. Offensichtlich müssen die beiden Titel Elemente für jedes Thema angepasst werden und man wird nicht brauchen unsere Helpware Artikel Attribut:

<xml>
<MSHelp:TOCTitle Title=“H2Reg Template“/>
<MSHelp:RLTitle Title=“H2Reg Template“/>
<MSHelp:Attr Name=“helpware“ Value=“h2reg“/>
<MSHelp:Keyword Index=“F“ Term=“VS.Ambient“/>
<MSHelp:Attr Name=“Information Type“ Value=“Orientation“/>
<MSHelp:Attr Name=“Information Type“ Value=“Reference“/>
<MSHelp:Attr Name=“DocSet“ Value=“Visual Basic“/>
<MSHelp:Attr Name=“DocSet“ Value=“Visual Studio“/>
<MSHelp:Attr Name=“TargetOS“ Value=“Windows“/>
<MSHelp:Attr Name=“Locale“ Value=“kbEnglish“/>
<MSHelp:Attr Name=“LinkGroup“ Value=“GettingStarted“/>
</xml>

VS 2005 VorgeDruck
Hier ist H2Reg Skript erforderlich vor, verschmelzen eine VS 2005 Kollektion bei der Anmeldung. Wir haben festgestellt, dass sowohl MS.VSIPCC.v80 und MS.VSCC.v80 müssen zusammengeführt werden. Andernfalls werden Sie immer noch den Merge-Update-Nachricht, wenn Sie das Dokument-Viewer VS 2005 zu öffnen.

Um alle Versionen von VS Verwendung verschmelzen

[Merge_Namespace]
ms.vsipcc +
MS.VSCC +

Um VS 2003 und darüber zusammenführen

[Merge_Namespace]
ms.vscc.2003
ms.vsipcc +
ms.vscc.v *

Um nur VS 2003 fusionieren + VS 2005 + VS 2008

[Merge_Namespace]
ms.vscc.2003
ms.vsipcc.v80
ms.vscc.v80
ms.vsipcc.v90
ms.vscc.v90

VS 2005 äußern VorgeDruck
Wir haben ein paar Leute fragen, wie man Inhalte in VS 2005 Express (die abgespeckte Version von VS 2005) integriert hatte. Ist es das gleiche wie VS 2005?
Mit Express Sie noch in MS.VSIPCC.V80 Stecker (so Steckabschnitt ändert sich nicht).

Express verwendet eine Sammlung namens MS.VSExpressCC.v80 statt ms.vscc.v80.
Also, wenn Sie eine Pre-Merge-Abschnitt verwenden (erfordert auch die h2reg.exe -M Befehlsschalter)
dann müssen Sie diese zusätzliche Sammelnamen hinzuzufügen.

Um alle Versionen von VS Verwendung verschmelzen

[Merge_Namespace]
ms.vsipcc +
MS.VSCC +
ms.vsexpresscc +

Um VS 2003 und darüber zusammenführen

[Merge_Namespace]
ms.vscc.2003
ms.vsipcc +
ms.vscc.v *
ms.vsexpresscc +

Um nur VS 2003 fusionieren + VS 2005 + VS 2008

[Merge_Namespace]
ms.vscc.2003
ms.vsipcc.v80
ms.vscc.v80
ms.vsexpresscc.v80
ms.vscc.v90
ms.vsexpresscc.v90

28-Jun-2006

MS nicht auf 3rd-Party-Plug-Ins in VS 2005 Express zu planen. Wenn Sie Ihren Plug-Ins in Express angezeigt werden soll, dann eine zusätzliche Attribut „Bird Dokumentation = ExpressLibVS“ in der XML-Dateninsel von allen HTML-Dateien erforderlich. Siehe Thread in MSHelp2 Yahoo Group.
<xml>
<MSHelp:Attr Name=“DocSet“ Value=“ExpressLibVS“ />

</xml>

So passen Sie Visual Studio 2005/2008 Suche
Unter VS 2002 und VS 2003 können Sie Filter, die TOC, Index und Suchen bewirken würde registrieren.
Jedoch unter VS 2005 registrierte Filter bewirken nur das TOC und Index.

Frage: Kann H2Reg erstellen VS 2005/2008 Suchfilter?
A. Nein Microsoft haben einen neuen Mechanismus für die Einrichtung VS 2005 Filter zur Verfügung gestellt.

Der folgende Artikel zeigt Ihnen VS 2005/2008 Suche Filter helfen, Setup:
> Erweitern von Visual Studio 2005 Suche

FAQ
F: Ist Quellcode verfügbar?
A. Nein, weil Microsoft nicht die MS Help 2 API-Dokumentation für die Öffentlichkeit freigegeben.

F: Welche Unterstützung ist für H2Reg zur Verfügung?
A. Peer-to-Peer-Unterstützung finden Sie unter
– Http://groups.yahoo.com/group/H2Reg/
– Http://groups.yahoo.com/group/MSHelp2/
H2Reg Newsletter ist http://groups.yahoo.com/group/HelpwareH2Reg verfügbar
Sie können uns auch, wenn Sie Fragen haben oder ein Problem melden.

F. Wir verwenden H2Reg aber ein 3rd-Party eigentlich vertreibt unser Produkt? Keinen H2Reg Lizenz müssen sie auch?
A. Nein. Wenn Sie eine Lizenz erworben haben, dann, was Sie mit Ihrem Installationspaket zu tun, nachdem das ist Ihr Unternehmen.

F: Ist der Download wirklich die volle Release-Version?
A. Ja. Es gibt keine Beschränkungen.

F. Muss ich eine jährliche Lizenzgebühr bezahlen?
A. Nein. Die Lizenzgebühr ist eine einmalige Zahlung.

Frage: Muss ich immer noch, um die Microsoft VSHIK MSM-MSI-Hilfe Registrierungsdateien verwenden?
A. Nein. Sie verwenden einfach Ihre eigenen Installationsprogramm, um alle Dateien zu installieren.
Dann führen Sie H2Reg.exe um die Hilfedateien zu registrieren.

F. Wir verwenden nur H2Reg Intern. Müssen wir eine Lizenz erwerben?
A. H2Reg ist kostenlos für den persönlichen Gebrauch, auch für die geschäftliche Nutzung. Sobald Sie die Verpackung H2Reg in eine Anlage, um zu anderen (internen oder externen Kunden) verteilt werden, dann müssen Sie eine Lizenz erwerben.

F. Wie funktioniert die H2Reg DLL Lizenz arbeiten?
A. Die H2Reg Lizenz umfasst sowohl die EXE und DLL Formen H2Reg. Normalerweise würden Sie entweder die EXE oder das DLL mit Ihrer Installation Lösung aber nicht beide zu versenden. Siehe H2Reg.DLL Seite.

Frage: Kann ich eine allgemeine Anwendung, H2Reg.EXE oder H2Reg.DLL verwendet, um Dateien zu registrieren, zu bauen?
A. Nicht ohne besondere Genehmigung. H2Reg kann nur genutzt werden, um zur Schaffung von Installationspaketen. Es ist illegal für ein Unternehmen oder eine Einzelperson, eine andere Firmen Produkt ohne Genehmigung zu wickeln. Eine Anwendung, die es Benutzern ermöglicht, steuern die Registrierung von MS Help 2 Dateien mit H2Reg ist nicht erlaubt. Die DLL kann nur verwendet werden, um Code, der ein Installationslösung erweitern erstellen.

F: Ist H2Reg nur ein Wrapper für die H2 Registration-API-Aufrufe?
A. Nein H2Reg hat viele eingebaute smarts und überprüft, ob Ihre Kunden Anmeldung ist so einfach und problemlos wie möglich. Der ausführliche Protokolldatei allein erspart Ihnen eine Menge Zeit bei der Fehlersuche.

Frage: Gibt es ein neues Plug-in Position für VS 2005?
A. Ja. MS jetzt will 3. Parteien, ihre Kollektionen in MS.VSIPCC.v80 Stecker (MS.VSCC war. *), Um 3rd-Party-Sammlung ein wenig mehr von der Haupt VS Dokumentation zu isolieren. Für weitere Informationen siehe unsere FAQ.

F. Wie stelle ich meine Skripte zu VS 2008 zu behandeln?
A. Der Namespace für VS 2008 ist „ms.vsipcc.v90“.

Beispiel:

In VS 2002 VS 2003 VS 2005, VS008 (jede installierte Version) Stecker verwenden ms.vsipcc +

[Reg_Plugin]
MS.VSIPCC + | _DEFAULT | MyNameSpace | …

In VS 2008 speziell stecken:

[Reg_Plugin]
MS.VSIPCC.V90 | _DEFAULT | MyNameSpace | …

In VS 2005 speziell stecken:

[Reg_Plugin]
MS.VSIPCC.V80 | _DEFAULT | MyNameSpace | …

Comments are closed.