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

تتوفّر حزمة Navigation SDK كمكتبة ثابتة. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على مستندات مرجع حزمة تطوير البرامج (SDK) للتنقّل.

قبل البدء

لتنفيذ العرض التجريبي، يجب أن يكون لديك حساب على Google Cloud ومفتاح واجهة برمجة تطبيقات مفعَّل لأجل مجموعة تطوير البرامج Navigation SDK من خلال فريق المبيعات. بعد إنشاء حساب على Google Cloud، اطّلِع على إعداد مشروع التطوير ومفتاح واجهة برمجة التطبيقات.

ملاحظة: تُعدّ حزمة تطوير البرامج للتنقّل (Navigation SDK) امتدادًا لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google". إذا كان تطبيقك يستخدِم حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لطبقة الخريطة، يمكنك إضافة حزمة تطوير البرامج (SDK) لميزة التنقّل إلى تطبيقك لتفعيل تجربة التنقّل. لا يمكنك استخدام حزمة تطوير البرامج (SDK) لنظام التنقّل بدون تثبيت حزمة تطوير البرامج (SDK) لخرائط Google في تطبيقك أيضًا.

إعداد مشروع التطوير ومفتاح واجهة برمجة التطبيقات

1. أنشئ مشروعًا أو افتح مشروعًا في Google Cloud Console لاستخدامه مع IDE SDK لنظام التشغيل iOS. انتظِر بضع دقائق إلى أن يظهر المشروع في Cloud Console.

2. فعِّل حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS في Google Cloud Console. في المشروع، افتح قسم "واجهات برمجة التطبيقات" وفعِّل IDE SDK لنظام التشغيل iOS.

3. أنشئ مفتاح واجهة برمجة تطبيقات للمشروع، وذلك من خلال اختيار واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد > إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات.

4. أضِف حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS إلى مفتاح واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة استخدام مفاتيح واجهة برمجة التطبيقات.

تجربة التطبيق التجريبي

يمكنك الآن تنزيل الإصدار التجريبي وإنشاءه وتشغيله.

هناك مشكلة معروفة تؤدي إلى عدم تجميع التطبيقات بشكلٍ سليم للمحاكي باستخدام Xcode 12. إذا واجهت هذه المشكلة، يُرجى الاطّلاع على الأسئلة الشائعة حول حزمة Navigation SDK للتعرّف على خطوات حلّ المشكلة.

تنزيل الإصدار التجريبي

اتّبِع الخطوات التالية لتنزيل الإصدار التجريبي:

1. تثبيت Cocoapods:

   sudo gem install cocoapods

2. نزِّل العرض الترويجي كـ Cocoapod:

   pod try GoogleNavigation

3. أدخِل 1 أو 2 لفتح العرض التجريبي الذي تختاره:

   • 1: Example/GoogleNavXCFrameworkDemos.xcodeproj لمشاهدة ملف برمجي توضيحي بلغة Objective-C
   • 2: SwiftExample/GoogleNavSwiftXCFrameworkDemos.xcodeproj لمشاهدة ملف Swift التوضيحي

إذا كنت تفضّل عرض الرمز التجريبي، يمكنك العثور عليه على GitHub:

• Swift navigation demo.
• Objective-C navigation demo

إنشاء العرض التجريبي وتشغيله

اتّبِع الخطوات التالية لإنشاء التطبيق التجريبي وتشغيله:

1. ثبِّت Xcode.

2. أضِف مفتاح واجهة برمجة التطبيقات الخاص بك إلى ملف SDKDemoAPIKey. يجب استخدام مفتاح واجهة برمجة التطبيقات الذي أنشأته في الخطوات الواردة في مقالة إعداد مشروع التطوير ومفتاح واجهة برمجة التطبيقات.

3. لتشغيل العرض التجريبي، عليك إنشاء التطبيق في Xcode باستخدام جهاز iOS متصل بجهاز الكمبيوتر، أو استخدام جهاز محاكاة.

تحديد المشاكل وحلّها

إظهار/إخفاء معلومات تحديد المشاكل وحلّها

• اختَر جهاز iOS أو جهاز محاكاة يعمل بنظام التشغيل iOS 15 أو إصدار أحدث.
• إذا لم يظهر لك جهاز محاكاة متاح، أضِف وجهات Rosetta: في المنتج > الوجهة > تصاميم الوجهة، اختَر عرض وجهات Rosetta.
• إذا تعذّر إنشاء الإصدار بسبب الخطأ Sandbox: rsync.samba() deny، أوقِف وضع الحماية لنص برمجي للمستخدِم: في إعدادات الإنشاء > خيارات الإنشاء، اضبط وضع الحماية لنص برمجي للمستخدِم على لا.