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

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

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

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

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

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

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

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

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

في الأمثلة التالية، استبدِل 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" حول أفضل الممارسات المتعلّقة بأمان واجهة برمجة التطبيقات.

لتسهيل هذه المهمة، يمكنك استخدام مستندات GitHub المكوّن الإضافي Secrets Gradle لأجهزة 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 لمعرفة كيفية تضمين إشعارات البرامج المفتوحة المصدر.

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

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