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

پس از فعال کردن صورتحساب و ایجاد یک کلید API، آماده راه اندازی پروژه Xcode هستید که برای توسعه برنامه خود استفاده می کنید.

یادداشت های انتشار برای هر نسخه در دسترس هستند.

مرحله 1: نرم افزار مورد نیاز را نصب کنید

برای ساخت یک پروژه با استفاده از Navigation SDK برای iOS، باید دانلود و نصب کنید:

• Xcode نسخه 15.0 یا بالاتر

مرحله 2: پروژه Xcode را ایجاد کرده و Navigation SDK را نصب کنید

مدیر بسته سوئیفت

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

مهم: این دستورالعمل‌ها استفاده از Xcode 15 یا بالاتر را فرض می‌کنند، اما باید برای نسخه‌های قبلی Xcode مشابه باشند.

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

1. project یا workspace Xcode خود را باز کنید، سپس به File > Add Package Dependencies بروید.
2. https://github.com/googlemaps/ios-navigation-sdk را به عنوان URL وارد کنید، Enter را فشار دهید تا بسته را وارد کنید و روی «افزودن بسته» کلیک کنید.
3. برای نصب یک version خاص، قسمت Dependency Rule را روی یکی از گزینه های مبتنی بر نسخه تنظیم کنید. برای پروژه های جدید، توصیه می کنیم آخرین نسخه را مشخص کنید و از گزینه "نسخه دقیق" استفاده کنید. پس از تکمیل، روی "افزودن بسته" کلیک کنید.

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

1. برای تأیید نصب خود، به بخش Package Dependencies در Project Navigator بروید تا بسته و نسخه آن را تأیید کنید.

مهم: گاهی اوقات، مصنوعات قابل حل نیستند یا ممکن است خطاهایی رخ دهد، در این مورد "File > Packages > Reset Package Cache" را انتخاب کنید.

برای حذف Navigation SDK موجود برای iOS که به صورت دستی نصب شده است، این مراحل را دنبال کنید:

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

نصب دستی

این راهنما نحوه اضافه کردن دستی XCFrameworks حاوی Navigation SDK برای iOS و Maps SDK برای iOS را به پروژه خود و پیکربندی تنظیمات ساخت خود در Xcode نشان می دهد. XCFramework یک بسته باینری است که می‌توانید از آن در چندین پلتفرم از جمله ماشین‌هایی که از چیپست M1 استفاده می‌کنند استفاده کنید.

برای نصب XCFrameworks برای Navigation SDK برای iOS و Maps SDK برای iOS این مراحل را دنبال کنید:

1. فایل های باینری و منبع SDK زیر را دانلود کنید:
   • GoogleMaps
   • GoogleMapsResources
   • Google Navigation
   • Google NavigationResources
2. Xcode را راه اندازی کنید و یک پروژه موجود را باز کنید یا یک پروژه جدید ایجاد کنید. اگر در iOS تازه کار هستید، یک پروژه جدید ایجاد کنید و الگوی برنامه iOS را انتخاب کنید.
3. تمام مراجع نقشه ها، ناوبری و مکان های موجود را از پروژه حذف کنید.
   مهم: Places SDK برای iOS همراه با Navigation SDK برای iOS نیست و باید جداگانه نصب شود. این در نسخه 5.0 Places SDK برای iOS صادق است. گوگل توصیه می کند که همان نسخه های Places SDK برای iOS و Navigation SDK برای iOS را دانلود و نصب کنید. به نصب Places SDK برای iOS مراجعه کنید.
4. XCFrameworks زیر را به داخل پروژه خود در بخش Frameworks, Libraries, and Embedded Content بکشید تا Maps و Navigation SDK را نصب کنید (در صورت درخواست، کپی موارد را در صورت نیاز انتخاب کنید):
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. GoogleMaps.bundle از GoogleMapsResources که دانلود کرده‌اید به دایرکتوری سطح بالای پروژه Xcode خود بکشید. هنگامی که از شما خواسته شد، اطمینان حاصل کنید که موارد کپی در صورت نیاز انتخاب شده است.
6. GoogleNavigation.bundle از GoogleNavigationResources که دانلود کرده‌اید به فهرست سطح بالای پروژه Xcode خود بکشید. هنگامی که از شما خواسته شد، مطمئن شوید که موارد کپی در پوشه گروه مقصد انتخاب شده است.
7. پروژه خود را از Project Navigator انتخاب کنید و هدف برنامه خود را انتخاب کنید.
8. تب Build Phases را باز کنید و در لینک باینری با کتابخانه ها ، چارچوب ها و کتابخانه های زیر را اضافه کنید:
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.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
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. در هدف برنامه خود، برگه قابلیت ها را انتخاب کنید، حالت های پس زمینه را روشن کنید و حالت های زیر را فعال کنید:
   • صدا، پخش و تصویر در تصویر
   • به روز رسانی مکان
10. پروژه خود را به جای یک هدف خاص انتخاب کنید و تب Build Settings را باز کنید. در بخش Other Linker Flags ، ‑ObjC هم برای رفع اشکال و هم برای انتشار اضافه کنید. اگر این تنظیمات قابل مشاهده نیستند، فیلتر موجود در نوار تنظیمات ساخت را از Basic به All تغییر دهید.
11. Info.plist را باز کنید و جفت های کلید-مقدار زیر را اضافه کنید:
    • کلید: NSLocationWhenInUseUsageDescription ( حریم خصوصی - موقعیت مکانی هنگام استفاده توضیحات استفاده )
      مقدار: "این برنامه برای استفاده از موقعیت مکانی شما برای پیمایش گام به گام به مجوز نیاز دارد."
    • کلید: NSLocationAlwaysAndWhenInUseUsageDescription ( حریم خصوصی - موقعیت مکانی همیشه و زمانی که در استفاده است توضیحات استفاده )
      مقدار: "این برنامه برای استفاده از موقعیت مکانی شما برای پیمایش گام به گام به مجوز نیاز دارد."

