من خلال دمج حزمة SDK للتنقل لنظام التشغيل Android، يمكن أن يتجاوز تطبيقك الربط بطريقة عرض خريطة خارجية. باستخدام ميزة التنقّل باتّجاهات مفصّلة في "خرائط Google"، يمكن أن يوفّر تطبيقك ميزات ديناميكية. استرجاع البيانات وإعداد تقارير بنظرة واحدة حول رحلة المستخدم. هذا الدليل توضح كيفية تشغيل التطبيقات التجريبية لحزمة تطوير البرامج (SDK) للتنقل، والتي المتوفرة على جيت هب.
الاستعداد
لبدء استخدام حزمة SDK للتنقل، تأكد من البنود التالية.
ممثل "منصة خرائط Google" للوصول إلى ما يلي:
- مفتاح واجهة برمجة تطبيقات تم توفيره للاستخدام مع حزمة SDK للتنقّل يجب تقديم معرّف المشروع الذي يمكنك العثور عليه في لوحة البيانات الرئيسية في Google Cloud Console، تحت اسم المشروع.
- بيانات حزمة تطوير البرامج (SDK) تأكَّد من إعداد مشروعك. استخدام Maven مع حزمة تطوير البرامج (SDK) للتنقل.
- بالنسبة إلى المشاريع التي تستخدم الإصدار 4.99.0 والإصدارات الأقدم: إذا لم تتمكن من استخدام Maven، يمكنك
تنزيل العناصر المضغوطة من Google Drive المشترك. ملف المكتبة الثابتة هو .aar في
دليل "
libs/" يحتوي على حزمة تطوير البرامج (SDK) للتنقّل كـ حزمة AAR - واحد أو أكثر من التطبيقات التجريبية.
- أجهزة Android Studio، وهو بيئة التطوير المقترَحة لإنشاء تطبيق باستخدام حزمة SDK للتنقل.
تم تصميم هذا المستند للمستخدمين الذين لديهم دراية بتطوير تطبيقات Android مفاهيم البرمجة كائنية التوجيه. يجب أيضًا أن تكون على دراية بأدوات الخرائط من وجهة نظر المستخدم.
الحصول على التطبيقات التجريبية
وتوفر Google تطبيقين لمساعدتك على فهم عروض حزمة SDK للتنقل أعلى واجهات Google Maps API، بناءً على مستوى خبرتك. المطورون على دراية بواجهات برمجة التطبيقات لخرائط Google تركيز انتباههم على العرض التوضيحي لـ Google Navigation. المطوِّرون الجُدد في كلا الإصدارين فستجد كلا التطبيقين مفيدين.
بالنسبة إلى حزمة تطوير البرامج (SDK) للتنقل للإصدار 4.1 من نظام التشغيل Android، تكون التطبيقات التجريبية التالية متاحة المتاحة على 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 في الملحقات.
الاطّلاع على قاعدة الأسرار المكوّن الإضافي لمزيد من المعلومات حول كيفية إضافة مفتاح واجهة برمجة التطبيقات إلى البيان.
الجري
عليك ربط جهاز Android بجهاز الكمبيوتر أو استخدام محاكي.
- جهاز Android — يمكنك الرجوع إلى التعليمات من أجل تفعيل خيارات المطوّرين على جهاز Android وإعداد نظامك الكشف عن الجهاز.
- المحاكيmdash؛استخدام جهاز Android الافتراضي (AVD) المدير إلى إعداد جهاز افتراضي. عند اختيار محاكي، تأكد من اختر صورة تتضمن Google APIs.
في استوديو Android، انقر على خيار القائمة تشغيل (أو زر التشغيل. ) ثم اختيار هدف نشر
عند إنشاء التطبيق وإطلاقه، يقدم للمستخدم صفحة مقصودة لقائمة من الخيارات.
خيارات NavViewActivity وNavFragmentActivity
سيجد المستخدمون الجدد لحزمة NavSDK أنّ هذين الخيارين هما الأكثر مفيدة
الخيار 1: تعرض "NavViewActivity" السلوكيات باستخدام NavigationView
جنبًا إلى جنب مع
Navigator
الخيار 2: يعرض الخيار الثاني، بعنوان 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 يُرجى الرجوع إلى التعليمات لتفعيل خيارات المطوّرين على جهاز Android وتهيئة النظام لاكتشاف الجهاز.
- المحاكي يستخدم جهاز Android الافتراضي (AVD) المدير لإعداد جهاز افتراضي. عند اختيار محاكي، تأكد من اختر صورة تتضمن Google APIs.
في استوديو Android، انقر على خيار القائمة تشغيل (أو زر التشغيل. ) ثم اختيار هدف نشر
عند إنشاء التطبيق وإطلاقه، يقدم للمستخدم صفحة مقصودة لقائمة من العروض التوضيحية.
نمط العرض التقديمي هذا والبنية المقابلة لرمز المصدر
مألوفًا لمستخدمي الإصدارات التجريبية لحزمة SDK لخرائط Google هذا لأن
تم تصميم العرض التوضيحي لـ GoogleMap ليكون مشابهًا للعرض التوضيحي لواجهة برمجة تطبيقات الخرائط
التطبيق. الأساسية
الفرق هو أن الإصدار التجريبي من حزمة SDK للتنقل يتيح للمستخدم اختيار فئة العرض
ويرغب في اختبار عرض توضيحي على:
NavigationView
أو
MapView،
حيثما ينطبق ذلك.
تشجع Google المستخدمين بشكل عام على استخدام
NavigationView
يوفر هذا العرض التوضيحي المرونة لتجربة هذه السلوكيات على كلا الإصدارين
تطبيقنا التجريبي واختيار أيهما يناسبك على سبيل المثال، ربما لا يزال
ضرورة استخدام MapView في الحالات التي تستعين فيها بطرف ثالث
المكتبة التي من المتوقع أن تتفاعل مع هذا الفصل.