H2Reg ЧАВО

См. также

Немецкий Перевод : Спасибо Валерии Александровой (www.pkwteile.de) за эту страницы перевода.

Поиск и устранение неисправностей

Некоторые типичные регистрационные проблемы, которые мы находим с MS Help 2.

TOC исчезает. Регистрация работает только на машинах разработчиков

Уровень сбора данных. файлы не должны содержать ссылку на файл DTD. 
Клиент не будет иметь установленный VSHIK и, следовательно, не будут иметь файлы DTD.

См H2 сборное учебное пособие - 3.6 Не добавляйте DTD
 

MSI и технические неполадки

К сожалению, это случается. MSI (MS установщик) может завинтить и остановить клиента от ремонта/ удаления/переустановки части VS. Хотя не проблема H2Reg поврежденная VS установщик может остановить H2 Регистрацию правильно работать. Часто единственный путь вперед, чтобы удалить VS или помочь 2 Двигать с силой и переустановить VS.

См MSHelpWiki: Visual Studio Проблемы 7.x установки
 

H2Reg выдает "заблокирован другим процессом" ошибку.

Регистрационные API вызовы H2 может сделать только одну вещь на системе Windows. 
Каждый раз, когда вы что-то зарегистрировать эти звонки 
1. Блокировка (Пуск H2 транзакции) 
2. Выполните одно или несколько регистраций
3. Разблокировка (Конец H2 транзакции) 

Проблемы возникают, когда другое приложение для Windows пытается выполнить регистрацию вызова на этапе 2. В этом случае приложения, такие как H2Reg и FAR будет продолжать пытаться, пока они в конечном итоге не получат Тайм-аут с сообщением "заблокирован другим процессом".

Мы находим эту проблему, как правило, возникает, когда установщик работает H2Reg.exe в "режиме NOWAIT" или попытки запуска более одной программы (что делает H2 API вызовы) сразу. Решение неизбежно будет установить программу установки для запуска H2Reg.exe в "Run и режим ждать". Для устранения этой ошибки может потребоваться перезагрузка.
 

Другая "заблокирован другим процессом" ошибка

H2 API может получить сам смущение и не выпускать заблокированные файлы, даже после перезагрузки: см H2 Сообщения
 

Исчезновение TOC

Один из наших клиентов сообщили, xnj исчезающая проблема ТОС может быть вызвано регистрацией коллекции с пустой ТОС под VS 2002 (они подключили другие коллекции в этой коллекции). Они обнаружили, что установка .NET Framework 1.1 SDK обновляет помощь от V2.1 до V2.2 и исправляет эту проблему. Очевидно Помощь 2.2, который обычно устанавливается на VS 2003 является более стабильной. Смотрите также H2 Регистрация Помощь
 

Некоторые атрибуты я заявил, не рабочими

В документации H2Reg Тим Grantham из Themo поднял необычную проблему. Index.htm использует HTML-комментарии в Острове данных XML. Хотя компилятор позволяет этот синтаксис, эффект в том, что эти атрибуты с именами используются более одного раза эффективно нейтрализованы (как если бы они никогда не были объявлены). Поэтому, пожалуйста, воздержитесь от использования HTML комментариев в ваших островах данных XML. Проблема была обнаружена в VS 2003 и было сообщено в команду MS Help.

<XML>
...
<! - Свойства VS Студии->
<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>
 

No DExplore автоматического обнаружения не слияния под VS 2005 Beta 2

Следите за этим. Под VS 2005 Beta 2 только,то что вам нужно, чтобы заставить производить слияния так, что бы ваша коллекция может быть просмотрена. Большинство из нас зависит от DExplorer выполнения автоопределения/ слияния после того, как мы зарегистрируем нашу коллекцию. VS 2005 RTM (Release To Manufacturing) версия в порядке и будет автоматически слита. См FAQ для большего .
 

VS 2005 - Где моя ТОС?

Мы заметили, что в соответствии с VS 2005 RTM наша Оглавление не будет отображаться (слияние) в коллекции TOC VS 2005. Ну на самом деле вводная страница отображается OK в оглавлении, но без каких-либо других страниц. При ближайшем рассмотрении мы обнаружили, что только вводная страница была с полным набором элементов XML островных данных. После добавления этих XML-тегов на других страницах, все разделы справки H2Reg правильно появились в оглавлении VS 2005. Очевидно, что VS 8 является с более строгими атрибутами. Именно по этой причине для H2Reg v1.4.4 есть небольшое обновление.

Вот остров данных XML мы разместили в заголовке каждой темы нашей помощи. Очевидно, что эти два элемента Title должны быть отрегулированы по каждой теме и вам не нужен нашей HelpWare Атрибут:

<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: атр Name = "TargetOS" Value = "Windows" />
<MSHelp: атр Name = "Locale" Value = "kbEnglish" />
<MSHelp: атр Name = "LinkGroup" Value = "GettingStarted" />
</ XML>
 

VS 2005 Пре-объединение

Здесь H2Reg требуется сценарий дял предварительного слива 2005 коллекцию VS во время регистрации. Мы обнаружили, что оба MS.VSIPCC.v80 и MS.VSCC.v80 должны быть объединены. В противном случае вы будете видеть сообщение об обновлении слияния при открытии просмотра документов VS 2005.

Чтобы объединить все версии использования VS 

[Merge_Namespace] 
ms.vsipcc + 
ms.vscc + 
Слить VS 2003 и выше 

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

Чтобы объединить только VS 2003 + VS 2005 + VS 2008

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

VS 2005 Express Пре-объединение

У нас было несколько человек, с вопросом, как интегрировать контент в VS 2005 Express (усеченная версия VS 2005). Это то же самое, как VS 2005?
С помощью функции Express вы все еще подключить к MS.VSIPCC.V80 (так плагин в разделе не меняется).

