Explain why gradle wrapper files are .gitignored

Author: mravn-google

examples/README.md

@@ -44,3 +44,12 @@ Available examples include:
 
 - **Stocks** The [stocks](stocks) demo shows how one might structure
   an application with several screens.
+
+Note on Gradle wrapper files in `.gitignore`:
+
+Gradle wrapper files should normally be checked into source control.
+The example projects don't do that to avoid having several copies of the
+wrapper binary in the Flutter repo. Instead, the Gradle wrapper is
+injected by Flutter tooling, and the wrapper files are .gitignore'd to
+avoid making the Flutter repository dirty as a side effect of running
+the examples.

examples/catalog/android/.gitignore

@@ -8,6 +8,8 @@
 /captures
 GeneratedPluginRegistrant.java
 
+# Gradle wrapper files should normally be checked into source control.
+# See ../../README.md
 gradle-wrapper.jar
 /gradlew
 /gradlew.bat

examples/flutter_gallery/android/.gitignore

@@ -8,6 +8,8 @@
 /captures
 GeneratedPluginRegistrant.java
 
+# Gradle wrapper files should normally be checked into source control.
+# See ../../README.md
 gradle-wrapper.jar
 /gradlew
 /gradlew.bat

examples/flutter_view/android/.gitignore

@@ -8,6 +8,8 @@
 /captures
 GeneratedPluginRegistrant.java
 
+# Gradle wrapper files should normally be checked into source control.
+# See ../../README.md
 gradle-wrapper.jar
 /gradlew
 /gradlew.bat

examples/hello_world/android/.gitignore

@@ -8,6 +8,8 @@
 /captures
 GeneratedPluginRegistrant.java
 
+# Gradle wrapper files should normally be checked into source control.
+# See ../../README.md
 gradle-wrapper.jar
 /gradlew
 /gradlew.bat

examples/layers/android/.gitignore

@@ -8,6 +8,8 @@
 /captures
 GeneratedPluginRegistrant.java
 
+# Gradle wrapper files should normally be checked into source control.
+# See ../../README.md
 gradle-wrapper.jar
 /gradlew
 /gradlew.bat

examples/platform_channel/android/.gitignore

@@ -8,6 +8,8 @@
 /captures
 GeneratedPluginRegistrant.java
 
+# Gradle wrapper files should normally be checked into source control.
+# See ../../README.md
 gradle-wrapper.jar
 /gradlew
 /gradlew.bat

examples/platform_view/android/.gitignore

@@ -8,6 +8,8 @@
 /captures
 GeneratedPluginRegistrant.java
 
+# Gradle wrapper files should normally be checked into source control.
+# See ../../README.md
 gradle-wrapper.jar
 /gradlew
 /gradlew.bat

examples/stocks/android/.gitignore

@@ -8,6 +8,8 @@
 /captures
 GeneratedPluginRegistrant.java
 
+# Gradle wrapper files should normally be checked into source control.
+# See ../../README.md
 gradle-wrapper.jar
 /gradlew
 /gradlew.bat