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

لإعداد مشروع في Google Cloud Console وضبطه لاستخدام Driver SDK لأجهزة Android، اتّبِع الخطوات التالية.

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

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

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

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

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

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

إضافة Driver SDK إلى تطبيقك

تتوفّر Driver SDK من خلال مستودع Google Maven. ويتضمّن المستودع ملفات نموذج كائن المشروع (.pom) وJavadocs لحزمة SDK.

لإضافة Driver SDK إلى تطبيقك، أضِف تبعيات Driver SDK وNavigation SDK إلى إعداد Gradle أو Maven.

في المثال التالي، استبدِل VERSION_NUMBER بالإصدار الذي اخترته من Driver 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>

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

بعد إضافة Driver 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>

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

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

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

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

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

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