From 8e47cfbe21e6e701c362e71cd9fd51c0b6bd2f69 Mon Sep 17 00:00:00 2001
From: Angela Yu <5506675+wangela@users.noreply.github.com>
Date: Fri, 16 Aug 2024 12:26:28 -0700
Subject: [PATCH] chore: update build.gradle comments for adding an API key
 (#1756)

---
 .../java/app/src/main/AndroidManifest.xml     | 28 +++++++++----------
 .../com/example/mapdemo/MainActivity.java     |  2 +-
 .../com/example/kotlindemos/MainActivity.kt   |  2 +-
 .../kotlin/app/src/main/AndroidManifest.xml   |  2 +-
 .../com/example/kotlindemos/MainActivity.kt   |  2 +-
 .../CurrentPlaceDetailsOnMap/app/build.gradle |  6 ++--
 tutorials/java/MapWithMarker/app/build.gradle |  6 ++--
 tutorials/java/Polygons/app/build.gradle      |  6 ++--
 tutorials/java/StyledMap/app/build.gradle     |  8 ++++--
 .../CurrentPlaceDetailsOnMap/app/build.gradle |  6 ++--
 .../kotlin/MapWithMarker/app/build.gradle     |  8 ++++--
 tutorials/kotlin/Polygons/app/build.gradle    |  6 ++--
 12 files changed, 48 insertions(+), 34 deletions(-)

diff --git a/ApiDemos/java/app/src/main/AndroidManifest.xml b/ApiDemos/java/app/src/main/AndroidManifest.xml
index 87e29a0ad..92fb8dc4f 100644
--- a/ApiDemos/java/app/src/main/AndroidManifest.xml
+++ b/ApiDemos/java/app/src/main/AndroidManifest.xml
@@ -1,18 +1,18 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
-  ~ Copyright 2020 Google LLC
-  ~
-  ~ Licensed under the Apache License, Version 2.0 (the "License");
-  ~ you may not use this file except in compliance with the License.
-  ~ You may obtain a copy of the License at
-  ~
-  ~      https://www.apache.org/licenses/LICENSE-2.0
-  ~
-  ~ Unless required by applicable law or agreed to in writing, software
-  ~ distributed under the License is distributed on an "AS IS" BASIS,
-  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  ~ See the License for the specific language governing permissions and
-  ~ limitations under the License.
+Copyright 2024 Google LLC
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    https://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
   -->
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
 
@@ -41,7 +41,7 @@
 
         <!--
             To add your Maps API key to this project:
-            1. Open the root project's local.properties file
+            1. Open the root project's secrets.properties file
             2. Add this line, where YOUR_API_KEY is your API key:
                 MAPS_API_KEY=YOUR_API_KEY
         -->
diff --git a/ApiDemos/java/app/src/v3/java/com/example/mapdemo/MainActivity.java b/ApiDemos/java/app/src/v3/java/com/example/mapdemo/MainActivity.java
index e308c30f2..ad79897f1 100644
--- a/ApiDemos/java/app/src/v3/java/com/example/mapdemo/MainActivity.java
+++ b/ApiDemos/java/app/src/v3/java/com/example/mapdemo/MainActivity.java
@@ -86,7 +86,7 @@ protected void onCreate(Bundle savedInstanceState) {
         list.setEmptyView(findViewById(R.id.empty));
 
         if (BuildConfig.MAPS_API_KEY.isEmpty()) {
-            Toast.makeText(this, "Add your own API key in local.properties as MAPS_API_KEY=YOUR_API_KEY", Toast.LENGTH_LONG).show();
+            Toast.makeText(this, "Add your own API key in secrets.properties as MAPS_API_KEY=YOUR_API_KEY", Toast.LENGTH_LONG).show();
         }
     }
 
diff --git a/ApiDemos/kotlin/app/src/gms/java/com/example/kotlindemos/MainActivity.kt b/ApiDemos/kotlin/app/src/gms/java/com/example/kotlindemos/MainActivity.kt
index 333c814c8..bd0257c5d 100644
--- a/ApiDemos/kotlin/app/src/gms/java/com/example/kotlindemos/MainActivity.kt
+++ b/ApiDemos/kotlin/app/src/gms/java/com/example/kotlindemos/MainActivity.kt
@@ -52,7 +52,7 @@ class MainActivity : AppCompatActivity(), AdapterView.OnItemClickListener {
         }
 
         if (BuildConfig.MAPS_API_KEY.isEmpty()) {
-            Toast.makeText(this, "Add your own API key in local.properties as MAPS_API_KEY=YOUR_API_KEY", Toast.LENGTH_LONG).show()
+            Toast.makeText(this, "Add your own API key in secrets.properties as MAPS_API_KEY=YOUR_API_KEY", Toast.LENGTH_LONG).show()
         }
     }
 
