پلاگین Secrets Gradle

گوگل اکیداً توصیه می‌کند که کلید API را در سیستم کنترل نسخه خود بررسی نکنید. در عوض، باید آن را در یک فایل محلی secrets.properties ذخیره کنید که در دایرکتوری ریشه پروژه شما قرار دارد اما از کنترل نسخه مستثنی است و سپس از افزونه Secrets Gradle برای اندروید برای خواندن کلید API استفاده کنید.

افزونه‌ی Secrets Gradle برای اندروید، اطلاعات محرمانه، از جمله کلید API، را از یک فایل ویژگی که در سیستم کنترل نسخه بررسی نشده است، می‌خواند. سپس این افزونه، آن ویژگی‌ها را به عنوان متغیرهایی در کلاس BuildConfig تولید شده توسط Gradle و در فایل مانیفست اندروید نمایش می‌دهد.

برای مشاهده‌ی یک مثال کامل از نحوه‌ی استفاده از افزونه‌ی Secrets Gradle برای اندروید جهت دسترسی به کلید API، به بخش «راه‌اندازی یک پروژه‌ی اندروید استودیو» مراجعه کنید.

نصب و استفاده

برای نصب افزونه Secrets Gradle برای اندروید و ذخیره کلید API خود:

  1. در اندروید استودیو، فایل build.gradle سطح ریشه خود را باز کنید و کد زیر را به عنصر dependencies در زیر buildscript اضافه کنید.

    گرووی 

    buildscript {
    dependencies {
        // ...
        classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"
    }
}

    کاتلین 

    buildscript {
    dependencies {
        // ...
        classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1")
    }
}
  2. فایل build.gradle سطح برنامه خود را باز کنید و کد زیر را به عنصر plugins اضافه کنید.

    گرووی 

    plugins {
    id 'com.android.application'
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
}

    کاتلین 

    plugins {
    id("com.android.application")
    // ...
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
}
  3. اگر از اندروید استودیو استفاده می‌کنید، پروژه خود را با Gradle همگام‌سازی کنید .
  4. فایل local.properties را در دایرکتوری سطح پروژه خود باز کنید و سپس کد زیر را اضافه کنید. به جای YOUR_API_KEY ، کلید API خود را قرار دهید. 
    PLACES_API_KEY=YOUR_API_KEY

قدم بعدی چیست؟