Flutter 的 pubspec.yaml 中依赖版本号前面的插入符号(^)是什么?

在我的 Flutter 项目的 pubspec.yaml文件中,在一些依赖项的版本号之前有一个插入符号(^)。

dependencies:
flutter:
sdk: flutter
cupertino_icons: ^0.1.2
english_words: ^3.1.5

它的目的是什么? 它意味着什么?

笔记

14489 次浏览

The caret sign (^) is used for pub dependencies in Dart to indicate a range of version numbers are allowed. Specifically, any version from the specified version up to (but not including) the next non-breaking version is ok.

  • So ^3.1.5 is the same as '>=3.1.5 <4.0.0'
  • And ^1.2.3 would be the same as '>=1.2.3 <2.0.0'

It's shorthand for the longer form.

The ^ is saying, I want to automatically use the most up-to-date package from Pub as long as that update won't break anything in my app.

Notes

Clarification for versions less than 1.0.0

Originally I had thought that

  • ^0.1.2 is the same as '>=0.1.2 <1.0.0' (wrong!)

However, that is an incorrect understanding of Semantic Versioning. When the major version number is 0 (as in the 0 of 0.1.2), the meaning is that the API is unstable and even minor version number changes (as in the 1 of 0.1.2) can indicate a breaking change.

The Semantic Versioning article states:

Major version zero (0.y.z) is for initial development. Anything may change at any time. The public API should not be considered stable.

and also

How should I deal with revisions in the 0.y.z initial development phase?

The simplest thing to do is start your initial development release at 0.1.0 and then increment the minor version for each subsequent release.

Thus, the following is the corrected form:

  • ^0.1.2 is the same as '>=0.1.2 <0.2.0'

Thank you to Günter Zöchbauer for pointing out my error.

See also

The caret sign ^ means the specified version and all newer versions that don't introduce breaking changes relative to the specified version.

Dart follows Semantic Versioning and suggests that to be used for package maintainers as well.

Semantic Versioning defines that

  • For versions >= 1.0.0, the major version needs to be incremented for breaking changes.
  • For versions < 1.0.0, the minor version needs to be incremented for breaking changes.

Example:

^2.4.3 means >= 2.4.3 < 3.0.0

^0.17.19 means >= 0.17.19 <0.18.0

It means that any new versions of a dependency that does not contain breaking changes will be accepted.

Dart language follows semantic versioning and uses it for package maintainers.

In layman's terms ^1.8.1 means >= 1.8.1 < 2.0.0