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

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

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

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

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

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

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

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

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

تتوفّر حزمة Driver SDK من مستودع Google Maven. يتضمّن المستودع ملفات Project Object Model (.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 إلى تطبيقك، أضِف مفتاح واجهة برمجة التطبيقات. يجب استخدام مفتاح واجهة برمجة التطبيقات الخاص بالمشروع الذي حصلت عليه عند إعداد مشروع التطوير. لمزيد من التفاصيل، يُرجى الاطّلاع على إعداد مشروع تطبيقك على الأجهزة الجوّالة.

يوضّح هذا القسم كيفية تخزين مفتاح واجهة برمجة التطبيقات بطريقة تتيح لتطبيقك الرجوع إليه بشكل أكثر أمانًا. لمزيد من المعلومات حول أفضل الممارسات المتعلّقة بأمان مفتاح واجهة برمجة التطبيقات، يمكنك الاطّلاع على مقالة أفضل الممارسات المتعلّقة بأمان واجهة برمجة التطبيقات في &quot;منصة خرائط Google&quot;.

لتسهيل هذه المهمة، يمكنك استخدام مستندات 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 غير المؤرشف.

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

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

تعريف التبعيات