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

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

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

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

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

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

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

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

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

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

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

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

  1. از Xcode، به مسیر File > Packages > Update To Latest Package Versions بروید.
  2. برای تأیید نصب خود، به بخش وابستگی‌های بسته‌بندی در Project Navigator بروید تا بسته و نسخه آن را تأیید کنید.

برای حذف دستی کیت توسعه نرم‌افزار ناوبری (Navigation SDK) موجود برای iOS که به صورت دستی نصب شده است، این مراحل را دنبال کنید:
  1. از تنظیمات پیکربندی پروژه Xcode خود، Frameworks، Libraries و Embedded Content را پیدا کنید. از علامت منها (-) برای حذف framework زیر استفاده کنید:
    • 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 زیر را دانلود کنید:
  2. Xcode را اجرا کنید و یا یک پروژه موجود را باز کنید، یا یک پروژه جدید ایجاد کنید. اگر در iOS تازه‌کار هستید، یک پروژه جدید ایجاد کنید و الگوی iOS App را انتخاب کنید.
  3. تمام ارجاعات نقشه‌ها، ناوبری و مکان‌های موجود را از پروژه حذف کنید.
  4. فایل‌های XCFrameworks زیر را در قسمت Frameworks، Libraries و Embedded Content به پروژه خود بکشید تا SDK های Maps و Navigation نصب شوند (در صورت درخواست، در صورت نیاز گزینه Copy items را انتخاب کنید):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. GoogleMaps.bundle از GoogleMapsResources که دانلود کرده‌اید، به دایرکتوری سطح بالای پروژه Xcode خود بکشید. در صورت درخواست، مطمئن شوید که گزینه Copy items if needed انتخاب شده باشد.
  6. GoogleNavigation.bundle از GoogleNavigationResources که دانلود کرده‌اید، به دایرکتوری سطح بالای پروژه Xcode خود بکشید. وقتی از شما خواسته شد، مطمئن شوید که گزینه Copy items into destination group’s folder انتخاب شده باشد.
  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. در پوشه‌ی هدف برنامه‌ی خود، تب Capabilities را انتخاب کنید، حالت‌های پس‌زمینه (Background Modes ) را فعال کنید و حالت‌های زیر را فعال کنید:
    • صدا، ایرپلی و تصویر در تصویر
    • به‌روزرسانی‌های مکان
  10. پروژه خود را انتخاب کنید، نه یک هدف خاص، و برگه Build Settings را باز کنید. در بخش Other Linker Flags ، برای هر دو حالت اشکال‌زدایی و انتشار ‑ObjC را اضافه کنید. اگر این تنظیمات قابل مشاهده نیستند، فیلتر را در نوار Build Settings از Basic به All تغییر دهید.
  11. Info.plist را باز کنید و جفت‌های کلید-مقدار زیر را اضافه کنید:
    • کلید: NSLocationWhenInUseUsageDescription ( حریم خصوصی - توضیحات استفاده از موقعیت مکانی هنگام استفاده )
      مقدار: "این برنامه برای استفاده از موقعیت مکانی شما جهت پیمایش گام به گام به مجوز نیاز دارد."
    • کلید: NSLocationAlwaysAndWhenInUseUsageDescription ( حریم خصوصی - توضیحات استفاده از موقعیت مکانی همیشه و هنگام استفاده )
      مقدار: "این برنامه برای استفاده از موقعیت مکانی شما جهت پیمایش گام به گام به مجوز نیاز دارد."

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

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

سویفت

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

  1. دستورات import زیر را اضافه کنید: 
    import GoogleMaps
import GoogleNavigation
  2. کد زیر را به متد application(_:didFinishLaunchingWithOptions:) خود اضافه کنید: 
    GMSServices.provideAPIKey("YOUR_API_KEY")

هدف-سی

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

  1. دستورات import زیر را اضافه کنید: 
    @import GoogleMaps;
@import GoogleNavigation;
  2. متد application:didFinishLaunchingWithOptions: خود اضافه کنید: 
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

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

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

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

اگر شما مشتری خدمات حمل و نقل هستید

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

قدم بعدی چیست؟

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