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

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

قبل البدء

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

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

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

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

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

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

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

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

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

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

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

1. استنسِخ مستودع نماذج التعليمات البرمجية:

git clone https://github.com/googlemaps-samples/ios-navigation-sdk-samples.git

يمكنك أيضًا الاطّلاع على رمز العرض التوضيحي للتنقّل بلغة Swift navigation demo code على GitHub:

إعداد العرض التوضيحي

يُرجى اتّباع الخطوات التالية لإعداد تطبيقك التجريبي.

1. ثبِّت Xcode.

2. انتقِل إلى مستودع GoogleNavigation.

   cd ios-navigation-sdk-samples/GoogleNavigation/
   

3. افتح مشروع Xcode:

   open GoogleNavSwiftXCFrameworkDemos.xcodeproj
   

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

5. استخدِم Xcode لإنشاء التطبيق وتشغيله.

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

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

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