מומלץ מאוד לא להכניס מפתח API למערכת בקרת הגרסאות. במקום זאת, כדאי לאחסן אותו בקובץ secrets.properties מקומי, שנמצא בספריית הבסיס של הפרויקט אבל לא נכלל בבקרת הגרסאות, ואז להשתמש ב-Secrets Gradle Plugin for Android כדי לקרוא את מפתח ה-API.
הפלאגין של Secrets Gradle ל-Android קורא סודות, כולל מפתח ה-API, מקובץ מאפיינים שלא נשמר במערכת לניהול גרסאות. הפלאגין חושף את המאפיינים האלה כמשתנים במחלקה BuildConfig שנוצרה על ידי Gradle ובקובץ המניפסט של Android.
דוגמה מלאה לשימוש בפלאגין Secrets Gradle ל-Android כדי לגשת למפתח API מופיעה במאמר הגדרת פרויקט ב-Android Studio.
התקנה ושימוש
כדי להתקין את הפלאגין Secrets Gradle ל-Android ולאחסן את מפתח ה-API:
-
ב-Android Studio, פותחים את קובץ
build.gradleברמת הבסיס ומוסיפים את הקוד הבא לרכיבdependenciesבקטעbuildscript.Groovy
buildscript { dependencies { // ... classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1" } }
Kotlin
buildscript { dependencies { // ... classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1") } }
-
פותחים את הקובץ
build.gradleברמת האפליקציה ומוסיפים את הקוד הבא לרכיבplugins.Groovy
plugins { id 'com.android.application' // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' }
Kotlin
plugins { id("com.android.application") // ... id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") }
- אם אתם משתמשים ב-Android Studio, מסנכרנים את הפרויקט עם Gradle.
-
פותחים את
local.propertiesבספרייה ברמת הפרויקט ומוסיפים את הקוד הבא. מחליפים את הערךYOUR_API_KEYבמפתח ה-API שלכם.PLACES_API_KEY=YOUR_API_KEY
המאמרים הבאים
- אפשר לעיין בדף הפרויקט ב-GitHub בנושא Secrets Gradle Plugin for Android.
- במאמר הגדרה של פרויקט Android Studio יש דוגמה מלאה לשימוש בפלאגין.