النسخة التجريبية

من خلال دمج حزمة تطوير البرامج للتنقّل على أجهزة Android، يمكن لتطبيقك أن يقدّم أكثر من مجرد رابط يؤدي إلى عرض خريطة خارجية. باستخدام ميزة التنقّل باتّجاهات مفصّلة في "خرائط Google"، يمكن لتطبيقك توفير استرجاع ديناميكي للبيانات وإعداد تقارير بنظرة واحدة عن رحلة المستخدم. يوضّح هذا الدليل كيفية تشغيل التطبيقات التجريبية لحزمة Navigation SDK، والتي تتوفّر على GitHub.

الاستعداد

للبدء باستخدام Navigation SDK، احرص على توفير ما يلي:

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

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

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

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

اعتبارًا من الإصدار 4.1 من حزمة تطوير البرامج للتنقّل على أجهزة Android، يتوفّر كلا التطبيقَين التجريبيَين التاليَين على GitHub للتنزيل.

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

• عرض توضيحي لـ GoogleMap: يعرض هذا العرض السلوكيات الفردية لواجهة GoogleMap لتخصيص مظهر الخرائط وطريقة عرضها.

الإصدار التجريبي من GoogleNavigation

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

إنشاء

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

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

     MAPS_API_KEY=YOUR_API_KEY
   

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

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

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

   • في ملف build.gradle، سجِّل حزمة SDK في التبعيات.

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

تشغيل

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

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

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

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

خيارات NavViewActivity وNavFragmentActivity

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

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

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

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

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

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

SwappingMapAndNavActivity option

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

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

عرض توضيحي لـ GoogleMap

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

إنشاء

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

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

     MAPS_API_KEY=YOUR_API_KEY
   

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

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

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

   • في ملف build.gradle، سجِّل حزمة SDK في التبعيات.

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

تشغيل

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

   • جهاز Android يُرجى الرجوع إلى التعليمات لتفعيل خيارات المطوّرين على جهاز Android وإعداد النظام لرصد الجهاز.
   • المحاكي استخدِم أداة إدارة الأجهزة الافتراضية المتوافقة مع Android لضبط جهاز افتراضي. عند اختيار محاكي، تأكَّد من اختيار صورة تتضمّن حزمة Google APIs.

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

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

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

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