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

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

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

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

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

   اگر در حال به‌روزرسانی Google Places Swift از آدرس اینترنتی منسوخ‌شده‌ی GitHub هستید

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

5. برای تأیید نصب، به بخش عمومی (General ) سیستم هدف خود بروید. در قسمت‌های چارچوب‌ها (Frameworks)، کتابخانه‌ها (Libraries) و محتوای جاسازی‌شده (Embedded Content )، باید بسته‌های نصب‌شده را مشاهده کنید. همچنین می‌توانید بخش وابستگی‌های بسته (Package Dependencies) در Project Navigator را مشاهده کنید تا بسته و نسخه آن را تأیید کنید.

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

1. از Xcode، به مسیر File > Packages > Update To Latest Package Versions بروید.

   اگر در حال به‌روزرسانی Google Places Swift از آدرس اینترنتی منسوخ‌شده‌ی GitHub هستید

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

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

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

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

نصب دستی

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

1. فایل‌های باینری و منابع SDK زیر را دانلود کنید:
   • گوگل‌پلیس
   • منابع GooglePlaces
2. اگر در حال نصب Places Swift SDK برای iOS هستید، فایل‌های زیر را نصب کنید:
   • گوگل‌پلیس سویفت
   • منابع GooglePlacesSwift
3. برای دسترسی به XCFramework و منابع، فایل‌ها را استخراج کنید.
4. Xcode را اجرا کنید و یا یک پروژه موجود را باز کنید، یا یک پروژه جدید ایجاد کنید. اگر در توسعه iOS تازه‌کار هستید، یک پروژه جدید ایجاد کنید و الگوی iOS App را انتخاب کنید.
5. هرگونه بسته نقشه از نسخه‌های قبلی را از پروژه خود حذف کنید.
6. برگه عمومی (General) را باز کنید. XCFramework زیر را در قسمت چارچوب‌ها (Frameworks)، کتابخانه‌ها (Libraries) و محتوای جاسازی‌شده (Embedded Content) به پروژه خود بکشید (drag) و رها کنید. مطمئن شوید که گزینه «عدم جاسازی» (Do Not Embed) را انتخاب کرده‌اید:
   • GooglePlaces.xcframework
   اگر در حال نصب Places Swift SDK هستید، XCFramework زیر را در قسمت Frameworks، Libraries و Embedded Content به پروژه خود بکشید. مطمئن شوید که گزینه Do Not Embed را انتخاب کرده‌اید:
   • GooglePlacesSwift.xcframework
7. فایل GooglePlaces.bundle را از GooglePlacesResources که دانلود کرده‌اید، در دایرکتوری سطح بالای پروژه Xcode خود کپی کنید. هنگام درخواست، حتماً گزینه Copy items into destination group’s folder را انتخاب کنید.
   
   اگر در حال نصب Places Swift SDK هستید، فایل GooglePlacesSwift.bundle را از GooglePlacesSwiftResources که دانلود کرده‌اید، در دایرکتوری سطح بالای پروژه Xcode خود کپی کنید. هنگام درخواست، حتماً گزینه Copy items into destination group’s folder را انتخاب کنید.
8. پروژه خود را از Project Navigator انتخاب کنید و هدف برنامه خود را نیز مشخص کنید.
9. تب Build Phases را باز کنید. در داخل Link Binary with Libraries ، فریم‌ورک‌ها و کتابخانه‌های زیر را اضافه کنید:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

10. پروژه خود را انتخاب کنید، نه یک هدف خاص، و برگه تنظیمات ساخت را باز کنید. در بخش Linking - General -> Other Linker Flags ، -ObjC را به "Debug" و "Release" اضافه کنید. اگر این تنظیمات قابل مشاهده نیستند، فیلتر را در نوار تنظیمات ساخت از Basic به All تغییر دهید.

گوگل‌پلیس سویفت

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

• عبارت import زیر را اضافه کنید:

  import GooglePlacesSwift

• کد زیر را به application(_:didFinishLaunchingWithOptions:) خود اضافه کنید و YOUR_API_KEY را با کلید API خود جایگزین کنید:

  PlacesClient.provideAPIKey("YOUR_API_KEY")

سویفت

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

• عبارت import زیر را اضافه کنید:

  import GooglePlaces

• کد زیر را به application(_:didFinishLaunchingWithOptions:) خود اضافه کنید و YOUR_API_KEY را با کلید API خود جایگزین کنید:

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

هدف-سی

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

• عبارت import زیر را اضافه کنید:

  @import GooglePlaces;

• کد زیر را به application:didFinishLaunchingWithOptions: خود اضافه کنید و YOUR_API_KEY را با کلید API خود جایگزین کنید:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];