من خلال دمج حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android، يمكن لتطبيقك تجاوز الربط بعرض خريطة خارجية. من خلال ميزة التنقّل باتّجاهات مفصّلة في "خرائط Google"، يمكن لتطبيقك توفير إمكانية الاسترداد الديناميكي للبيانات وإعداد تقارير بنظرة واحدة حول رحلة المستخدم. يوضّح هذا الدليل كيفية تشغيل التطبيقات التجريبية لحزمة تطوير البرامج (SDK) الخاصة بالتنقّل، والتي تتوفّر على GitHub.
الاستعداد
لبدء استخدام حزمة تطوير البرامج (SDK) للتنقّل، احرص على توفير العناصر التالية.
- مفتاح واجهة برمجة التطبيقات الذي تم توفيره للاستخدام مع حزمة تطوير البرامج (SDK) للتنقّل يُرجى الاطّلاع على استخدام مفاتيح واجهة برمجة التطبيقات لمزيد من المعلومات حول إنشاء المفاتيح وفرض قيود عليها.
- عنصر حزمة SDK تأكَّد من أنّ مشروعك تم ضبطه لاستخدام Maven مع حزمة تطوير البرامج Navigation SDK.
- تطبيق واحد أو أكثر من التطبيقات التجريبية
- استوديو Android، بيئة التطوير المقترَحة لإنشاء تطبيق باستخدام حزمة تطوير البرامج (SDK) للتنقّل.
هذه المستندات مخصّصة للأشخاص الذين لديهم دراية بمفاهيم تطوير Android والبرمجة الشيئية. يجب أن تكون أيضًا على دراية بـ "خرائط Google" من وجهة نظر المستخدم.
الحصول على التطبيقات التجريبية
توفّر Google تطبيقَين لمساعدتك في فهم ما تقدّمه حزمة تطوير البرامج (SDK) للتنقّل بالإضافة إلى واجهات برمجة تطبيقات "خرائط Google"، وذلك حسب مستوى خبرتك. يمكن للمطوّرين الذين لديهم معرفة بواجهات برمجة تطبيقات "خرائط 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 في التبعيات.
لمزيد من المعلومات حول كيفية إضافة مفتاح واجهة برمجة التطبيقات إلى ملف البيان، يمكنك الاطّلاع على مستندات المكوّن الإضافي Secrets Gradle.
تشغيل
وصِّل جهاز Android بالكمبيوتر أو استخدِم محاكيًا.
- جهاز Android: يُرجى الرجوع إلى التعليمات لتفعيل خيارات المطوّرين على جهاز Android وضبط النظام لاكتشاف الجهاز.
- المحاكي: استخدِم أداة إدارة الأجهزة الافتراضية المتوافقة مع Android (AVD) لضبط جهاز افتراضي. عند اختيار محاكي، تأكد من اختيار صورة تتضمن واجهات برمجة تطبيقات Google.
في استوديو Android، انقر على خيار القائمة تشغيل (أو رمز زر التشغيل)، ثم اختَر هدف النشر.
عند إنشاء التطبيق وتشغيله، يعرض التطبيق للمستخدم صفحة مقصودة تحتوي على قائمة من الخيارات.
خيارات NavViewActivity وNavFragmentActivity
من المرجّح أن يجد المستخدمون الجدد لحزمة NavSDK هذين الخيارَين الأكثر فائدة.
الخيار 1: يعرض NavViewActivity السلوكيات باستخدام NavigationView
بالتزامن مع
Navigator.
الخيار 2: يعرض الخيار الثاني، الذي يحمل العنوان NavFragmentActivity، السلوكيات باستخدام NavigationFragment إلى جانب 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 في التبعيات.
لمزيد من المعلومات حول كيفية إضافة مفتاح واجهة برمجة التطبيقات إلى ملف البيان، يُرجى الاطّلاع على المكوّن الإضافي Secrets Gradle.
تشغيل
وصِّل جهاز Android بالكمبيوتر أو استخدِم محاكيًا.
- جهاز Android: يُرجى الرجوع إلى التعليمات لتفعيل خيارات المطوّرين على جهاز Android وضبط النظام لرصد الجهاز.
- المحاكي: استخدِم أداة إدارة الأجهزة الافتراضية المتوافقة مع Android (AVD) لضبط جهاز افتراضي. عند اختيار محاكي، تأكد من اختيار صورة تتضمن واجهات برمجة تطبيقات Google.
في استوديو Android، انقر على خيار القائمة تشغيل (أو رمز زر التشغيل)، ثم اختَر هدف النشر.
عند إنشاء التطبيق وإطلاقه، يعرض التطبيق للمستخدم صفحة مقصودة تحتوي على قائمة بالعروض التوضيحية.
يجب أن يكون نمط العرض التقديمي هذا والبنية المقابلة للرمز المصدر
مألوفًا لمستخدمي العروض التوضيحية لحزمة تطوير البرامج (SDK) لـ "خرائط Google". ويرجع ذلك إلى أنّ الإصدار التجريبي من GoogleMap مصمَّم ليكون مشابهًا للتطبيق التجريبي لواجهة برمجة التطبيقات في "خرائط Google". ويتمثّل الاختلاف الأساسي في أنّ الإصدار التجريبي من حزمة تطوير البرامج (SDK) للتنقّل يتيح للمستخدم اختيار فئة العرض التي يريد اختبار الإصدار التجريبي عليها: NavigationView أو MapView، حيثما ينطبق ذلك.
تشجّع Google بشكل عام المستخدمين على استخدام
NavigationView.
يوفّر هذا العرض التوضيحي المرونة لتجربة هذه السلوكيات على كلا الإصدارين في
تطبيقنا التجريبي واختيار ما يناسبك. على سبيل المثال، قد يظل من الضروري استخدام MapView في الحالات التي تستخدم فيها مكتبة تابعة لجهة خارجية من المتوقع أن تتفاعل مع هذه الفئة.