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

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

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

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

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

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

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

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

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

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

لإضافة حزمة تطوير البرامج (SDK) لبرنامج التشغيل إلى تطبيقك، أضِف حزمة تطوير البرامج (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.

    رائع

    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.

  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 غير المؤرشف.

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

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

الإفصاح عن التبعيات