لإعداد مشروع على Google Cloud Console وضبطه لاستخدام حزمة تطوير البرامج (SDK) لبرنامج Driver لنظام التشغيل Android، اتّبِع الخطوات التالية.
- إعداد مشروع تطبيقك المتوافق مع الأجهزة الجوّالة
- أضِف حزمة تطوير البرامج (SDK) لبرنامج Driver إلى تطبيقك.
- أضِف مفتاح واجهة برمجة التطبيقات إلى تطبيقك.
- تضمين الإحالات المطلوبة في تطبيقك
لمزيد من التفاصيل حول كل خطوة، يُرجى الاطّلاع على الأقسام التالية.
إعداد مشروع تطبيقك للأجهزة الجوّالة
يصف هذا القسم كيفية ضبط مشروع تطبيقك المتوافق مع الأجهزة الجوّالة لحزمة تطوير برامج (SDK) Driver .
لضبط إعدادات مشروع تطبيقك المتوافق مع الأجهزة الجوّالة، اتّبِع الخطوات التالية:
- إذا لم يكن لديك مشروع تطوير على Google Cloud Console ومفتاح لواجهة برمجة تطبيقات لمشروع التنقل الخاص بك، فإنك بحاجة إلى إعداد واحدة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء مشروع Fleet Engine.
- في Google Cloud Console، اختَر مشروع Google Cloud Console و مفتاح واجهة برمجة التطبيقات نفسهما اللذَين تستخدمهما في Fleet Engine.
- حدد واجهات برمجة التطبيقات الخدمات والبحث عن وتمكين حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
إضافة حزمة تطوير البرامج (SDK) لبرنامج Driver إلى تطبيقك
تتوفّر حزمة Driver SDK في مستودع Google Maven. المستودع يتضمّن ملفات نموذج كائن المشروع (pom.) لحزمة تطوير البرامج (SDK) وJavadocs.
لإضافة حزمة Driver SDK إلى تطبيقك، أضِف تبعيات حزمة Driver SDK وحزمة Navigation 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>
إضافة مفتاح واجهة برمجة التطبيقات إلى تطبيقك
بعد إضافة حزمة Driver SDK إلى تطبيقك، أضِف مفتاح واجهة برمجة التطبيقات. يجب استخدام مفتاح واجهة برمجة التطبيقات للمشروع الذي حصلت عليه عند إعداد مشروع التطوير. بالنسبة للمزيد من التفاصيل، يُرجى الاطّلاع على إعداد مشروع تطبيقك للأجهزة الجوّالة.
يوضّح هذا القسم كيفية تخزين مفتاح واجهة برمجة التطبيقات ليكون أكثر أمانًا. التي يشير إليها تطبيقك. لمزيد من المعلومات حول أفضل ممارسات الأمان لمفتاح واجهة برمجة التطبيقات، يُرجى الاطّلاع على مقالة "منصة خرائط Google" حول أفضل ممارسات أمان واجهات برمجة التطبيقات.
لتبسيط هذه المهمة، يمكنك استخدام وثائق GitHub المكوّن الإضافي السري لنظام Gradle المتوافق مع Android
لتثبيت المكوّن الإضافي وتخزين مفتاح واجهة برمجة التطبيقات، يمكنك اتباع الخطوات التالية:
افتح ملف
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") } }
افتح ملف
build.gradle
على مستوى التطبيق وأضِف الرمز التالي إلى العنصرplugins
.رائع
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
إذا كنت تستخدم "استوديو Android"، يمكنك مزامنة مشروعك مع Gradle. للتعرّف على التفاصيل، يُرجى الاطّلاع على مقالة مزامنة مشروعك باستخدام Gradle.
افتح
local.properties
في دليل مستوى المشروع، ثم أضِفه. التعليمة البرمجية التالية. استبدِلYOUR_API_KEY
بمفتاح واجهة برمجة التطبيقات الخاص بك.MAPS_API_KEY=YOUR_API_KEY
في ملف
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 غير المؤرشف.
راجِع مقالة تضمين إشعارات المصادر المفتوحة للتعرّف على كيفية تضمين إشعارات المصادر المفتوحة.