راه‌اندازی پروژه Xcode

مدیر بسته Swift

Navigation SDK را می‌توان ازطریق Swift Package Manager نصب کرد. برای افزودن کیت توسعه نرم‌افزار، مطمئن شوید که همه وابستگی‌های «کیت توسعه نرم‌افزار ناوبری» موجود را برداشته‌اید.

برای افزودن SDK به پروژه جدید یا موجود، این مراحل را دنبال کنید:

1. ‫Xcode project یا workspace را باز کنید، سپس به File (فایل) > Add Package Dependencies (افزودن وابستگی‌های بسته) بروید.
2. https://github.com/googlemaps/ios-navigation-sdk را به‌عنوان نشانی وب وارد کنید، برای کشیدن بسته کلید Enter را فشار دهید، و روی «افزودن بسته» کلیک کنید.
3. برای نصب version خاص، فیلد قانون وابستگی را روی یکی از گزینه‌های مبتنی بر نسخه تنظیم کنید. برای پروژه‌های جدید، توصیه می‌کنیم جدیدترین نسخه را مشخص کنید و از گزینه «نسخه دقیق» استفاده کنید. پس‌از تکمیل، روی «افزودن بسته» کلیک کنید.
4. از پنجره انتخاب محصولات بسته، تأیید کنید که GoogleNavigation به هدف main تعیین‌شده شما اضافه خواهد شد. پس‌از تکمیل، روی «افزودن بسته» کلیک کنید.
5. برای درستی‌سنجی نصب، به صفحه General (عمومی) هدف بروید. در Frameworks, Libraries, and Embedded Content باید بسته‌های نصب‌شده را ببینید. همچنین می‌توانید بخش «وابستگی‌های بسته» در «پیمایشگر پروژه» را برای تأیید بسته و نسخه آن مشاهده کنید.

برای به‌روزرسانی package برای پروژه موجود، این مراحل را دنبال کنید:

1. از Xcode، به فایل > بسته‌ها > به‌روزرسانی به جدیدترین نسخه‌های بسته بروید.
2. برای درستی‌سنجی نصب، به بخش وابستگی‌های بسته در Project Navigator بروید تا بسته و نسخه آن را درستی‌سنجی کنید.

1. از تنظیمات پیکربندی پروژه Xcode، چارچوب‌ها، کتابخانه‌ها، و محتوای جاسازی‌شده را پیدا کنید. از علامت منفی(-) برای برداشتن چارچوب زیر استفاده کنید:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
2. از فهرست راهنمای سطح بالای پروژه Xcode، بسته GoogleMaps را بردارید.

نصب دستی

این راهنما نشان می‌دهد که چگونه XCFrameworks حاوی «کیت توسعه نرم‌افزار پیمایش برای iOS» و کیت توسعه نرم‌افزار Google Maps برای iOS را به‌صورت دستی به پروژه خود اضافه کنید و تنظیمات ساخت را در Xcode پیکربندی کنید. ‫XCFramework یک بسته باینری است که می‌توانید در چندین پلاتفرم، ازجمله ماشین‌های دارای تراشه M1، استفاده کنید

برای نصب XCFrameworks برای کیت توسعه نرم‌افزار ناوبری برای iOS، و کیت توسعه نرم‌افزار Maps برای iOS، این مراحل را دنبال کنید:

1. فایل‌های منبع و دودویی کیت توسعه نرم‌افزار زیر را بارگیری کنید:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. ‫Xcode را راه‌اندازی کنید و یا پروژه موجودی را باز کنید یا پروژه جدیدی ایجاد کنید. اگر با iOS آشنایی ندارید، پروژه جدیدی ایجاد کنید و الگوی برنامه iOS را انتخاب کنید.
3. همه ارجاع‌های موجود به Maps، «ناوبری»، و Places را از پروژه بردارید.
4. XCFrameworks زیر را به پروژه خود در بخش چارچوب‌ها، کتابخانه‌ها، و محتوای جاسازی‌شده بکشید تا هر دو کیت توسعه نرم‌افزار Maps و Navigation نصب شوند (وقتی درخواست شد، درصورت نیاز، موارد را کپی کن را انتخاب کنید):
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. GoogleMaps.bundle را از GoogleMapsResources که بارگیری کرده‌اید به دایرکتوری سطح بالای پروژه Xcode خود بکشید. وقتی درخواست شد، مطمئن شوید کپی کردن موارد درصورت نیاز انتخاب شده باشد.
6. GoogleNavigation.bundle را از GoogleNavigationResources که بارگیری کرده‌اید به دایرکتوری سطح بالای پروژه Xcode خود بکشید. وقتی از شما خواسته شد، مطمئن شوید کپی کردن موارد در پوشه گروه مقصد انتخاب شده باشد.
7. پروژه‌تان را از Project Navigator انتخاب کنید و هدف برنامه‌تان را انتخاب کنید.
8. برگه Build Phases را باز کنید و در Link Binary with Libraries، چارچوب‌ها و کتابخانه‌های زیر را اضافه کنید:
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CarPlay.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • MapKit.framework
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. در هدف برنامه، برگه قابلیت‌ها را انتخاب کنید، حالت‌های پس‌زمینه را روشن کنید، و حالت‌های زیر را فعال کنید:
   • صدا، AirPlay، و تصویردرتصویر
   • به‌روزرسانی‌های مکان
10. پروژه‌تان را به‌جای هدف خاصی انتخاب کنید و برگه تنظیمات ساخت را باز کنید. در بخش Other Linker Flags، ‑ObjC را برای هر دو debug و release اضافه کنید. اگر این تنظیمات قابل‌مشاهده نیستند، فیلتر را در نوار Build Settings (تنظیمات ساخت) از Basic (پایه) به All (همه) تغییر دهید.
11. ‫Info.plist را باز کنید و جفت‌های کلید-مقدار زیر را اضافه کنید:
    • کلید: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      مقدار: «این برنامه برای ناوبری گام‌به‌گام به اجازه استفاده از مکان شما نیاز دارد.»
    • کلید: NSLocationAlwaysAndWhenInUseUsageDescription (حریم خصوصی - مکان همیشه و هنگام استفاده شرح استفاده)
      مقدار: «این برنامه برای استفاده از مکان شما برای ناوبری گام‌به‌گام به اجازه نیاز دارد.»

Swift

کلید میانای برنامه‌سازی کاربردی خود را به AppDelegate.swift خود به این صورت اضافه کنید:

1. عبارت‌های وارد کردن زیر را اضافه کنید:

   import GoogleMaps
   import GoogleNavigation

2. مورد زیر را به روش application(_:didFinishLaunchingWithOptions:) اضافه کنید:

   GMSServices.provideAPIKey("YOUR_API_KEY")

آبجکتیو-سی

کلید میانای برنامه‌سازی کاربردی را به‌صورت زیر به AppDelegate.m اضافه کنید:

1. بیانیه‌های وارد کردن زیر را اضافه کنید:

   @import GoogleMaps;
   @import GoogleNavigation;

2. موارد زیر را به روش application:didFinishLaunchingWithOptions: اضافه کنید:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];