من خلال دمج حزمة تطوير البرامج Navigation SDK لنظام التشغيل Android، يمكن لتطبيقك إجراء المزيد من الإجراءات غير ربطه بعرض خريطة خارجي. من خلال ميزة التنقّل في "خرائط Google"، يمكن لتطبيقك أن يقدّم ميزة dynamikalemet retrieval وإعداد تقارير سريعة عن البيانات المتعلّقة برحلة المستخدِم. يوضّح هذا الدليل كيفية تشغيل تطبيقات Navigation SDK التجريبية، والتي تتوفّر على GitHub.
الاستعداد
للبدء باستخدام حزمة تطوير البرامج Navigation SDK، تأكَّد من توفُّر العناصر التالية.
- مفتاح واجهة برمجة تطبيقات تم إعداده للاستخدام مع حزمة Navigation SDK اطّلِع على استخدام مفاتيح واجهة برمجة التطبيقات لمزيد من المعلومات عن إنشاء المفاتيح وفرض قيود عليها.
- عنصر حزمة SDK تأكَّد من ضبط مشروعك ل استخدام Maven لحزمة تطوير البرامج (SDK) للتنقّل.
- تطبيق واحد أو أكثر من التطبيقات التجريبية
- استوديو Android: بيئة التطوير المقترَحة لإنشاء تطبيق باستخدام حزمة تطوير البرامج (SDK) لنظام التنقّل
تم تصميم هذه المستندات للأشخاص المطلعين على تطوير تطبيقات Android و مفاهيم البرمجة المستندة إلى الكائنات. يجب أيضًا أن تكون على دراية بخرائط Google من وجهة نظر المستخدم.
الحصول على التطبيقات التجريبية
تقدّم Google تطبيقَين لمساعدتك في فهم ما تقدّمه ملفّات برمجة التطبيقات Navigation SDK بالإضافة إلى ملفّات برمجة التطبيقات Google Maps API، وذلك استنادًا إلى مستوى خبرتك. يمكن للمطوّرين الملمّين بواجهات برمجة تطبيقات "خرائط Google" التركيز على الإصدار التجريبي من GoogleNavigation. سيجد المطوّرون المبتدئون في كلا проекти هذان التطبيقان مفيدين.
اعتبارًا من الإصدار 4.1 من حزمة تطوير البرامج (SDK) للتنقّل على Android، أصبح بإمكانك تنزيل التطبيقَين التجريبيَين التاليَين على GitHub.
العرض التجريبي لواجهة برمجة التطبيقات GoogleNavigation: يعرض هذا العرض عملية دمج سلوكيات واجهة برمجة التطبيقات و طرق العرض في ما يتعلّق بتجربة المستخدم أثناء جلسة تنقّل إرشادي.
الإصدار التجريبي من GoogleMap: يعرض الإصدار التجريبي سلوكيات فردية لواجهة
GoogleMapلتخصيص شكل الخرائط وطريقة عرضها.
العرض التجريبي لـ GoogleNavigation
يتوفّر أحدث إصدار تجريبي من GoogleNavigation على GitHub.
مبنى
في استوديو Android، استورِد التطبيق التجريبي واسمح بتشغيل Gradle.
افتح
local.defaults.propertiesوعدِّل قيمة السمةMAPS_API_KEY:MAPS_API_KEY=YOUR_API_KEYانقر على إنشاء وراجِع تفاصيل تنفيذ حزمة SDK.
في فئة Java، دوِّن رمز التنفيذ.
في ملف XML الخاص بالتنسيق، لاحِظ تصميم التنسيق والنص.
في ملف
build.gradle، دوِّن حزمة SDK في الملحقات.
اطّلِع على مستندات مكوّن إضافي Gradle للحفاظ على الأسرار للحصول على مزيد من المعلومات عن كيفية إضافة مفتاح واجهة برمجة التطبيقات إلى البيان.
الجري
وصِّل جهاز Android بالكمبيوتر أو استخدِم محاكيًا.
- جهاز Android: راجِع التعليمات لتفعيل خيارات المطوّرين على جهاز Android وضبط النظام لرصد الجهاز.
- المحاكي: استخدِم مدير جهاز Android الافتراضي (AVD) لمحاولة ضبط جهاز افتراضي. عند اختيار محاكي، احرص على اختيار صورة تتضمّن Google APIs.
في Android Studio، انقر على خيار القائمة تشغيل (أو رمز زر التشغيل)، ثم اختَر هدف نشر.
عند إنشاء التطبيق وتشغيله، يعرض التطبيق للمستخدم صفحة مقصودة تتضمّن قائمة بالخيارات.
خيارات NavViewActivity وNavFragmentActivity
من المرجّح أن يجد المستخدمون الجدد لـ NavSDK هذين الخيارَين الأكثر فائدة.
الخيار 1: يعرض NavViewActivity السلوكيات باستخدام NavigationView
بالاشتراك مع
Navigator.
الخيار 2: يعرض الخيار الثاني، الذي يحمل العنوان NavFragmentActivity،
السلوكيات باستخدام
SupportNavigationFragment
إلى جانب
Navigator.
عند النقر على أحد هذه الخيارات، سيظهر لك ما يلي:
- واجهة مستخدم التنقّل
- زر "ضبط الوجهة" في قائمة التطبيق
- تراكب يمكنك التفاعل معه لاستدعاء الطرق ديناميكيًا في واجهة برمجة التطبيقات
- قائمة كاملة تتضمّن المزيد من الخيارات
للبدء، انقر على ضبط الوجهة واختَر عنوانًا. بعد ذلك، يُنشئ التطبيق رحلة من موقعك الجغرافي الحالي إلى هذا العنوان. استخدِم تراكب ملف التحكّم اللوحة لمعرفة ما يحدث عند طلب واجهة برمجة التطبيقات. على سبيل المثال، يمكنك النقر على عرض الطرق لمحاولة فرض حزمة SDK على الوضع الليلي لمعرفة شكله.
خيار SwappingMapAndNavActivity
يعرض SwappingMapAndNavActivity الأنماط الشائعة التالية:
- عرض
MapView - التبديل إلى
NavigationViewعند بدء التنقّل - العودة إلى
MapViewعند انتهاء عملية التنقّل
العرض التجريبي لخدمة GoogleMap
يتوفّر أحدث إصدار تجريبي من GoogleNavigation على GitHub.
مبنى
في استوديو Android، استورِد التطبيق التجريبي واسمح بتشغيل Gradle.
افتح
local.defaults.propertiesوعدِّل قيمة السمةMAPS_API_KEY:MAPS_API_KEY=YOUR_API_KEYانقر على إنشاء وراجِع تفاصيل تنفيذ حزمة SDK.
في فئة Java، دوِّن رمز التنفيذ.
في ملف XML الخاص بالتنسيق، لاحِظ تصميم التنسيق والنص.
في ملف
build.gradle، دوِّن حزمة SDK في الملحقات.
اطّلِع على مكوّن gradle plug-in لإضافة مفاتيح سرية لمزيد من المعلومات عن كيفية إضافة مفتاح واجهة برمجة التطبيقات إلى البيان.
الجري
وصِّل جهاز Android بالكمبيوتر أو استخدِم محاكيًا.
- جهاز Android: راجِع التعليمات لتفعيل خيارات المطوّرين على جهاز Android وضبط النظام لرصد الجهاز.
- المحاكي: استخدِم مدير أجهزة Android الافتراضية (AVD) لضبط جهاز افتراضي. عند اختيار محاكي، احرص على اختيار صورة تتضمّن Google APIs.
في Android Studio، انقر على خيار القائمة تشغيل (أو رمز زر التشغيل)، ثم اختَر هدف نشر.
عند إنشاء التطبيق وإطلاقه، يعرض التطبيق للمستخدم صفحة مقصودة تتضمّن قائمة بالعروض التوضيحية.
من المفترض أن يكون نمط العرض هذا والبنية المقابلة للرمز المصدر
مألوفين لمستخدمي العروض التوضيحية لحزمة تطوير البرامج لتطبيق "خرائط Google". يرجع ذلك إلى أنّه تم تصميم الإصدار التجريبي من GoogleMap ليكون مشابهًا لتطبيق الإصدار التجريبي من واجهة برمجة التطبيقات Maps API. ويتمثل الاختلاف الأساسي في أنّ الإصدار التجريبي من Navigation SDK يتيح للمستخدم اختيار فئة العرض التي يريد اختبار الإصدار التجريبي عليها:
NavigationView
أو
MapView،
حيثما ينطبق ذلك.
وتشجع Google بشكل عام المستخدمين على استخدام
NavigationView.
يوفّر هذا العرض التوضيحي المرونة لتجربة هذين السلوكَين في كلا الإصدارَين من
تطبيقنا التجريبي واختيار ما يناسبك. على سبيل المثال، قد يظلّ
من الضروري استخدام MapView في الحالات التي تستخدم فيها مكتبة
تابعة لجهة خارجية تتوقّع التفاعل مع هذه الفئة.