Экспресс использует коллекцию под названием MS.VSExpressCC.v80 вместо ms.vscc.v80.
Так что если вы используете секцию предварительного слияния (также требует переключатель команда h2reg.exe -М)
то вам нужно добавить это дополнительное название коллекции.

Чтобы объединить все версии использования VS 

[Merge_Namespace] 
ms.vsipcc +
ms.vscc +
ms.vsexpresscc +


Слить VS 2003 и выше 

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


Чтобы объединить только VS 2003 + VS 2005 + VS 2008

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

 
11 июня 2016 г.

MS не планировал на 3-ти сторонние плагины в VS 2005 Express. Если вы хотите, чтобы ваши плагины появились в Экспресс затем дополнительный атрибут "DocSet = ExpressLibVS" требуется на острове данных XML всех HTML-файлов. См нить в MSHelp2 Yahoo Group .

<XML>
<MSHelp: атр Name = "DocSet" Value = "ExpressLibVS" />
...
</ XML>

Как настроить Visual Studio 2005/2008 Поиск

В соответствии с VS 2002 и VS 2003 можно зарегистрировать фильтры, которые сделают эффект TOC, индексации и поиска.
Однако в соответствии с VS 2005 зарегистрированных фильтров только эффект ТОС и индексирование. 

В. Может ли H2Reg создать VS 2005/2008 фильтры поиска? 
A. Нет Microsoft предоставили новый механизм для установки VS 2005 фильтров.


Следующая статья поможет вам настроить VS 2005/2008 фильтры поиска:
> Расширение Visual Studio 2005 Поиск

 

ЧАВО

В. Доступен ли исходный код?
A. Нет, потому что Microsoft не не выпустила API документации MS Help 2 для широкой публики.

Q. Какая поддержка доступна для H2Reg?
A. Поддержка сеть-к-сети можно найти на 
- http://groups.yahoo.com/group/H2Reg/
- http://groups.yahoo.com/group/MSHelp2/
H2Reg -T-T--T---T -TT-T +-TTT- -- http://groups.yahoo.com/group/HelpwareH2Reg
Вы можете также нами , если у вас есть вопросы или вы хотите сообщить о проблеме.

Q. Мы используем H2Reg, но третья сторона фактически распространяет наш продукт? Они также нуждаются в лицензии H2Reg?
A. Нет Если вы приобрели лицензию, то, что вы делаете с вашей установкой пакета после того, то это ваше дело.

В. Является ли загрузка действительно полной версией релиза?
Ответ: Да. Там нет никаких ограничений.

Вопрос: Нужно ли мне платить ежегодно за лицензию?
A. Нет Плата за лицензию - один раз.

Вопрос: Должен ли я по-прежнему использовать Microsoft VSHIK.MSM MSI Помощь в Регистрации Файлов?
A. Нет, вы просто использовать вашу собственную программу установки, чтобы установить все файлы. 
Затем запустите H2Reg.exe что бы зарегистрировать файлы справки.

Q. Мы используем только H2Reg внутри только. Должны ли мы приобрести лицензию?
А. H2Reg является бесплатным для личного использования, даже для коммерческого использования. Как только вы упаковали H2Reg в установку для распространения среди других (будь то внутренних или внешних клиентов), то вам необходимо приобрести лицензию.

Q. Как работает лицензия H2Reg DLL?
Лицензия А. H2Reg охватывает как EXE и DLL формы H2Reg. Как правило, вы бы отправить либо EXE или DLL с вашим решением установки, но не оба. Смотрите страницу H2Reg.DLL .

Вопрос: Могу ли я построить общее приложение, которое использует H2Reg.EXE или H2Reg.DLL зарегистрированые файлы?
А. Не без специального разрешения. H2Reg могут быть использованы только, чтобы помочь создать пакеты установки. Это незаконно - компания или частное лицо, чтобы обернуть другой продукт компании без разрешения. Приложение, которое позволяет пользователям контролировать регистрацию MS помочь 2 файлам с помощью H2Reg не допускается. DLL может быть использован только для создания кода используемого для расширения решения по установке.

Вопрос: Является ли H2Reg просто оболочкой для API регистрации вызовов H2?
A. Нет H2Reg имеет множество встроенных СМАРТС и проверкой, чтобы убедиться, что ваша регистрация клиентов так просто и без проблем, как это возможно. Подробный журнал в одиночку файл может сэкономить много времени при отладке.

Вопрос: Есть ли новый плагин место для VS 2005?
Ответ: Да. MS теперь хотят 3-й стороной подключить свои коллекции в MS.VSIPCC.v80 (был MS.VSCC. *), Чтобы изолировать третьей стороной коллекции немного больше от основной документации VS. Для получения дополнительной информации см наш FAQ .

Q. Как настроить мои сценарии для обработки VS 2008?
A. Пространство имен для VS 2008 является "ms.vsipcc.v90".

Пример:
 
Для того, чтобы подключить к VS 2002, чтобы, VS 2003, VS 2005, VS008 (любой установленной версии) использовать ms.vsipcc +
 
[Reg_Plugin]
Machine translation
MS.VSIPCC + | _DEFAULT | MyNameSpace | ...
 
 
 
 
 
Для того, чтобы подключить к VS 2008 а именно:
 
[Reg_Plugin]
MS.VSIPCC.V90 | _DEFAULT | MyNameSpace | ...
 
Для того, чтобы подключить к VS 2005 а именно:
 
[Reg_Plugin]
MS.VSIPCC.V80 | _DEFAULT | MyNameSpace | ...
 
Подстраницы (2): H2Reg и монтажники
 
 
Комментарии