16

Eclipse 3.7 にアップグレードして以来、Eclipse PDE プラグインは、すべての Eclipse プラグイン プロジェクトに対して「API ベースライン」を指定するように求めています。

ただし、「API Baseline」がここで何を表し、何に使用されるのかを実際に説明するドキュメントはないようです。

誰か説明してくれませんか?

4

2 に答える 2

8

API Baseline は、他のユーザーが使用できるプラグインを維持するのに役立つことを目的としています。API ツールは、互換性のある API バージョンを作成するのに役立ちます。Sumit Singhが投稿したリンクをたどって、それらの使用方法の説明を入手してください。

問題:

  1. プラグインを作成し、バージョン 1 を公開します。
  2. 何百万人もの人々がプラグインを使用し、プラグインの API に依存する独自のコードを作成します。
  3. バージョン 2 を公開します。誤ってプラグインの API を変更してしまいました。
  4. 何百万人もの人々が新しいバージョンに更新し、コードを適応させる必要があります。何千ものプログラムが失敗します。人々は悲しいです。

ソリューション:

  1. プラグインを作成し、その API に注釈を付け、バージョン 1 を公開します。
  2. 何百万人もの人々がプラグインを使用し、プラグインの API に依存する独自のコードを作成します。
  3. コードの変更が自動的に比較されるAPI ベースラインとして、プラグインのバージョン 1 を宣言します。API の中断は、プラグインをリリースする前、またはテストを実行する前に表示されます。API を変更せずにバージョン 2 をリリースします。
  4. 新しいプラグイン リリースは以前のプラグインとバイナリ互換性があるため、何百万人もの人々が自分のアプリケーションであなたのプラグインを更新できます。
  5. プラグインのバージョン 2 を宣言します ....

概要

個人的な使用のためだけにプラグインを開発し、互換性のある API を維持することに関心がない場合は、アドバイスに従って警告を無効にすることができます。

コミュニティ用のプラグイン (Eclipse プラグイン自体など) を開発する場合、API の非互換性を最小限に抑えることが不可欠です。次に、アドバイスに従って、4.3 用に開発するときにベースラインを 4.2 に設定します。API ツールは、現在のすべての 4.2 ユーザーが 4.3 を楽しめるようにするのに役立ちます。

API ツールは、他のユーザーが使用するプラグインの開発者向けであることに注意してください。それらは、それらのプラグインのユーザーには対処されません。

于 2016-11-09T16:23:26.597 に答える
7

PDE APIツールユーザーガイドから:

APIベースラインは、バイナリ互換性、バンドルバージョン番号、および@sinceタグの目的で、開発ワークスペースバンドルを比較する状態を定義します。たとえば、Eclipse 3.4のバンドルを開発している場合は、ベースラインとしてEclipse3.3を使用します。

于 2011-11-20T01:28:22.823 に答える