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

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

قبل البدء

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

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

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

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

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

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

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

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

يمكنك الآن تنزيل العرض التوضيحي وإنشاؤه وتشغيله.

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

تنزيل العرض التوضيحي

يتوفّر الرمز التجريبي على GitHub:

• عرض توضيحي للتنقّل السريع
• عرض توضيحي للتنقّل في Objective-C

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

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

1. ثبِّت Xcode.

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

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

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

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

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