Использование инструментов Eclipse PDE API

Несколько команд в нашей компании используют внутреннюю структуру для создания пользовательского интерфейса Eclipse. Эта структура состоит из набора подключаемых модулей Eclipse.

Наша команда отвечает за разработку этого фреймворка, и мы ищем инструменты, которые проверяли бы поломку API в следующих версиях нашего фреймворка.

Например, у нас есть следующий класс:

package com.foo.A;

class A {
    public void doSmth() {}
}

В настоящее время в МАНИФЕСТЕ мы и пользователи наших плагинов не указываем никаких версий зависимостей плагинов (всегда соответствующих последней версии).

Мы хотели бы получить несколько предупреждений от Eclipse, если мы что-то изменим в этом классе, например изменить подпись метода или что-то еще. Мы хотели бы, чтобы Eclipse предлагал нам повысить версию плагина в таких случаях.

Я прочитал следующую информацию об инструментах API в Eclipse: https://wiki.eclipse.org/PDE/API_Tools/User_Guide

Но мне кажется, что этот инструментарий работает только с собственными плагинами Eclipse, но не с нашими специально разработанными.

Если я ошибаюсь, может ли кто-нибудь так любезно объяснить мне, как настроить инструменты API для наших плагинов?


eclipse eclipse-plugin pde eclipse-pde
person Dennis    schedule 29.12.2014    source источник
comment
Таким образом, в руководстве рассматривается использование инструментов API в вашем плагины.   -  person greg-449    schedule 29.12.2014

Ответы (1)


arrow_upward
1
arrow_downward

Инструменты Eclipse API работают также с пользовательскими пакетами. Что вам нужно сделать, так это взять выпущенный фреймворк и определить его как базовый. Быстрое решение - скопировать всю вашу сборку и опубликовать ее в общедоступных пакетах в папке и установить папку как базовую:

Window - Preferences - Plug-in Development - API Baselines - [Add Baseline...]

У вас может быть несколько базовых показателей, например, если вам нужно исправить более старые версии фреймворка. Убедитесь, что вы установили API Errors/Warnings в соответствии с вашими требованиями.

Изменить: Конечно, вы должны включить API Tooling во всех своих пакетах, как описано в разделе «Настроить пакеты для API Tooling» на веб-странице, на которую вы указали!

person Veselin    schedule 30.12.2014
comment
Вопрос в том, что после настройки моих проектов для инструментов API, как описано на странице, которую я связал, в мой исходный код не добавляются теги. Что я делаю неправильно? - person Dennis; 31.12.2014
comment
Так что пока у меня есть такие ошибки, как «Тип <class name> был удален из <plugin name>_<plugin version>» - person Dennis; 31.12.2014
comment
Теги javadoc не создаются автоматически. Это то, что вам нужно сделать. Судя по вашему второму комментарию, я понял, что у вас все работает! Удаление класса из ваших экспортированных пакетов является поломкой api, и необходимо увеличить основную версию пакета. Полученное сообщение об ошибке должно сопровождаться сообщением об ошибке, в котором говорится, что вам следует увеличить основную версию. - person Veselin; 31.12.2014