افزایه Secrets Gradle

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

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

برای مشاهده نمونه کامل استفاده از «افزایه Secrets Gradle ویژه Android» برای دسترسی به کلید میانای برنامه‌سازی کاربردی، راه‌اندازی پروژه «استودیو Android» را ببینید.

نصب و استفاده

برای نصب افزایه Secrets Gradle ویژه Android و ذخیره کلید میانای برنامه‌سازی کاربردی:

  1. در Android Studio، فایل build.gradle.kts سطح بالا یا build.gradle را باز کنید و کد زیر را به بلوک plugins اضافه کنید.

    Kotlin

    plugins {
    // ...
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") version "2.0.1" apply false
}

    Groovy

    plugins {
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
}
  2. فایل build.gradle.kts یا build.gradle در سطح ماژول را باز کنید و کد زیر را به عنصر plugins اضافه کنید.

    Kotlin

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

    Groovy

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

  5. فایل local.defaults.properties را در دایرکتوری سطح بالا، همان پوشه فایل secrets.properties، ایجاد کنید و سپس کد زیر را اضافه کنید.

    PLACES_API_KEY=DEFAULT_API_KEY

    هدف این فایل ارائه مکان پشتیبان برای کلید API است اگر فایل secrets.properties پیدا نشود تا ساخت‌ها ناموفق نباشند. این مشکل زمانی رخ می‌دهد که برنامه را از سیستم کنترل نسخه‌ای شبیه‌سازی کنید که secrets.properties را حذف می‌کند و هنوز فایل secrets.properties را به‌صورت محلی برای ارائه کلید میانای برنامه‌سازی کاربردی خود ایجاد نکرده‌اید.

  6. در Android Studio، فایل build.gradle.kts یا build.gradle سطح ماژول را باز کنید و ویژگی secrets را ویرایش کنید. اگر دارایی secrets وجود ندارد، آن را اضافه کنید.

    خصوصیات افزایه را ویرایش کنید تا propertiesFileName را روی "secrets.properties" تنظیم کنید، defaultPropertiesFileName را روی "local.defaults.properties" تنظیم کنید، و هر خصوصیت دیگری را تنظیم کنید.

    Kotlin

    secrets {
    // To add your Maps API key to this project:
    // 1. If the secrets.properties file does not exist, create it in the root directory (the same folder as the root 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"
}

    Groovy

    secrets {
    // To add your Maps API key to this project:
    // 1. If the secrets.properties file does not exist, create it in the root directory (the same folder as the root 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"
}

قدم بعدی چیست