The annotation @Provisional('message')
marks a feature as provisional.
An API is considered to be provisional if it is still going through the process of stabilizing and is subject to change or removal.
The intent of the @Provisional
annotation is to mark APIs that are still in development or that are added only tentatively. Adding the API allows users to experiment with using the APIs, which can provide valuable feedback. Such provisional APIs do not promise stability. They can be changed or removed without warning.
The @Provisional
annotation applies to:
Provisionality is transitive:
Further, if a class is provisional, so are classes that extend, implement, and mix-in the class.
A tool that processes Dart source code may report when:
If the provisional use is inside a library, class or method which is itself provisional, the tool should not bother the user about it. A provisional feature is expected to use other provisional features.
© 2012 the Dart project authors
Licensed under the Creative Commons Attribution-ShareAlike License v4.0.
https://api.dartlang.org/stable/2.0.0/dart-core/Provisional-class.html