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

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

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

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

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

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

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

إضافة حزمة تطوير البرامج (SDK) لإصدار Consumer إلى تطبيقك

تتوفّر حزمة تطوير البرامج (SDK) للمستهلك من مستودع Google Maven. يتضمّن المستودع ملفات Project Object Model (‎.pom) لحزمة SDK وملفات Javadoc. لإضافة حزمة تطوير البرامج (SDK) للمستهلك إلى تطبيقك، أضِف حزمة تطوير البرامج (SDK) للمستهلك وحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" إلى إعدادات IDE 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 Plugin for 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 Studio، يمكنك مزامنة مشروعك مع 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 للتعرّف على كيفية تضمين إشعارات المصادر المفتوحة.

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

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