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

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

قبل البدء

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

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

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

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

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

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

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

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

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

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

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

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

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

يمكنك أيضًا الاطّلاع على رمز النسخة التجريبية من التنقّل في Swift على GitHub:

ضبط العرض التوضيحي

اتّبِع الخطوات التالية لضبط تطبيقك التجريبي.

1. ثبِّت Xcode.

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

   cd ios-navigation-sdk-samples/GoogleNavigation/
   

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

   open GoogleNavSwiftXCFrameworkDemos.xcodeproj
   

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

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

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

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

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