تجربة العرض التوضيحي

من خلال دمج حزمة تطوير البرامج (SDK) لنظام التنقّل في Android، يمكن لتطبيقك إجراء المزيد من الإجراءات غير ربطه بعرض خريطة خارجي. من خلال ميزة التنقّل في "خرائط Google"، يمكن لتطبيقك أن يقدّم ميزة dynamikalemet retrieval وإعداد تقارير سريعة عن البيانات المتعلّقة برحلة المستخدِم. يشرح هذا الدليل كيفية تشغيل التطبيقات التجريبية لحزمة SDK للتنقل والمتوفرة على GitHub.

الاستعداد

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

• مفتاح واجهة برمجة تطبيقات تم توفيره للاستخدام مع حزمة تطوير البرامج (SDK) للتنقل راجع استخدام مفاتيح واجهة برمجة التطبيقات لمزيد من المعلومات حول إنشاء المفاتيح وتقييدها.
• عنصر حزمة SDK تأكَّد من ضبط مشروعك لاستخدام Maven لحزمة تطوير البرامج (SDK) الخاصة بالتنقّل.
• واحد أو أكثر من التطبيقات التجريبية.
• Android Studio، وهو بيئة التطوير الموصى بها لإنشاء تطبيق باستخدام حزمة SDK للتنقل.

تم تصميم هذه المستندات للأشخاص المطلعين على تطوير تطبيقات Android و مفاهيم البرمجة المستندة إلى الكائنات. يجب أن تكون على دراية بخرائط Google من وجهة نظر المستخدم.

الحصول على التطبيقات التجريبية

تقدّم Google تطبيقَين لمساعدتك في فهم ما تقدّمه ملفّات برمجة التطبيقات Navigation SDK بالإضافة إلى ملفّات برمجة التطبيقات Google Maps API، وذلك استنادًا إلى مستوى خبرتك. يمكن للمطورين الذين على دراية بواجهات برمجة التطبيقات لخرائط Google تركيز انتباههم على العرض التوضيحي لـ Google مفتاح التنقل. سيجد المطورون الجدد في كلا المشروعين كلا التطبيقين مفيدين.

بدءًا من حزمة SDK المخصصة للتنقل في الإصدار 4.1 من نظام التشغيل Android، يتوفر كلا التطبيقين التجريبيين التاليين على GitHub للتنزيل.

• العرض التجريبي لواجهة برمجة التطبيقات GoogleNavigation: يعرض هذا العرض عملية دمج سلوكيات واجهة برمجة التطبيقات و طرق العرض في ما يتعلّق بتجربة المستخدم أثناء جلسة تنقّل إرشادي .

• الإصدار التجريبي من GoogleMap: يعرض سلوكيات فردية لواجهة GoogleMap لتخصيص شكل الخرائط وطريقة عرضها.

العرض التجريبي لـ GoogleNavigation

يتوفر أحدث إصدار تجريبي من Google Navigation على GitHub.

مبنى

1. في استوديو Android، استورِد التطبيق التجريبي واسمح بتشغيل أداة Gradle.

2. افتح local.defaults.properties وعدِّل قيمة السمة MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. انقر على إنشاء وراجِع تفاصيل تنفيذ حزمة SDK.

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

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

   • في ملف build.gradle، دوِّن حزمة SDK في الملحقات.

يمكنك الاطّلاع على مستندات المكوّن الإضافي Secret Gradle للحصول على مزيد من المعلومات حول كيفية إضافة مفتاح واجهة برمجة التطبيقات إلى البيان.

الجري

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

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

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

عند إنشاء التطبيق وتشغيله، يعرض التطبيق للمستخدم صفحة مقصودة تتضمّن قائمة بالخيارات.

خيارات NavViewActivity وNavFragmentActivity

من المرجّح أن يجد المستخدمون الجدد لـ NavSDK هذين الخيارَين الأكثر فائدة.

الخيار 1: يعرض NavViewActivity السلوكيات باستخدام NavigationView إلى جانب Navigator.

الخيار 2: يعرض الخيار الثاني، الذي يحمل العنوان NavFragmentActivity، السلوكيات باستخدام SupportNavigationFragment إلى جانب Navigator.

عند النقر على أحد هذه الخيارات، سيظهر لك ما يلي:

• واجهة مستخدم التنقّل
• زر "تحديد الوجهة" في قائمة التطبيق
• يمكنك التفاعل معه لاستدعاء الطرق بشكل ديناميكي على واجهة برمجة التطبيقات
• قائمة كاملة تتضمّن المزيد من الخيارات

للبدء، انقر على تعيين وجهة واختر عنوانًا. بعد ذلك، يُنشئ التطبيق محاكاة لرحلة من موقعك الجغرافي الحالي إلى هذا العنوان. استخدِم تراكب لوحات التحكم لمعرفة ما يحدث عند استدعاء واجهة برمجة تطبيقات. على سبيل المثال، يمكنك النقر على عرض الطرق لمحاولة فرض حزمة SDK على الوضع الليلي لمعرفة شكله .

خيار SwappingMapAndNavActivity

تعرض SwappingMapAndNavActivity الأنماط الشائعة التالية:

• يتم عرض MapView
• التبديل إلى NavigationView عند بدء التنقل
• العودة إلى MapView عند انتهاء عملية التنقّل

عرض توضيحي لخريطة Google

يتوفر أحدث إصدار تجريبي من Google Navigation على GitHub.

مبنى

1. في استوديو Android، استورِد التطبيق التجريبي واسمح بتشغيل Gradle.

2. افتح local.defaults.properties وعدِّل قيمة السمة MAPS_API_KEY :

     MAPS_API_KEY=YOUR_API_KEY
   

3. انقر على إنشاء وراجِع تفاصيل تنفيذ حزمة SDK.

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

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

   • في الملف build.gradle، اطّلِع على حزمة SDK في الملحقات.

اطّلِع على مكوّن gradle plug-in لإضافة مفاتيح سرية لمزيد من المعلومات عن كيفية إضافة مفتاح واجهة برمجة التطبيقات إلى البيان.

الجري

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

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

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

عند إنشاء التطبيق وإطلاقه، يقدم للمستخدم صفحة منتقل إليها لقائمة من العروض التوضيحية.

من المفترض أن يكون نمط العرض هذا والبنية المقابلة للرمز المصدر مألوفَين لمستخدمي العروض التوضيحية لحزمة تطوير البرامج لتطبيق "خرائط Google". يرجع ذلك إلى أنّه تم تصميم الإصدار التجريبي من GoogleMap ليكون مشابهًا لتطبيق الإصدار التجريبي من واجهة برمجة التطبيقات Maps API. ويتمثل الاختلاف الأساسي في أنّ الإصدار التجريبي من Navigation SDK يتيح للمستخدم اختيار فئة العرض التي يريد اختبار إصدار تجريبي عليها: NavigationView أو MapView، حيثما ينطبق ذلك.

وتشجع Google بشكل عام المستخدمين على استخدام NavigationView. يوفّر لك هذا العرض التوضيحي المرونة لتجربة هذه السلوكيات على كلا الإصدارين من تطبيقنا التجريبي واختيار ما يناسبك. على سبيل المثال، قد يظلّ من الضروري استخدام MapView في الحالات التي تستخدم فيها مكتبة تابعة لجهة خارجية تتوقّع التفاعل مع هذه الفئة.