diff --git a/ApiDemos/kotlin/app/src/main/AndroidManifest.xml b/ApiDemos/kotlin/app/src/main/AndroidManifest.xml
index ee42e89db..fede1a685 100644
--- a/ApiDemos/kotlin/app/src/main/AndroidManifest.xml
+++ b/ApiDemos/kotlin/app/src/main/AndroidManifest.xml
@@ -32,7 +32,7 @@
         android:theme="@style/AppTheme">
         <!--
             To add your Maps API key to this project:
-            1. Open the root project'sl local.properties file
+            1. Open the root project'sl secrets.properties file
             2. Add this line, where YOUR_API_KEY is your API key:
                 MAPS_API_KEY=YOUR_API_KEY
         -->
diff --git a/ApiDemos/kotlin/app/src/v3/java/com/example/kotlindemos/MainActivity.kt b/ApiDemos/kotlin/app/src/v3/java/com/example/kotlindemos/MainActivity.kt
index f65bc27ec..f11c51362 100644
--- a/ApiDemos/kotlin/app/src/v3/java/com/example/kotlindemos/MainActivity.kt
+++ b/ApiDemos/kotlin/app/src/v3/java/com/example/kotlindemos/MainActivity.kt
@@ -57,7 +57,7 @@ class MainActivity : AppCompatActivity(), AdapterView.OnItemClickListener {
         }
 
         if (BuildConfig.MAPS_API_KEY.isEmpty()) {
-            Toast.makeText(this, "Add your own API key in local.properties as MAPS_API_KEY=YOUR_API_KEY", Toast.LENGTH_LONG).show()
+            Toast.makeText(this, "Add your own API key in secrets.properties as MAPS_API_KEY=YOUR_API_KEY", Toast.LENGTH_LONG).show()
         }
 
     }
