ضبط مشروع على Google Cloud Console

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

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

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

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

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

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

إضافة حزمة تطوير البرامج (SDK) للمستهلكين إلى تطبيقك

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

في الأمثلة التالية، استبدِل VERSION_NUMBER بالإصدار المطلوب من حزمة تطوير البرامج (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>

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

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

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

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

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

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

    رائع

    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.

    رائع

    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>

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

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

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

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

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

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