Глава 7. Интерфейс IBugtraqProvider

Содержание

Соглашение об именование
Интерфейс IBugtraqProvider
Интерфейс IBugtraqProvider2

Для более тесной интеграции с системами отслеживания проблем, нежели простое использование свойств bugtraq:, TortoiseSVN может применять подключаемые модули с COM интерфейсом. С такими подключаемыми модулями возможно получать информацию непосредственно из системы отслеживания проблем, взаимодействовать с пользователем и предоставлять информацию о нерешённых проблемах обратно TortoiseSVN, проверять сообщения журнала, вводимые пользователем и даже выполнять действия после успешной фиксации для, например, закрытия проблемы.

Мы не можем предоставить информацию и руководство о том, как вы должны реализовывать COM-объект на вашем любимом языке программирования, но у нас есть образцы подключаемых модулей (plugins) на C++/ATL и C# в папке contrib/issue-tracker-plugins нашего хранилища. В этой папке вы также можете найти требуемые include-файлы для сборки. («Лицензия» рассказывает как получить доступ к хранилищу.)

Важно

Вам следует предоставить и 32-битную, и 64-битную версию вашего подключаемого модуля, потому что 64-разрядная версия TortoiseSVN не может использовать 32-х разрядные модули и наоборот.

Соглашение об именование

Если вы выпускаете модуль для системы отслеживания проблем для TortoiseSVN, то, пожалуйста, не называйте его Tortoise<ЧтоТоТам>. Мы хотели бы зарезервировать префикс Tortoise для клиентов управления версиями, интегрируемых в оболочку Windows. Например: TortoiseCVS, TortoiseSVN, TortoiseHg, TortoiseGit и TortoiseBzr — всё это клиенты управления версиями.

Пожалуйста, назовите ваш плагин для клиента Tortoise Turtle<ЧтоТоТам>, где <ЧтоТоТам> ссылается на систему отслеживания проблем, к которой вы подключаетесь. Как вариант, выберите наименование, которое звучит как Turtle, но имеет другую первую букву. Вот хороший пример:

  • Gurtle - плагин для отслеживания проблем в Google Code

  • TurtleMine - плагин для отслеживания ошибок в Redmine

  • VurtleOne - плагин для отслеживания ошибок в VersionOne