CocoaPods

Navigation SDK برای iOS به عنوان یک CocoaPods در دسترس است. CocoaPods یک مدیر وابستگی منبع باز برای پروژه های Swift و Objective-C Cocoa است.

اگر از قبل ابزار CocoaPods را ندارید، با اجرای دستور زیر از ترمینال، آن را روی macOS نصب کنید. برای جزئیات، به راهنمای شروع به کار CocoaPods مراجعه کنید.

sudo gem install cocoapods

یک Podfile برای Navigation SDK برای iOS ایجاد کنید و از آن برای نصب API و وابستگی های آن استفاده کنید:

1. اگر هنوز پروژه Xcode ندارید، اکنون یکی را ایجاد کرده و آن را در دستگاه محلی خود ذخیره کنید. اگر در توسعه iOS تازه کار هستید:
   1. یک پروژه جدید ایجاد کنید.
   2. iOS > قالب برنامه را انتخاب کنید.
   3. در صفحه گزینه های پروژه:
      1. نام پروژه را وارد کنید.
      2. مقدار فیلد شناسه Bundle را ثبت کنید. می توانید از این مقدار برای محدود کردن کلید API خود در زیر استفاده کنید.
      3. Interface پروژه را روی Storyboard قرار دهید.
      4. زبان را روی Swift یا Objective-C قرار دهید.
2. یک فایل به نام Podfile در دایرکتوری پروژه خود ایجاد کنید. این فایل وابستگی های پروژه شما را تعریف می کند.
3. Podfile را ویرایش کنید و وابستگی های خود را به همراه نسخه های آنها اضافه کنید. در اینجا یک مثال است که شامل وابستگی مورد نیاز برای Navigation SDK برای iOS است: # مرجع نصب Cocoapods #

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleNavigation', '9.2.0'
   end
           

   مطمئن شوید که به طور منظم pod outdated را اجرا می کنید تا نسخه های جدیدتر را شناسایی کنید. در صورت لزوم، به آخرین نسخه ارتقا دهید .
4. Podfile را ذخیره کنید.

5. یک ترمینال را باز کنید و به دایرکتوری حاوی Podfile بروید:

   cd <path-to-project>

6. دستور pod install را اجرا کنید. این API های مشخص شده در Podfile را به همراه هر وابستگی نصب می کند.

   pod install

7. Xcode را ببندید و سپس فایل .xcworkspace پروژه خود را باز کنید (دوبار کلیک کنید) تا Xcode راه اندازی شود. از این زمان به بعد باید از فایل .xcworkspace برای باز کردن پروژه استفاده کنید.

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

1. یک ترمینال را باز کنید و به فهرست پروژه حاوی Podfile بروید.
2. دستور pod update را اجرا کنید. این همه API های مشخص شده در Podfile را به آخرین نسخه به روز می کند.

مرحله 3: کلید API خود را به پروژه اضافه کنید

مثال های زیر نشان می دهد که چگونه کلید API را در Xcode به پروژه خود اضافه کنید:

سویفت

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

1. دستورهای واردات زیر را اضافه کنید:

   import GoogleMaps
   import GoogleNavigation

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

   GMSServices.provideAPIKey("YOUR_API_KEY")

هدف-C

کلید API خود را به صورت زیر به AppDelegate.m خود اضافه کنید:

1. دستورهای واردات زیر را اضافه کنید:

   @import GoogleMaps;
   @import GoogleNavigation;

2. موارد زیر را به application:didFinishLaunchingWithOptions: متد:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

مرحله 4 (اختیاری): فایل Apple Privacy Manifest را بررسی کنید

توجه: موارد زیر در هنگام استقرار برنامه خود در فروشگاه وب مرتبط است.

اپل به جزئیات حریم خصوصی برنامه برای برنامه های موجود در فروشگاه App نیاز دارد. برای به‌روزرسانی‌ها و اطلاعات بیشتر، از صفحه جزئیات حریم خصوصی فروشگاه App Apple دیدن کنید.

فایل Apple Privacy Manifest در بسته منابع برای SDK گنجانده شده است. برای تأیید اینکه فایل Manifest Privacy گنجانده شده است و برای بررسی محتوای آن، یک بایگانی از برنامه خود ایجاد کنید و یک گزارش حریم خصوصی از بایگانی ایجاد کنید .

اگر مشتری Mobility Services هستید

اگر مشتری Mobility Services هستید، در مورد صورتحساب در اسناد Mobility اطلاعات کسب کنید. برای اطلاعات بیشتر درباره ثبت تراکنش‌ها، به تنظیم صورت‌حساب مراجعه کنید. برای آشنایی با نحوه افزودن شناسه‌های تراکنش به پیاده‌سازی Navigation SDK، به مرتبط کردن استفاده از سرویس خود با تراکنش‌های Mobility مراجعه کنید.

بعدش چی

اکنون که یک کلید API و یک پروژه Xcode دارید، می توانید برنامه ها را ایجاد و اجرا کنید. Navigation SDK برای iOS آموزش هایی را ارائه می دهد که می تواند به شما در شروع کار کمک کند. برای جزئیات بیشتر، نگاه کنید به:

• آموزش ها
  • مسیری را پیمایش کنید
  • به رویدادهای ناوبری گوش دهید
• نمونه کد و Codelab