یک پروژه 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، به «فایل > بسته‌ها > به‌روزرسانی به آخرین نسخه‌های بسته» بروید.

   اگر در حال به‌روزرسانی 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 تغییر دهید.

کوکوپادز

کیت توسعه نرم‌افزار Places برای iOS و کیت توسعه نرم‌افزار Places Swift برای iOS به صورت پادهای CocoaPod ، GooglePlaces و GooglePlacesSwift در دسترس هستند.

CocoaPods یک مدیر وابستگی متن‌باز برای پروژه‌های Cocoa زبان‌های Swift و Objective-C است. اگر ابزار CocoaPods را از قبل ندارید، با اجرای دستور زیر از ترمینال، آن را روی macOS نصب کنید. برای جزئیات بیشتر، به راهنمای شروع به کار با CocoaPods مراجعه کنید.

sudo gem install cocoapods

برای نصب SDK ها و وابستگی های آنها، یک Podfile ایجاد کنید:

1. اگر هنوز پروژه Xcode ندارید، همین حالا یکی ایجاد کنید و آن را در دستگاه محلی خود ذخیره کنید. اگر در توسعه iOS تازه‌کار هستید، یک پروژه جدید ایجاد کنید و الگوی iOS App را انتخاب کنید.
2. فایلی با نام Podfile در دایرکتوری پروژه خود ایجاد کنید. این فایل وابستگی‌های پروژه شما را تعریف می‌کند.
3. Podfile ویرایش کنید و وابستگی‌های خود را به همراه نسخه‌های آنها اضافه کنید. در اینجا مثالی آورده شده است که نام هدف برنامه شما و نام‌های پادهای GooglePlaces و GooglePlacesSwift را مشخص می‌کند:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '10.8.0'
     pod 'GooglePlacesSwift', '10.8.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 خود را به صورت زیر به 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"];