ضبط مشروع في وحدة تحكّم Google Cloud

لإعداد Google Cloud Console واستخدامه مع حزمة Consumer SDK لنظام Android، اتّبِع الخطوات التالية.

1. إعداد مشروع التطوير.
2. إضافة حزمة Consumer SDK إلى تطبيقك.
3. إضافة مفتاح واجهة برمجة التطبيقات إلى تطبيقك.
4. تضمين عمليات تحديد المصدر المطلوبة في تطبيقك.

لمزيد من التفاصيل حول كل خطوة، يُرجى الاطّلاع على الأقسام التالية.

ملاحظة: يجب أن يستهدف تطبيقك minSdkVersion 23 أو إصدارًا أحدث.

إعداد مشروع التطوير

إذا لم يكن لديك مشروع تطوير على Google Cloud Console ومفتاح واجهة برمجة تطبيقات لمشروعك المتعلّق بخدمات النقل، عليك إعداد مشروع ومفتاح. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة إنشاء مشروعك في دليل Fleet Engine.

عند اختيار مشروع التطوير لحزمة Consumer SDK، اختَر مشروع Google Cloud Console نفسه ومفتاح واجهة برمجة التطبيقات اللذين تستخدمهما في Fleet Engine.

إضافة حزمة Consumer SDK إلى تطبيقك

تتوفّر حزمة Consumer SDK من خلال مستودع Google Maven. ويتضمّن المستودع ملفات نموذج عنصر المشروع (.pom) وJavadocs لحزمة SDK. لإضافة حزمة Consumer SDK إلى تطبيقك، أضِف حزمة Consumer SDK وحزمة Maps SDK إلى إعداد Gradle أو Maven.

ملاحظة: تعتمد حزمة Consumer SDK على حزمة Maps SDK. اضبط الاعتمادية على إصدار محدّد بشكل صريح من حزمة Maps SDK، كما هو موضّح في هذا المثال. وإلا، ستستخدم حزمة Consumer SDK الحد الأدنى من الإصدار المطلوب من حزمة Maps SDK، ما قد يؤدي إلى حدوث مشاكل إذا كان تطبيقك يعتمد على الميزات المتوفّرة في الإصدارات الأحدث من حزمة Maps SDK.

في الأمثلة التالية، استبدِل VERSION_NUMBER بالإصدار المطلوب من حزمة Consumer SDK:

Gradle

أضِف ما يلي إلى ملف build.gradle:

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

Maven

أضِف ما يلي إلى ملف pom.xml:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

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

بعد إضافة حزمة Consumer SDK إلى تطبيقك، أضِف مفتاح واجهة برمجة التطبيقات. يجب استخدام مفتاح واجهة برمجة التطبيقات الخاص بالمشروع الذي حصلت عليه عند إعداد مشروع التطوير. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد مشروع التطوير في الخطوة 3 من هذا الدليل.

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

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

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

لتثبيت المكوّن الإضافي وتخزين مفتاح واجهة برمجة التطبيقات، اتّبِع الخطوات التالية:

1. افتح ملف build.gradle على مستوى الجذر وأضِف الرمز البرمجي التالي إلى العنصر dependencies ضِمن buildscript.

   Groovy

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

   Kotlin

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

2. افتح ملف build.gradle على مستوى التطبيق وأضِف الرمز البرمجي التالي إلى العنصر plugins.

   Groovy

   id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
   

   Kotlin

   id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
   

3. إذا كنت تستخدم "استوديو Android"، عليك مزامنة مشروعك مع Gradle. لمعرفة التفاصيل، يُرجى الاطّلاع على مزامنة مشروعك مع Gradle في مستندات Android.

4. افتح ملف local.properties في دليل مستوى مشروعك، ثم أضِف الرمز البرمجي التالي. استبدِل YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات.

   MAPS_API_KEY=YOUR_API_KEY

5. في ملف AndroidManifest.xml، انتقِل إلى com.google.android.geo.API_KEY وعدِّل السمة android:value على النحو التالي:

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="${MAPS_API_KEY}" />

يوضّح المثال التالي بيانًا كاملاً لنموذج تطبيق:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.consumerapidemo">
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:supportsRtl="true"
            android:theme="@style/_AppTheme">

            <meta-data
                android:name="com.google.android.geo.API_KEY"
                android:value="${MAPS_API_KEY}" />

            <activity android:name=".MainActivity">
                <intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>
            </activity>
        </application>
    </manifest>

تضمين عمليات تحديد المصدر المطلوبة في تطبيقك

إذا كنت تستخدم حزمة Consumer SDK في تطبيقك، عليك تضمين نص تحديد المصدر وتراخيص البرامج المفتوحة المصدر كجزء من الإشعارات القانونية لتطبيقك. من الأفضل تضمين عمليات تحديد المصدر كعنصر قائمة مستقل أو كجزء من عنصر القائمة لمحة.

يمكنك العثور على معلومات الترخيص في ملف "third_party_licenses.txt" في ملف AAR غير المؤرشف.

يُرجى الرجوع إلى https://developers.google.com/android/guides/opensource لمعرفة كيفية تضمين إشعارات البرامج المفتوحة المصدر.

الخطوات التالية

الحصول على رموز مميزة للمصادقة