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

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

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

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

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

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

مرحله ۲: ایجاد پروژه Xcode و نصب «کیت توسعه نرم‌افزار مکان‌ها» برای iOS

Swift Package Manager

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

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

  1. Xcode project یا workspace را باز کنید، سپس به File > Add Package Dependencies بروید.
  2. https://github.com/googlemaps/ios-places-sdk را به‌عنوان نشانی وب وارد کنید، کلید Enter را فشار دهید تا بسته را وارد کنید، و روی «افزودن بسته» کلیک کنید.
  3. برای نصب version خاص، فیلد قانون وابستگی را روی یکی از گزینه‌های مبتنی بر نسخه تنظیم کنید. برای پروژه‌های جدید، توصیه می‌کنیم جدیدترین نسخه را مشخص کنید و از گزینه «نسخه دقیق» استفاده کنید. پس‌از تکمیل، روی «افزودن بسته» کلیک کنید.
  4. در پنجره انتخاب محصولات بسته، تأیید کنید که GooglePlaces، GooglePlacesSwift، یا هر دو به هدف اصلی تعیین‌شده شما اضافه خواهند شد. پس‌از تکمیل، روی افزودن بسته کلیک کنید.

    اگر Google Places Swift را از نشانی وب GitHub منسوخ‌شده به‌روز می‌کنید

    مهم: نشانی وب GitHub برای دسترسی به Google Places Swift از نسخه 0.3.0 تغییر کرده است. اگر درحال به‌روزرسانی نسخه‌ای از GooglePlacesSwift هستید که ازطریق نشانی وب قدیمی https://github.com/googlemaps/ios-places-swift-sdk به آن دسترسی پیدا کرده‌اید، آن را از بخش وابستگی‌های بسته Xcode بردارید.

  5. برای درستی‌سنجی نصب، به قاب General (کلی) هدف بروید. در Frameworks, Libraries, and Embedded Content، باید بسته‌های نصب‌شده را ببینید. همچنین می‌توانید بخش وابستگی‌های بسته در Project Navigator را برای درستی‌سنجی بسته و نسخه آن مشاهده کنید.

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

  1. از Xcode، به فایل > بسته‌ها > به‌روزرسانی به جدیدترین نسخه‌های بسته بروید.

    اگر Google Places Swift را از نشانی وب GitHub منسوخ‌شده به‌روز می‌کنید

    مهم: نشانی وب GitHub برای دسترسی به Google Places Swift از نسخه 0.3.0 تغییر کرده است. اگر درحال به‌روزرسانی نسخه‌ای از GooglePlacesSwift هستید که ازطریق نشانی وب قدیمی https://github.com/googlemaps/ios-places-swift-sdk به آن دسترسی پیدا کرده‌اید، آن را از بخش وابستگی‌های بسته Xcode بردارید.

  2. برای درستی‌سنجی نصب، به بخش وابستگی‌های بسته در Project Navigator بروید تا بسته و نسخه آن را درستی‌سنجی کنید.

برای برداشتن «کیت توسعه نرم‌افزار مکان‌ها» ویژه iOS که به‌صورت دستی نصب شده است، این مراحل را دنبال کنید:

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

نصب دستی

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

  1. فایل‌های منبع و دودویی کیت توسعه نرم‌افزار زیر را بارگیری کنید:
  2. اگر Places Swift SDK for iOS را نصب می‌کنید، فایل‌های زیر را نصب کنید:
  3. فایل‌ها را از حالت فشرده خارج کنید تا به XCFramework و منابع دسترسی پیدا کنید.
  4. Xcode را راه‌اندازی کنید و پروژه موجودی را باز کنید یا پروژه جدیدی ایجاد کنید. اگر در توسعه iOS تازه‌کار هستید، پروژه جدیدی ایجاد کنید و الگوی برنامه iOS را انتخاب کنید.
  5. هرگونه دسته Maps از نسخه‌های قبلی را از پروژه‌تان بردارید.
  6. برگه عمومی را باز کنید. XCFramework زیر را به پروژه‌تان در بخش چارچوب‌ها، کتابخانه‌ها، و محتوای جاسازی‌شده بکشید. حتماً جاسازی نشود را انتخاب کنید:
    • GooglePlaces.xcframework
    اگر Places Swift SDK را نصب می‌کنید، XCFramework زیر را به پروژه‌تان در بخش چارچوب‌ها، کتابخانه‌ها، و محتوای جاسازی‌شده بکشید. حتماً جاسازی نشود را انتخاب کنید:
    • GooglePlacesSwift.xcframework
  7. GooglePlaces.bundle را از GooglePlacesResources که بارگیری کرده‌اید در دایرکتوری سطح بالای پروژه Xcode خود کپی کنید. حتماً کپی کردن موارد در پوشه گروه مقصد را هنگام درخواست انتخاب کنید.

    اگر درحال نصب Places Swift SDK هستید، GooglePlacesSwift.bundle را از GooglePlacesSwiftResources که بارگیری کرده‌اید در دایرکتوری سطح بالای پروژه Xcode خود کپی کنید. هنگام درخواست، حتماً کپی کردن موارد در پوشه گروه مقصد را انتخاب کنید.
  8. پروژه‌تان را از Project Navigator انتخاب کنید و هدف برنامه‌تان را انتخاب کنید.
  9. برگه Build Phases (مراحل ساخت) را باز کنید. در پیوند دودویی با کتابخانه‌ها، چارچوب‌ها و کتابخانه‌های زیر را اضافه کنید:
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework
  10. پروژه‌تان را به‌جای هدف خاصی انتخاب کنید و برگه تنظیمات ساخت را باز کنید. در بخش Linking - General -> Other Linker Flags، -ObjC را به «Debug» و «Release» اضافه کنید. اگر این تنظیمات قابل‌مشاهده نیست، فیلتر را در نوار تنظیمات ساخت از پایه به همه تغییر دهید.

مرحله ۳: کلید میانای API را به برنامه‌تان اضافه کنید

در مثال‌های زیر، YOUR_API_KEY را با کلید میانای API خودتان جایگزین کنید.

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

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

  • عبارت وارد کردن زیر را اضافه کنید:
    import GooglePlacesSwift
  • موارد زیر را به روش application(_:didFinishLaunchingWithOptions:) خود اضافه کنید و YOUR_API_KEY را با کلید میانای برنامه‌سازی کاربردی خود جایگزین کنید:
    PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

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

  • عبارت وارد کردن زیر را اضافه کنید:
    import GooglePlaces
  • موارد زیر را به روش application(_:didFinishLaunchingWithOptions:) خود اضافه کنید و YOUR_API_KEY را با کلید میانای برنامه‌سازی کاربردی خود جایگزین کنید:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

آبجکتیو-سی

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

  • عبارت وارد کردن زیر را اضافه کنید:
    @import GooglePlaces;
  • موارد زیر را به روش application:didFinishLaunchingWithOptions: خود اضافه کنید و YOUR_API_KEY را با کلید میانای برنامه‌سازی کاربردی خود جایگزین کنید:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

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

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

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

مراحل بعدی