حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات السريعة على Android

يمكنك إنشاء تطبيق Android يعرض خريطة باستخدام نموذج "خرائط Google" في "استوديو Android". إذا كان لديك مشروع حالي على "استوديو Android" تريد إعداده، يمكنك الاطّلاع على صفحة إعدادات المشروع.

إنّ دليل البدء السريع هذا موجَّه إلى المطوّرين الذين لديهم دراية بتطوير Android الأساسي باستخدام لغة Java أو Kotlin.

إعداد بيئة التطوير

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

• لاستخدام جهاز Android، اتّبِع التعليمات الواردة في المقالة تشغيل التطبيقات على جهاز.
• لاستخدام محاكي Android، يمكنك إنشاء جهاز افتراضي وتثبيت المحاكي باستخدام مدير جهاز Android الافتراضي (AVD) الذي يتضمّن "استوديو Android".

إنشاء مشروع على "خرائط Google" في "استوديو Android"

تم تغيير إجراء إنشاء مشروع "خرائط Google" في "استوديو Android" في إصدار Flamingo والإصدارات اللاحقة من Android Studio. احرص على اتّباع الخطوات أدناه في إصدار "استوديو Android" الذي تستخدمه

1. افتح "استوديو Android" وانقر على إنشاء مشروع جديد في نافذة مرحبًا بك في استوديو Android.

2. في نافذة مشروع جديد، ضمن فئة الهاتف والجهاز اللوحي، اختَر نشاط فارغ، ثم انقر على التالي.

3. املأ نموذج نشاط "خرائط Google":

   • اضبط اللغة على Java أو Kotlin. يتم دعم كلتا اللغتين بالكامل من خلال حزمة SDK للخرائط لنظام Android. للاطّلاع على مزيد من المعلومات حول لغة Kotlin، يُرجى الاطّلاع على مقالة تطوير تطبيقات Android باستخدام لغة Kotlin.

   • اضبط الحد الأدنى لحزمة تطوير البرامج (SDK) على إصدار حزمة SDK متوافق مع جهاز الاختبار. يجب اختيار إصدار أعلى من الحدّ الأدنى المطلوب للإصدار 18.0.x من حزمة "SDK للخرائط" لنظام التشغيل Android، وهو المستوى 19 لواجهة برمجة تطبيقات Android (Android 4.4 أو KitKat) أو الإصدارات الأحدث. راجع ملاحظات الإصدار للحصول على أحدث المعلومات حول متطلبات إصدار SDK.

4. انقر على إنهاء.

   يشغّل "استوديو Android" مشروع Gradle ويُنشئ المشروع. وقد تستغرق هذه العملية بعض الوقت.

5. عند انتهاء الإصدار، سيفتح "استوديو Android" ملفَّي AndroidManifest.xml وMapsActivity. قد يكون لنشاطك اسم مختلف، ولكنّه هو الاسم الذي ضبطته أثناء الإعداد.

6. أضف نشاط المشاهَدات في "خرائط Google":

   1. انقر بزر الماوس الأيمن على الحزمة التي تريد إضافة نشاط طرق عرض خرائط Google إليها.
   2. حدد جديد > Google > نشاط بانوراميات في خرائط Google.

   

   لمزيد من المعلومات، اطّلِع على مقالة إضافة رمز من نموذج.

7. يحتوي الملف AndroidManifest.xml على إرشادات حول الحصول على مفتاح واجهة برمجة التطبيقات لخرائط Google ثم إضافته إلى ملف local.properties. لا تضِف مفتاح واجهة برمجة التطبيقات إلى ملف AndroidManifest.xml. يؤدي هذا الإجراء إلى تخزين مفتاح واجهة برمجة التطبيقات بشكل أقل أمانًا. بدلاً من ذلك، اتّبِع التعليمات الواردة في الأقسام التالية لإنشاء مشروع على السحابة الإلكترونية وضبط مفتاح واجهة برمجة التطبيقات.

إعداد مشروعك على Google Cloud

أكمِل خطوات إعداد Cloud Console المطلوبة بالنقر على علامات التبويب التالية:

gcloud projects create "PROJECT"

gcloud services enable \
    --project "PROJECT" \
    "maps-android-backend.googleapis.com"

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

إضافة مفتاح واجهة برمجة التطبيقات إلى تطبيقك

يصف هذا القسم طريقة تخزين مفتاح واجهة برمجة التطبيقات حتى يتمكن تطبيقك من الرجوع إليه بأمان. يجب عدم التحقق من مفتاح واجهة برمجة التطبيقات في نظام التحكم في الإصدار الذي تستخدمه، لذلك ننصحك بتخزينه في ملف 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