من خلال دمج حزمة SDK للتنقل لنظام Android، يمكن أن يتجاوز تطبيقك الربط بطريقة عرض خريطة خارجية. باستخدام ميزة التنقل في "خرائط Google"، يمكن لتطبيقك تقديم تقارير ديناميكية و القصيرة من وجهة واحدة للبيانات حول رحلة المستخدم. يشرح هذا الدليل كيفية تشغيل التطبيقات التجريبية لحزمة SDK للتنقل والمتوفرة على GitHub.
الاستعداد
لبدء استخدام حزمة SDK للتنقل، تأكد من توفر العناصر التالية:
ممثل "منصة خرائط Google" للوصول إلى ما يلي:
- مفتاح واجهة برمجة تطبيقات تم توفيره للاستخدام مع حزمة SDK للتنقل. يجب تقديم معرّف المشروع الذي يمكنك العثور عليه في لوحة البيانات الرئيسية في Google Cloud Console تحت اسم المشروع.
- بيانات حزمة تطوير البرامج (SDK) تأكَّد من إعداد مشروعك لاستخدام Maven من أجل حزمة تطوير البرامج (SDK) للتنقّل.
- بالنسبة إلى المشاريع التي تستخدم الإصدار 4.99.0 والإصدارات الأقدم: إذا لم تتمكن من استخدام Maven، يمكنك تنزيل
العناصر المضغوطة من Google Drive المشترك. يكون ملف المكتبة الثابتة هو .aar في دليل "
libs/" الذي يحتوي على حزمة "SDK للتنقّل" كحزمة AAR. - واحد أو أكثر من التطبيقات التجريبية.
- استوديو Android، وهو بيئة التطوير المقترَحة لإنشاء تطبيق باستخدام حزمة تطوير البرامج للتنقل.
تم تصميم هذه المستندات للأشخاص الذين هم على دراية بتطوير Android ومفاهيم البرمجة التي تركز على العناصر. يجب أن تكون على دراية أيضًا بخرائط Google من وجهة نظر المستخدم.
الحصول على التطبيقات التجريبية
توفّر Google تطبيقَين لمساعدتك على فهم ما تقدّمه "حزمة SDK الخاصة بالتنقّل" بالإضافة إلى واجهات برمجة التطبيقات لخرائط Google، وذلك بناءً على مستوى خبرتك. يمكن للمطورين الذين على دراية بواجهات برمجة التطبيقات لخرائط Google تركيز انتباههم على العرض التوضيحي لـ Google مفتاح التنقل. سيجد المطورون الجدد في كلا المشروعين كلا التطبيقين مفيدين.
بدءًا من حزمة SDK للتنقل لنظام التشغيل Android الإصدار 4.1، يتوفر كلا التطبيقين التجريبيين التاليين على GitHub للتنزيل.
الإصدار التجريبي من Google Navigation: يعرض دمج سلوكيات واجهة برمجة التطبيقات وطرق العرض من حيث صلتها بتجربة المستخدم أثناء جلسة التنقّل الإرشادية.
الإصدار التجريبي من "خرائط Google": يعرض السلوكيات الفردية لواجهة
GoogleMapلتخصيص مظهر الخرائط وطريقة عرضها.
ملاحظة حول استخدام Maven
يتم ضبط التطبيقات التجريبية لتنزيل عناصر حزمة تطوير البرامج (SDK) من مستودع Maven البعيد، باستخدام المكوّن الإضافي Artifact Registry في Gradle. احرص على اتّباع تعليمات ضبط المشروع للحصول على إذن بالوصول إلى حزمة تطوير البرامج (SDK).
العرض التوضيحي لميزة Google Navigation
يتوفر أحدث إصدار تجريبي من Google Navigation على GitHub.
مدّ
في استوديو Android، استورِد التطبيق التجريبي واسمح بتشغيل أداة Gradle.
افتح
local.defaults.propertiesوعدِّل قيمة السمةMAPS_API_KEY:MAPS_API_KEY=YOUR_API_KEYانقر على إنشاء وافحص تفاصيل تنفيذ حزمة تطوير البرامج (SDK).
في فئة Java، لاحظ رمز التنفيذ.
في تنسيق XML، لاحظ تصميم التنسيق والنص.
في الملف
build.gradle، اطّلِع على حزمة SDK في الملحقات.
يمكنك الاطّلاع على مستندات المكوّن الإضافي Secret Gradle للحصول على مزيد من المعلومات حول كيفية إضافة مفتاح واجهة برمجة التطبيقات إلى البيان.
الجري
عليك ربط جهاز Android بجهاز الكمبيوتر أو استخدام محاكي.
- جهاز Android: يمكنك الرجوع إلى instructions لتفعيل خيارات المطوّرين على جهاز Android وضبط نظامك لاكتشاف الجهاز.
- المحاكيmdash؛يمكنك استخدام مدير جهاز Android الافتراضي (AVD) لضبط جهاز افتراضي. عند اختيار محاكي، تأكد من اختيار صورة تتضمن واجهات Google APIs.
في استوديو Android، انقر على خيار القائمة تشغيل (أو رمز زر التشغيل)، ثم اختَر هدف نشر.
عند إنشاء التطبيق وإطلاقه، يقدم للمستخدم صفحة منتقل إليها لقائمة من الخيارات.
خيارات NavViewActivity وNavFragmentActivity
سيجد المستخدمون الجدد لحزمة NavSDK أن هذين الخيارَين أكثر فائدة على الأرجح.
الخيار 1: يعرض NavViewActivity السلوكيات باستخدام NavigationView
إلى جانب Navigator.
الخيار الثاني: يعرض الخيار الثاني، بعنوان NavFragmentActivity، السلوكيات باستخدام SupportNavigationFragment إلى جانب Navigator.
عند النقر على أحد هذه الخيارات، سيظهر لك ما يلي:
- واجهة مستخدم التنقّل
- زر "تحديد الوجهة" في قائمة التطبيق
- يمكنك التفاعل معه لاستدعاء الطرق بشكل ديناميكي على واجهة برمجة التطبيقات
- قائمة كاملة بمزيد من الخيارات
للبدء، انقر على تعيين وجهة واختر عنوانًا. يحاكي التطبيق بعد ذلك رحلة من موقعك الحالي إلى هذا العنوان. استخدِم تراكب لوحات التحكم لمعرفة ما يحدث عند استدعاء واجهة برمجة تطبيقات. على سبيل المثال، يمكنك النقر على عرض الطرق لمحاولة فرض تشغيل حزمة تطوير البرامج (SDK) في "الوضع الليلي" لمعرفة كيف تبدو.
خيار SupingMapAndNavActivity
تعرض SwappingMapAndNavActivity الأنماط الشائعة التالية:
- يتم عرض
MapView - التبديل إلى
NavigationViewعند بدء التنقل - الرجوع إلى
MapViewعند انتهاء التنقل
عرض توضيحي لخريطة Google
يتوفر أحدث إصدار تجريبي من Google Navigation على 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 يمكنك الرجوع إلى instructions لتفعيل خيارات المطوّرين على جهاز Android وإعداد نظامك لاكتشاف الجهاز.
- المحاكي: استخدِم مدير جهاز Android الافتراضي (AVD) لإعداد جهاز افتراضي. عند اختيار محاكي، تأكد من اختيار صورة تتضمن واجهات Google APIs.
في استوديو Android، انقر على خيار القائمة تشغيل (أو رمز زر التشغيل)، ثم اختَر هدف نشر.
عند إنشاء التطبيق وإطلاقه، يقدم للمستخدم صفحة منتقل إليها لقائمة من العروض التوضيحية.
ويجب أن يكون نمط العرض التقديمي هذا والبنية المقابلة لرمز المصدر مألوفَين لمستخدمي الإصدارات التجريبية لحزمة SDK لخرائط Google. وهذا يرجع إلى أن العرض التوضيحي لتطبيق GoogleMap مصمم ليكون مشابهًا للتطبيق التجريبي لواجهة برمجة تطبيقات الخرائط. ويتمثل الفرق الأساسي في أن الإصدار التجريبي من حزمة SDK للتنقل يتيح للمستخدم اختيار فئة العرض التي يريد اختبار عرض توضيحي عليها:
NavigationView
أو
MapView،
حيثما ينطبق ذلك.
بشكل عام، تشجِّع Google المستخدمين على استخدام NavigationView.
يوفّر لك هذا العرض التوضيحي المرونة لتجربة هذه السلوكيات على كلا الإصدارين من تطبيقنا التجريبي واختيار ما يناسبك. على سبيل المثال، قد يكون من الضروري استخدام MapView في الحالات التي تستخدم فيها مكتبة تابعة لجهة خارجية من المتوقّع أن تتفاعل مع ذلك الصف.