付録C 機能のライフサイクル The Feature Lifecycle

Internal features are not designed for public use and are only intended to be used by Gradle itself. They can change in any way at any point in time without any notice. Therefore, we recommend avoiding the use of such features. Internal features are not documented. If it appears in this User Guide, the DSL Reference or the API Reference documentation then the feature is not internal.

非公開の機能は、広く使われることは想定しておらず、Gradleが内部的に使うためのものです。これらの機能は、いつでもどんな風にも予告なく変更される可能性があります。 従って、これらの機能を使うことは推奨しません。 また、非公開機能はドキュメント化もされません。もしユーザーガイドやDSLリファレンス、APIリファレンスに載っているなら、それは非公開機能ではないということです。

Internal features may evolve into public features.

非公開機能は、公開機能に昇格する可能性があります。

Features are introduced in the incubating state to allow real world feedback to be incorporated into the feature before it is made public and locked down to provide backwards compatibility. It also gives users who are willing to accept potential future changes early access to the feature so they can put it into use immediately.

試験的な状態にあると書かれた機能は、正式に公開される前に、実際の運用で発生したフィードバックを受け付けている状態のものです。フィードバックが組み込まれ、正式に公開されると、上位互換性を保証するために固定化されることになります。 これらの機能は、機能が変更されるリスクを受け入れられるユーザーに向けて公開されているもので、そういったユーザーであればすぐに使ってみることができます。

A feature in an incubating state may change in future Gradle versions until it is no longer incubating. Changes to incubating features for a Gradle release will be highlighted in the release notes for that release. The incubation period for new features varies depending on the scope, complexity and nature of the feature.

試験的な機能は、試験的でなくなるまでは将来のバージョンのGradleで変更されるかもしれません。変更された場合はリリースノートで通知します。 新機能の試験期間は、その範囲や複雑性、機能の性質によって様々です。

Features in incubation are clearly indicated to be so. In the source code, all methods/properties/classes that are incubating are annotated with Incubating, which is also used to specially mark them in the DSL and API references. If an incubating feature is discussed in this User Guide, it will be explicitly said to be in the incubating state.

試験的な機能は、試験的であるとはっきり明示されます。ソースコードでは全ての試験的なメソッド、プロパティ、クラスはIncubatingアノテーションで注釈されます。これはDSLリファレンスやAPIリファレンスにマークする際も使用されます。試験的機能についてユーザーガイドで言及するときは、試験的な状態にあることを明示的に記載します。

The default state for a non-internal feature is public. Anything that is documented in the User Guide, DSL Reference or API references that is not explicitly said to be incubating or deprecated is considered public. Features are said to be promoted from an incubating state to public. The release notes for each release indicate which previously incubating features are being promoted by the release.

非公開でない機能のデフォルトのステータスが公開です。 ユーザーガイド、DSLリファレンス、APIリファレンスにおける全ての記載内容は、明示的に試験的とか非推奨などと書かれていない限り公開状態と考えてください。 機能は、試験的な状態から公開機能へと言わば昇格します。試験的だった機能が公開状態に昇格した場合は、そのバージョンのリリースノートで通知します。

A public feature will never be removed or intentionally changed without undergoing deprecation. All public features are subject to the backwards compatibility policy.

公開状態の機能は、非推奨とならない限り決して削除されたり意図的に変更されたりすることはありません。 全ての公開機能は上位互換性ポリシーの対象となります。

Some features will become superseded or irrelevant due to the natural evolution of Gradle. Such features will eventually be removed from Gradle after being deprecated. A deprecated feature will never be changed, until it is finally removed according to the backwards compatibility policy.

Gradleの発展に伴って、いくつかの機能は別のものに取って代わられたり、不適切になったりすることがあります。 そのような機能は、非推奨とされた後、やがてはGradleから削除されます。 非推奨の機能は、上位互換性ポリシーに従い、削除されるまで決して変更されることはありません。

Deprecated features are clearly indicated to be so. In the source code, all methods/properties/classes that are deprecated are annotated with “@java.lang.Deprecated” which is reflected in the DSL and API references. In most cases, there is a replacement for the deprecated element, and this will be described in the documentation. Using a deprecated feature will also result in a runtime warning in Gradle's output.

非推奨の機能は、非推奨であるとはっきり明示されます。ソースコードでは全ての非推奨メソッド、プロパティ、クラスは@java.lang.Deprecatedアノテーションで注釈されます。これはDSLリファレンスやAPIリファレンスにも反映されます。ほとんどの場合、非推奨となった要素には代替となるものが用意され、ドキュメントにも記載されます。また、非推奨の機能を使うと、Gradle実行時に警告メッセージが出力されます。

Use of deprecated features should be avoided. The release notes for each release indicate any features that are being deprecated by the release.

非推奨機能の使用は避けるべきです。リリースノートには、そのリリースで非推奨となった機能が全て記載されています。