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

لإعداد مشروع على Google Cloud Console من أجل استخدام حزمة تطوير البرامج (SDK) الخاصة بالسائق لنظام التشغيل Android، اتّبِع الخطوات التالية.

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

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

إعداد مشروع تطبيق الأجهزة الجوّالة

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

لضبط مشروع تطبيقك المتوافق مع الأجهزة الجوّالة، اتّبِع الخطوات التالية:

  1. إذا لم يكن لديك مشروع تطوير في Google Cloud Console ومفتاح واجهة برمجة تطبيقات لمشروع التنقّل، عليك إعدادهما. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء مشروع Fleet Engine.
  2. في وحدة تحكّم Google Cloud، اختَر مشروع وحدة تحكّم Google Cloud ومفتاح واجهة برمجة التطبيقات نفسهما اللذين تستخدمهما في Fleet Engine.
  3. اختَر واجهات برمجة التطبيقات والخدمات وابحث عن حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android وفعِّلها.

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

تتوفّر حزمة تطوير البرامج (SDK) للسائقين من مستودع Maven من Google. يتضمّن المستودع ملفات نموذج عناصر المشروع (‎.pom) الخاصة بحزمة SDK ووثائق Javadocs.

لإضافة حزمة تطوير البرامج (SDK) للسائق إلى تطبيقك، أضِف تبعيات حزمة تطوير البرامج (SDK) للسائق وحزمة تطوير البرامج (SDK) للتنقّل إلى إعدادات Gradle أو Maven.

في المثال التالي، استبدِل VERSION_NUMBER بالإصدار المحدّد من حزمة تطوير البرامج (SDK) للسائق.

Gradle

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

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

Maven

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

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation.driver</groupId>
    <artifactId>transportation-driver</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>5.0.0</version>
  </dependency>
</dependencies>

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

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

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

  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.driverapidemo" >
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_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 الذي تم إلغاء أرشفته.

يُرجى الرجوع إلى تضمين إشعارات البرامج المفتوحة المصدر لمعرفة كيفية تضمين إشعارات البرامج المفتوحة المصدر.

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

تحديد الاعتماديات