إعداد مشروع في "استوديو Android"

لإعداد تطبيقك لاستخدام حزمة تطوير برامج الأماكن لأجهزة Android، يُرجى اتباع الخطوات التالية. وهي مطلوبة لجميع التطبيقات التي تستخدم حزمة تطوير برامج الأماكن لنظام التشغيل Android.

الخطوة 1: إعداد "استوديو Android"

  1. يجب توفّر الإصدار Android Studio Arctic Fox أو إصدار أحدث. ننصحك بتنزيله وتثبيته إذا لم يسبق لك تنزيله.
  2. تأكَّد من استخدام الإصدار 7.0 أو الإصدارات الأحدث من مكوّن Gradle الإضافي لنظام التشغيل Android في "استوديو Android".

الخطوة 2. إعداد حزمة تطوير البرامج (SDK)

تتوفّر حزمة تطوير برامج الأماكن لأجهزة Android من خلال مستودع Maven من Google. لإضافة حزمة SDK إلى تطبيقك، قم بما يلي:

  1. في ملف settings.gradle ذي المستوى الأعلى، ضمِّن بوابة المكوّنات الإضافية في Gradle ومستودع Google Maven ومستودع Maven المركزي ضمن مجموعة pluginManagement. يجب أن تظهر مجموعة pluginManagement قبل أي عبارات أخرى في النص البرمجي.
    pluginManagement {
        repositories {
            gradlePluginPortal()
            google()
            mavenCentral()
        }
    } 
  2. في ملف settings.gradle ذي المستوى الأعلى، ضمِّن مستودع Maven من Google ومستودع Maven المركزي ضمن المجموعة dependencyResolutionManagement:
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
            mavenCentral()
        }
    } 
  3. في القسم dependencies من ملف build.gradle على مستوى الوحدة، أضِف تبعية إلى حزمة تطوير البرامج (SDK) الخاصة بـ "الأماكن" لنظام التشغيل Android:

    dependencies {
        implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
        implementation 'com.google.android.libraries.places:places:3.3.0'
    }
    
  4. في ملف build.gradle على مستوى الوحدة، اضبط compileSdk وminSdk على القيم التالية:
    android {
        compileSdk 31
    
        defaultConfig {
            minSdk 21
            // ...
        }

الخطوة 3: إضافة مفتاح واجهة برمجة التطبيقات إلى المشروع

يصف هذا القسم طريقة تخزين مفتاح واجهة برمجة التطبيقات حتى يتمكن تطبيقك من الرجوع إليه بأمان. يجب عدم التحقق من مفتاح واجهة برمجة التطبيقات في نظام التحكم في الإصدار الذي تستخدمه، لذلك ننصحك بتخزينه في ملف secrets.properties الموجود في الدليل الجذري لمشروعك. للحصول على مزيد من المعلومات حول ملف secrets.properties، يمكنك الاطّلاع على ملفات خصائص Gradle.

لتبسيط هذه المهمة، ننصحك باستخدام المكوّن الإضافي Secrets Gradle الإضافي لنظام التشغيل Android.

لتثبيت المكوّن الإضافي Secrets Gradle الإضافي لنظام التشغيل Android في مشروع "خرائط Google"، اتّبِع الخطوات التالية:

  1. في "استوديو Android"، افتح ملف build.gradle على مستوى المشروع وأضِف الرمز التالي إلى العنصر dependencies ضمن buildscript.

    رائع

    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")
        }
    }
    
  2. Open your module-level build.gradle file and add the following code to the plugins element.

    Groovy

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

    Kotlin

    plugins {
        id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
    }
  3. Save the file and sync your project with Gradle.
  4. Open the secrets.properties in your project level directory, and then add the following code. Replace YOUR_API_KEY with your API key.
    MAPS_API_KEY=YOUR_API_KEY