[various] Clarify endorsement in READMEs (#3404)

[various] Clarify endorsement in READMEs

Author: stuartmorgan-g

packages/camera/camera_android/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.10.4+3
+
+* Clarifies explanation of endorsement in README.
+
 ## 0.10.4+2
 
 * Aligns Dart and Flutter SDK constraints.

packages/camera/camera_android/README.md

@@ -5,7 +5,11 @@ The Android implementation of [`camera`][1].
 ## Usage
 
 This package is [endorsed][2], which means you can simply use `camera`
-normally. This package will be automatically included in your app when you do.
+normally. This package will be automatically included in your app when you do,
+so you do not need to add it to your `pubspec.yaml`.
+
+However, if you `import` this package to use any of its APIs directly, you
+should add it to your `pubspec.yaml` as usual.
 
 [1]: https://pub.dev/packages/camera
 [2]: https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin

packages/camera/camera_android/pubspec.yaml

@@ -2,7 +2,7 @@ name: camera_android
 description: Android implementation of the camera plugin.
 repository: https://github.com/flutter/packages/tree/main/packages/camera/camera_android
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+camera%22
-version: 0.10.4+2
+version: 0.10.4+3
 
 environment:
   sdk: ">=2.17.0 <3.0.0"

packages/camera/camera_avfoundation/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.9.13+1
+
+* Clarifies explanation of endorsement in README.
+
 ## 0.9.13
 
 * Allows camera to be switched while video recording.

packages/camera/camera_avfoundation/README.md

@@ -5,7 +5,11 @@ The iOS implementation of [`camera`][1].
 ## Usage
 
 This package is [endorsed][2], which means you can simply use `camera`
-normally. This package will be automatically included in your app when you do.
+normally. This package will be automatically included in your app when you do,
+so you do not need to add it to your `pubspec.yaml`.
+
+However, if you `import` this package to use any of its APIs directly, you
+should add it to your `pubspec.yaml` as usual.
 
 [1]: https://pub.dev/packages/camera
 [2]: https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin

packages/camera/camera_avfoundation/pubspec.yaml

@@ -2,7 +2,7 @@ name: camera_avfoundation
 description: iOS implementation of the camera plugin.
 repository: https://github.com/flutter/packages/tree/main/packages/camera/camera_avfoundation
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+camera%22
-version: 0.9.13
+version: 0.9.13+1
 
 environment:
   sdk: '>=2.18.0 <3.0.0'

packages/camera/camera_web/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 0.3.1+3
 
+* Clarifies explanation of endorsement in README.
 * Aligns Dart and Flutter SDK constraints.
 
 ## 0.3.1+2

packages/camera/camera_web/README.md

@@ -10,7 +10,11 @@ The web implementation of [`camera`][camera].
 
 This package is [endorsed](https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin),
 which means you can simply use `camera`
-normally. This package will be automatically included in your app when you do.
+normally. This package will be automatically included in your app when you do,
+so you do not need to add it to your `pubspec.yaml`.
+
+However, if you `import` this package to use any of its APIs directly, you
+should add it to your `pubspec.yaml` as usual.
 
 ## Example
 
@@ -84,13 +88,13 @@ if (kIsWeb) {
 }
 ```
 
-### Video recording 
+### Video recording
 
 The video recording implementation is backed by [MediaRecorder Web API](https://developer.mozilla.org/en-US/docs/Web/API/MediaRecorder) with the following [browser support](https://caniuse.com/mdn-api_mediarecorder):
 
 ![Data on support for the MediaRecorder feature across the major browsers from caniuse.com](https://caniuse.bitsofco.de/image/mediarecorder.png).
 
-A video is recorded in one of the following video MIME types: 
+A video is recorded in one of the following video MIME types:
 - video/webm (e.g. on Chrome or Firefox)
 - video/mp4 (e.g. on Safari)
 

packages/camera/camera_web/pubspec.yaml

@@ -2,7 +2,7 @@ name: camera_web
 description: A Flutter plugin for getting information about and controlling the camera on Web.
 repository: https://github.com/flutter/packages/tree/main/packages/camera/camera_web
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+camera%22
-version: 0.3.1+2
+version: 0.3.1+3
 
 environment:
   sdk: ">=2.17.0 <3.0.0"

packages/file_selector/file_selector_ios/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 0.5.1+1
 
+* Clarifies explanation of endorsement in README.
 * Aligns Dart and Flutter SDK constraints.
 
 ## 0.5.1

packages/file_selector/file_selector_ios/README.md

@@ -5,7 +5,11 @@ The iOS implementation of [`file_selector`][1].
 ## Usage
 
 This package is [endorsed][2], which means you can simply use `file_selector`
-normally. This package will be automatically included in your app when you do.
+normally. This package will be automatically included in your app when you do,
+so you do not need to add it to your `pubspec.yaml`.
+
+However, if you `import` this package to use any of its APIs directly, you
+should add it to your `pubspec.yaml` as usual.
 
 [1]: https://pub.dev/packages/file_selector
 [2]: https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin

packages/file_selector/file_selector_ios/pubspec.yaml

@@ -2,7 +2,7 @@ name: file_selector_ios
 description: iOS implementation of the file_selector plugin.
 repository: https://github.com/flutter/packages/tree/main/packages/file_selector/file_selector_ios
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+file_selector%22
-version: 0.5.1
+version: 0.5.1+1
 
 environment:
   sdk: ">=2.18.0 <3.0.0"

packages/file_selector/file_selector_linux/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 0.9.1+2
 
+* Clarifies explanation of endorsement in README.
 * Aligns Dart and Flutter SDK constraints.
 
 ## 0.9.1+1

packages/file_selector/file_selector_linux/README.md

@@ -5,7 +5,11 @@ The Linux implementation of [`file_selector`][1].
 ## Usage
 
 This package is [endorsed][2], which means you can simply use `file_selector`
-normally. This package will be automatically included in your app when you do.
+normally. This package will be automatically included in your app when you do,
+so you do not need to add it to your `pubspec.yaml`.
+
+However, if you `import` this package to use any of its APIs directly, you
+should add it to your `pubspec.yaml` as usual.
 
 [1]: https://pub.dev/packages/file_selector
 [2]: https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin

packages/file_selector/file_selector_linux/pubspec.yaml

@@ -2,7 +2,7 @@ name: file_selector_linux
 description: Liunx implementation of the file_selector plugin.
 repository: https://github.com/flutter/packages/tree/main/packages/file_selector/file_selector_linux
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+file_selector%22
-version: 0.9.1+1
+version: 0.9.1+2
 
 environment:
   sdk: ">=2.17.0 <3.0.0"

packages/file_selector/file_selector_macos/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 0.9.0+6
 
+* Clarifies explanation of endorsement in README.
 * Aligns Dart and Flutter SDK constraints.
 
 ## 0.9.0+5

packages/file_selector/file_selector_macos/README.md

@@ -5,7 +5,11 @@ The macOS implementation of [`file_selector`][1].
 ## Usage
 
 This package is [endorsed][2], which means you can simply use `file_selector`
-normally. This package will be automatically included in your app when you do.
+normally. This package will be automatically included in your app when you do,
+so you do not need to add it to your `pubspec.yaml`.
+
+However, if you `import` this package to use any of its APIs directly, you
+should add it to your `pubspec.yaml` as usual.
 
 ### Entitlements
 

packages/file_selector/file_selector_macos/pubspec.yaml

@@ -2,7 +2,7 @@ name: file_selector_macos
 description: macOS implementation of the file_selector plugin.
 repository: https://github.com/flutter/packages/tree/main/packages/file_selector/file_selector_macos
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+file_selector%22
-version: 0.9.0+5
+version: 0.9.0+6
 
 environment:
   sdk: ">=2.17.0 <3.0.0"

packages/file_selector/file_selector_web/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 0.9.0+4
 
+* Clarifies explanation of endorsement in README.
 * Aligns Dart and Flutter SDK constraints.
 
 ## 0.9.0+3

packages/file_selector/file_selector_web/README.md

@@ -5,7 +5,11 @@ The web implementation of [`file_selector`][1].
 ## Usage
 
 This package is [endorsed][2], which means you can simply use `file_selector`
-normally. This package will be automatically included in your app when you do.
+normally. This package will be automatically included in your app when you do,
+so you do not need to add it to your `pubspec.yaml`.
+
+However, if you `import` this package to use any of its APIs directly, you
+should add it to your `pubspec.yaml` as usual.
 
 [1]: https://pub.dev/packages/file_selector
 [2]: https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin

packages/file_selector/file_selector_web/pubspec.yaml

@@ -2,7 +2,7 @@ name: file_selector_web
 description: Web platform implementation of file_selector
 repository: https://github.com/flutter/packages/tree/main/packages/file_selector/file_selector_web
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+file_selector%22
-version: 0.9.0+3
+version: 0.9.0+4
 
 environment:
   sdk: ">=2.17.0 <3.0.0"

packages/file_selector/file_selector_windows/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 0.9.1+6
 
+* Clarifies explanation of endorsement in README.
 * Aligns Dart and Flutter SDK constraints.
 
 ## 0.9.1+5

packages/file_selector/file_selector_windows/README.md

@@ -5,7 +5,11 @@ The Windows implementation of [`file_selector`][1].
 ## Usage
 
 This package is [endorsed][2], which means you can simply use `file_selector`
-normally. This package will be automatically included in your app when you do.
+normally. This package will be automatically included in your app when you do,
+so you do not need to add it to your `pubspec.yaml`.
+
+However, if you `import` this package to use any of its APIs directly, you
+should add it to your `pubspec.yaml` as usual.
 
 [1]: https://pub.dev/packages/file_selector
 [2]: https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin

packages/file_selector/file_selector_windows/pubspec.yaml

@@ -2,7 +2,7 @@ name: file_selector_windows
 description: Windows implementation of the file_selector plugin.
 repository: https://github.com/flutter/packages/tree/main/packages/file_selector/file_selector_windows
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+file_selector%22
-version: 0.9.1+5
+version: 0.9.1+6
 
 environment:
   sdk: ">=2.17.0 <3.0.0"

packages/google_maps_flutter/google_maps_flutter_android/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 2.4.9
 
+* Clarifies explanation of endorsement in README.
 * Aligns Dart and Flutter SDK constraints.
 
 ## 2.4.8

packages/google_maps_flutter/google_maps_flutter_android/README.md

@@ -8,7 +8,10 @@ The Android implementation of [`google_maps_flutter`][1].
 
 This package is [endorsed][2], which means you can simply use
 `google_maps_flutter` normally. This package will be automatically included in
-your app when you do.
+your app when you do, so you do not need to add it to your `pubspec.yaml`.
+
+However, if you `import` this package to use any of its APIs directly, you
+should add it to your `pubspec.yaml` as usual.
 
 ## Display Mode
 

packages/google_maps_flutter/google_maps_flutter_android/pubspec.yaml

@@ -2,7 +2,7 @@ name: google_maps_flutter_android
 description: Android implementation of the google_maps_flutter plugin.
 repository: https://github.com/flutter/packages/tree/main/packages/google_maps_flutter/google_maps_flutter_android
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+maps%22
-version: 2.4.8
+version: 2.4.9
 
 environment:
   sdk: ">=2.17.0 <3.0.0"

packages/google_maps_flutter/google_maps_flutter_ios/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 2.2.1
 
+* Clarifies explanation of endorsement in README.
 * Aligns Dart and Flutter SDK constraints.
 
 ## 2.2.0

packages/google_maps_flutter/google_maps_flutter_ios/README.md

@@ -6,7 +6,10 @@ The iOS implementation of [`google_maps_flutter`][1].
 
 This package is [endorsed][2], which means you can simply use
 `google_maps_flutter` normally. This package will be automatically included in
-your app when you do.
+your app when you do, so you do not need to add it to your `pubspec.yaml`.
+
+However, if you `import` this package to use any of its APIs directly, you
+should add it to your `pubspec.yaml` as usual.
 
 [1]: https://pub.dev/packages/google_maps_flutter
 [2]: https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin

packages/google_maps_flutter/google_maps_flutter_ios/pubspec.yaml

@@ -2,7 +2,7 @@ name: google_maps_flutter_ios
 description: iOS implementation of the google_maps_flutter plugin.
 repository: https://github.com/flutter/packages/tree/main/packages/google_maps_flutter/google_maps_flutter_ios
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+maps%22
-version: 2.2.0
+version: 2.2.1
 
 environment:
   sdk: ">=2.18.0 <3.0.0"

packages/google_maps_flutter/google_maps_flutter_web/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 0.4.0+7
 
+* Clarifies explanation of endorsement in README.
 * Aligns Dart and Flutter SDK constraints.
 
 ## 0.4.0+6

packages/google_maps_flutter/google_maps_flutter_web/README.md

@@ -6,9 +6,11 @@ This is an implementation of the [google_maps_flutter](https://pub.dev/packages/
 
 ### Depend on the package
 
-This package is not an endorsed implementation of the google_maps_flutter plugin yet, so you'll need to 
+This package is not an endorsed implementation of the google_maps_flutter plugin yet, so you'll need to
 [add it explicitly](https://pub.dev/packages/google_maps_flutter_web/install).
 
+Once you do, you can use the `google_maps_flutter` APIs as you normally would.
+
 ### Modify web/index.html
 
 Get an API Key for Google Maps JavaScript API. Get started [here](https://developers.google.com/maps/documentation/javascript/get-api-key).

packages/google_maps_flutter/google_maps_flutter_web/pubspec.yaml

@@ -2,7 +2,7 @@ name: google_maps_flutter_web
 description: Web platform implementation of google_maps_flutter
 repository: https://github.com/flutter/packages/tree/main/packages/google_maps_flutter/google_maps_flutter_web
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+maps%22
-version: 0.4.0+6
+version: 0.4.0+7
 
 environment:
   sdk: ">=2.17.0 <3.0.0"

packages/google_sign_in/google_sign_in_android/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 6.1.8
 
+* Clarifies explanation of endorsement in README.
 * Aligns Dart and Flutter SDK constraints.
 * Updates compileSdkVersion to 33.
 

packages/google_sign_in/google_sign_in_android/README.md

@@ -5,7 +5,11 @@ The Android implementation of [`google_sign_in`][1].
 ## Usage
 
 This package is [endorsed][2], which means you can simply use `google_sign_in`
-normally. This package will be automatically included in your app when you do.
+normally. This package will be automatically included in your app when you do,
+so you do not need to add it to your `pubspec.yaml`.
+
+However, if you `import` this package to use any of its APIs directly, you
+should add it to your `pubspec.yaml` as usual.
 
 [1]: https://pub.dev/packages/google_sign_in
 [2]: https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin

packages/google_sign_in/google_sign_in_android/pubspec.yaml

@@ -2,7 +2,7 @@ name: google_sign_in_android
 description: Android implementation of the google_sign_in plugin.
 repository: https://github.com/flutter/packages/tree/main/packages/google_sign_in/google_sign_in_android
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+google_sign_in%22
-version: 6.1.7
+version: 6.1.8
 
 environment:
   sdk: ">=2.17.0 <3.0.0"

packages/google_sign_in/google_sign_in_ios/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 5.6.1
 
+* Clarifies explanation of endorsement in README.
 * Aligns Dart and Flutter SDK constraints.
 
 ## 5.6.0

packages/google_sign_in/google_sign_in_ios/README.md

@@ -5,7 +5,11 @@ The iOS implementation of [`google_sign_in`][1].
 ## Usage
 
 This package is [endorsed][2], which means you can simply use `google_sign_in`
-normally. This package will be automatically included in your app when you do.
+normally. This package will be automatically included in your app when you do,
+so you do not need to add it to your `pubspec.yaml`.
+
+However, if you `import` this package to use any of its APIs directly, you
+should add it to your `pubspec.yaml` as usual.
 
 [1]: https://pub.dev/packages/google_sign_in
 [2]: https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin