البدء

من خلال دمج حزمة SDK للتنقل في نظام التشغيل Android، يستطيع تطبيقك تجاوز الارتباط بعرض خريطة خارجي. باستخدام التنقل في خرائط Google، يمكن أن يوفر تطبيقك استرجاعًا ديناميكيًا وتقارير أحادية النظر للبيانات حول رحلة السائق.

يعرض لك هذا الدليل مشروعًا على "استوديو Android" وكيفية دمج حزمة تطوير البرامج (SDK) للتنقّل وتشغيل التطبيق التجريبي المقدَّم مع حزمة تطوير البرامج (SDK).

حزمة SDK للتنقّل هي مكتبة ثابتة (aar.) تتيح لك التحكّم في الشكل والصوت للتنقّل في تطبيقك. وللحصول على تفاصيل حول المكتبة، يُرجى فتح مرجع حزمة تطوير البرامج (SDK) للتنقل (Javadoc) في نافذة منفصلة.

الاستعداد

لبدء استخدام SDK للتنقل في نظام Android، تأكد من توفر العناصر التالية:

  • ممثّل "منصة خرائط Google" الذي يوفّر إمكانية الوصول إلى ما يلي:

    • مفتاح واجهة برمجة تطبيقات تم توفيره للاستخدام مع حزمة تطوير البرامج (SDK) للتنقّل. عليك تقديم رقم تعريف المشروع الذي يمكنك العثور عليه في لوحة البيانات الرئيسية في Google Cloud Console، ضمن اسم المشروع.

    • ملف ZIP الذي يحتوي على:

      • ملف المكتبة الثابت .aar في دليل libs/ الذي يحتوي على حزمة تطوير البرامج (SDK) الخاصة بالتنقل كحزمة aar
      • ملفات نصية للترخيص وروابط تؤدي إلى بنود الاستخدام والاتفاقيات.
      • تطبيق تجريبي لاستيراده كمشروع جديد في "استوديو Android" تتضمن ملفات التطبيق لإنشاء التطبيق التجريبي في استوديو Android باستخدام Gradle وMaven.

  • استوديو Android، بيئة التطوير الموصى بها لإنشاء تطبيق باستخدام حزمة SDK للتنقل. هذه المستندات مخصّصة للمستخدمين الذين لديهم دراية بمفاهيم تطوير Android والبرمجة البرمجية الموجّهة. يجب أيضًا أن تكون على دراية بخرائط Google من وجهة نظر المستخدم.

الحصول على حزمة تطوير البرامج (SDK) والتطبيق التجريبي والمستندات

بعد تنزيل ملف SDK وفك ضغطه، يمكنك فحص التطبيق التجريبي وتشغيله.

يوفر التطبيق التجريبي إصدارًا ينفِّذ فئة NavigationFragment وخيارًا ينفِّذ فئة NavigationView. يتم تشغيل الصيغة NavigationFragment تلقائيًا وتعرض مسار تنقّل كما هو موضّح في الصورة التالية.

  1. باستخدام مدير الملفات المفضّل لديك، انتقِل إلى الدليل الذي يتضمّن ملفات SDK.

  2. انسخ مكتبة SDK للتنقل في دليل app/libs لمشروع demo:

    على سبيل المثال، يمكنك تشغيل cp libs/*.aar demo/app/libs في الوحدة الطرفية لنظام التشغيل Linux.

  3. في استوديو Android، يمكنك استيراد تطبيق الإصدار التجريبي والسماح بتشغيل Gradle.

  4. افتح AndroidManifest.xml للتطبيق وعدِّل قيمة السمة API_KEY:

    <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.navigationapidemo" >

    <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="YOUR_API_KEY"/>
    </application>
</manifest>

  5. انقر على إنشاء وافحص تفاصيل تنفيذ حزمة تطوير البرامج (SDK).

    • في فئة جافا، لاحظ رمز التنفيذ.

    • في ملف xml للتخطيط، لاحظ تصميم التخطيط ونصه.

    • في ملف Build.gradle، لاحظ حزمة SDK في التبعيات.

تشغيل التطبيق

  1. وصِّل جهاز Android بجهاز الكمبيوتر أو استخدِم أحد المحاكيات.

    • جهاز Android يمكنك الرجوع إلى instructions لتفعيل خيارات المطوّرين على جهاز Android وإعداد نظامك لاكتشاف الجهاز.
    • المحاكي: يمكنك استخدام مدير جهاز Android الافتراضي (AVD) لضبط إعدادات جهاز افتراضي. عند اختيار المحاكي، تأكد من اختيار صورة تتضمن Google APIs.

  2. في استوديو Android، انقر على خيار القائمة تشغيل (أو رمز زر التشغيل)، ثم اختَر هدف نشر.

  3. في تطبيق العرض التوضيحي للتنقل، اختر تعيين الوجهة، ثم اتبع الطلبات لتحديد موقع وبدء تشغيل محاكاة التنقل.

إنشاء صيغة العرض

يتضمن التطبيق التجريبي خيارًا للعرض.

  1. في استوديو Android، افتح التطبيق التجريبي وانقر على علامة تبويب "نُسخ الإصدارات" في نافذة "إنشاء".

  2. في نافذة إنشاء الصيغ، اختَر viewDebug وستتغير قائمة الملفات.

  3. افحص تفاصيل تنفيذ حزمة تطوير البرامج (SDK) لفئة NavigationView.

    • في NavViewActivity.java، لاحِظ رمز التنفيذ.

    • في Activity_Nav_View.xml، لاحِظ تصميم التنسيق والنص.

  4. أنشئ التطبيق وشغِّله. يتغير اسم التطبيق للإشارة إلى الإصدار الذي تم إنشاؤه. وبخلاف ذلك، يختلف كائن العرض فقط.

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

ادمج حزمة SDK للتنقل لنظام التشغيل Android في تطبيقك الخاص.