diff --git a/tutorials/java/CurrentPlaceDetailsOnMap/app/build.gradle b/tutorials/java/CurrentPlaceDetailsOnMap/app/build.gradle
index cadc32bf4..636cdf01b 100644
--- a/tutorials/java/CurrentPlaceDetailsOnMap/app/build.gradle
+++ b/tutorials/java/CurrentPlaceDetailsOnMap/app/build.gradle
@@ -37,8 +37,10 @@ dependencies {
 }
 
 secrets {
-    // Optionally specify a different file name containing your secrets.
-    // If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // To add your Maps API key to this project:
+    // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // 2. Add this line, where YOUR_API_KEY is your API key:
+    //        MAPS_API_KEY=YOUR_API_KEY
     propertiesFileName = "secrets.properties"
 
     // A properties file containing default secret values. This file can be
diff --git a/tutorials/java/MapWithMarker/app/build.gradle b/tutorials/java/MapWithMarker/app/build.gradle
index 012017a53..ed548f0f6 100644
--- a/tutorials/java/MapWithMarker/app/build.gradle
+++ b/tutorials/java/MapWithMarker/app/build.gradle
@@ -35,8 +35,10 @@ dependencies {
 }
 
 secrets {
-    // Optionally specify a different file name containing your secrets.
-    // If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // To add your Maps API key to this project:
+    // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // 2. Add this line, where YOUR_API_KEY is your API key:
+    //        MAPS_API_KEY=YOUR_API_KEY
     propertiesFileName = "secrets.properties"
 
     // To add your Maps API key to this project:
diff --git a/tutorials/java/Polygons/app/build.gradle b/tutorials/java/Polygons/app/build.gradle
index 8ed67a127..e509a2ccd 100644
--- a/tutorials/java/Polygons/app/build.gradle
+++ b/tutorials/java/Polygons/app/build.gradle
@@ -35,8 +35,10 @@ dependencies {
 }
 
 secrets {
-    // Optionally specify a different file name containing your secrets.
-    // If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // To add your Maps API key to this project:
+    // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // 2. Add this line, where YOUR_API_KEY is your API key:
+    //        MAPS_API_KEY=YOUR_API_KEY
     propertiesFileName = "secrets.properties"
 
     // To add your Maps API key to this project:
diff --git a/tutorials/java/StyledMap/app/build.gradle b/tutorials/java/StyledMap/app/build.gradle
index 6ccc9f1de..1c99151d2 100644
--- a/tutorials/java/StyledMap/app/build.gradle
+++ b/tutorials/java/StyledMap/app/build.gradle
@@ -39,11 +39,13 @@ dependencies {
 }
 
 secrets {
-    // Optionally specify a different file name containing your secrets.
-    // If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // To add your Maps API key to this project:
+    // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // 2. Add this line, where YOUR_API_KEY is your API key:
+    //        MAPS_API_KEY=YOUR_API_KEY
     propertiesFileName = "secrets.properties"
 
     // A properties file containing default secret values. This file can be
     // checked in version control.
     defaultPropertiesFileName = 'local.defaults.properties'
-}
\ No newline at end of file
+}
diff --git a/tutorials/kotlin/CurrentPlaceDetailsOnMap/app/build.gradle b/tutorials/kotlin/CurrentPlaceDetailsOnMap/app/build.gradle
index 11eaf1cd6..ac1048e46 100644
--- a/tutorials/kotlin/CurrentPlaceDetailsOnMap/app/build.gradle
+++ b/tutorials/kotlin/CurrentPlaceDetailsOnMap/app/build.gradle
@@ -48,8 +48,10 @@ dependencies {
 }
 
 secrets {
-    // Optionally specify a different file name containing your secrets.
-    // If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // To add your Maps API key to this project:
+    // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // 2. Add this line, where YOUR_API_KEY is your API key:
+    //        MAPS_API_KEY=YOUR_API_KEY
     propertiesFileName = "secrets.properties"
 
     // To add your Maps API key to this project:
diff --git a/tutorials/kotlin/MapWithMarker/app/build.gradle b/tutorials/kotlin/MapWithMarker/app/build.gradle
index 7ea9c3ded..68ba7e1bb 100644
--- a/tutorials/kotlin/MapWithMarker/app/build.gradle
+++ b/tutorials/kotlin/MapWithMarker/app/build.gradle
@@ -43,10 +43,12 @@ dependencies {
 }
 
 secrets {
-    // Optionally specify a different file name containing your secrets.
-    // If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // To add your Maps API key to this project:
+    // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // 2. Add this line, where YOUR_API_KEY is your API key:
+    //        MAPS_API_KEY=YOUR_API_KEY
     propertiesFileName = "secrets.properties"
-    
+
     // To add your Maps API key to this project:
     // 1. Open the root project's local.properties file
     // 2. Add this line, where YOUR_API_KEY is your API key:
diff --git a/tutorials/kotlin/Polygons/app/build.gradle b/tutorials/kotlin/Polygons/app/build.gradle
index 3d200a093..519b1dedd 100644
--- a/tutorials/kotlin/Polygons/app/build.gradle
+++ b/tutorials/kotlin/Polygons/app/build.gradle
@@ -41,8 +41,10 @@ dependencies {
 }
 
 secrets {
-    // Optionally specify a different file name containing your secrets.
-    // If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // To add your Maps API key to this project:
+    // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
+    // 2. Add this line, where YOUR_API_KEY is your API key:
+    //        MAPS_API_KEY=YOUR_API_KEY
     propertiesFileName = "secrets.properties"
 
     // To add your Maps API key to this project: