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

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

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

مرحله ۱: نصب نرم‌افزار موردنیاز

برای ساختن پروژه بااستفاده از «کیت توسعه نرم‌افزار ناوبری» برای iOS، باید موارد زیر را بارگیری و نصب کنید:

  • Xcode نسخه ۲۶.۰ یا بالاتر

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

Swift Package Manager

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

برای افزودن 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 باید بسته‌های نصب‌شده را ببینید. همچنین می‌توانید بخش «وابستگی‌های بسته» را در «Project Navigator» مشاهده کنید تا بسته و نسخه آن را تأیید کنید.

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

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

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

نصب دستی

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

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

  1. فایل‌های منبع و دودویی کیت توسعه نرم‌افزار زیر را بارگیری کنید:
  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 اضافه کنید. اگر این تنظیمات قابل‌مشاهده نیست، فیلتر را در نوار تنظیمات ساخت از پایه به همه تغییر دهید.
  11. Info.plist را باز کنید و جفت‌های کلید-مقدار زیر را اضافه کنید:
    • کلید: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      مقدار: «این برنامه برای ناوبری گام‌به‌گام به اجازه استفاده از مکان شما نیاز دارد.»
    • کلید: NSLocationAlwaysAndWhenInUseUsageDescription (Privacy - Location Always and When In Use Usage Description)
      مقدار: «این برنامه برای استفاده از مکان شما برای ناوبری گام‌به‌گام به اجازه نیاز دارد.»

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

نمونه‌های زیر نحوه افزودن کلید میانای API به پروژه در Xcode را نشان می‌دهد:

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"];

مرحله ۴ (اختیاری): بررسی فایل «مانیفست حریم خصوصی Apple»

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

فایل «مانیفست حریم خصوصی Apple» در دسته منابع کیت توسعه نرم‌افزار گنجانده شده است. برای تأیید اینکه «فایل مانیفست حریم خصوصی» اضافه شده است و برای بررسی محتوای آن، بایگانی‌ای از برنامه‌تان ایجاد کنید و از بایگانی گزارش حریم خصوصی تولید کنید.

اگر مشتری «خدمات جابه‌جایی» هستید

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

قدم بعدی چیست

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