API Baseline предназначены для того, чтобы помочь вам поддерживать плагины, которые могут использовать другие.Инструменты API помогают создавать совместимые версии API.Перейдите по ссылке, размещенной Sumit Singh , чтобы получить объяснения по их использованию.
Проблема:
- Вы создаете свой плагин и публикуете версию 1.
- Миллионы людей используют ваш плагин и создают свой собственный код, который зависитна API вашего плагина.
- Вы выпускаете версию 2 для общественности. По ошибке вы меняете API своего плагина.
- Миллионы людей обновляются до новой версии и вынуждены адаптировать свой код.Тысячи программ терпят неудачу.Люди печальны.
Решение:
- Вы создаете свой плагин, комментируете его API и выпускаете версию 1 для общественности.
- Миллионы людей будут использовать ваш плагин и создавать свой собственный код, который зависит от API вашего плагина.
- Вы объявляете версию 1 вашего плагина API-Baseline , котораяизменения вашего кода автоматически сравниваются сЛюбой перерыв в API предоставляется вам за до , когда вы выпускаете плагин или запускаете тесты.Вы выпускаете версию 2 без каких-либо изменений API.
- Миллионы людей могут обновить ваш плагин в своем приложении, потому что новый выпуск плагина двоично совместим с предыдущим.
- Вы объявляете версию 2 изваш плагин ....
Резюме
Если вы разрабатываете плагин только для личного использования и не заинтересованы в поддержке совместимого API, вы можете следовать советам, чтобы отключитьпредупреждения.
Когда вы разрабатываете плагины для сообщества, например, сами плагины eclipse, важно сводить к минимуму несовместимости API.Затем вы последуете совету и установите базовый уровень 4,2 при разработке для 4.3.Инструменты API помогут вам превратить 4.3 в удовольствие для всех текущих пользователей 4.2.
Обратите внимание, что инструменты API предназначены для разработчиков плагинов, которые будут использоваться другими.Они не адресованы пользователям этих плагинов.