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

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

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

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

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

  • نسخه Xcode 16.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" کلیک کنید.

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

  1. برای تأیید نصب خود، به بخش وابستگی‌های بسته‌بندی در 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 ( حریم خصوصی - توضیحات استفاده از موقعیت مکانی همیشه و هنگام استفاده )
      مقدار: "این برنامه برای استفاده از موقعیت مکانی شما جهت پیمایش گام به گام به مجوز نیاز دارد."

کوکوپادز

کیت توسعه نرم‌افزار ناوبری (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 > App را انتخاب کنید.
    3. در صفحه گزینه‌های پروژه:
      1. نام پروژه را وارد کنید.
      2. مقدار فیلد شناسه بسته (Bundle identifier) ​​را ثبت کنید. می‌توانید از آن مقدار برای محدود کردن کلید API خود در زیر استفاده کنید.
      3. رابط پروژه را روی Storyboard تنظیم کنید.
      4. زبان را روی Swift یا Objective-C تنظیم کنید.
  2. فایلی با نام Podfile در دایرکتوری پروژه خود ایجاد کنید. این فایل وابستگی‌های پروژه شما را تعریف می‌کند.
  3. Podfile ویرایش کنید و وابستگی‌های خود را به همراه نسخه‌های آنها اضافه کنید. در اینجا مثالی آورده شده است که شامل وابستگی مورد نیاز برای Navigation SDK برای iOS است: # مرجع نصب Cocoapods #
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleNavigation', '10.4.0'
end
    مطمئن شوید که مرتباً pod outdated اجرا می‌کنید تا نسخه‌های جدیدتر را شناسایی کند. در صورت لزوم، آن را به آخرین نسخه ارتقا دهید .
  4. Podfile ذخیره کنید.

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

    cd <path-to-project>

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

    pod install

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

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

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

مرحله ۳: کلید 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 آموزش‌هایی را ارائه می‌دهد که می‌تواند به شما در شروع کار کمک کند. برای جزئیات بیشتر، به موارد زیر مراجعه کنید: