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

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

Places SDK برای iOS را می توان از طریق Swift Package Manager نصب کرد. برای افزودن SDK، مطمئن شوید که هر مکان 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 را روی یکی از گزینه های مبتنی بر نسخه تنظیم کنید. برای پروژه های جدید، توصیه می کنیم آخرین نسخه را مشخص کنید و از گزینه "نسخه دقیق" استفاده کنید. پس از تکمیل، روی "افزودن بسته" کلیک کنید.
4. از پنجره انتخاب محصولات بسته ، بررسی کنید که GooglePlaces ، GooglePlacesSwift یا هر دو به هدف اصلی تعیین‌شده شما اضافه شود. پس از تکمیل، روی Add Package کلیک کنید.

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

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

5. برای تأیید نصب خود، به صفحه عمومی هدف خود بروید. در Frameworks، Libraries و Embedded Content ، باید بسته های نصب شده را ببینید. همچنین می‌توانید بخش Package Dependencies در Project Navigator را مشاهده کنید تا بسته و نسخه آن را تأیید کنید. Xcode نسخه GitHub را نشان می دهد که با نسخه GooglePlaces (به عنوان مثال 9.2.0) مطابقت دارد اما با نسخه GooglePlacesSwift (مثلا 0.3.0) مطابقت ندارد.

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

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

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

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

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

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

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

نصب دستی

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

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

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

CocoaPods

Places SDK برای iOS و Places Swift SDK برای iOS (پیش‌نمایش) به‌عنوان pods CocoaPod ، GooglePlaces و GooglePlacesSwift در دسترس هستند.

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

sudo gem install cocoapods

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

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

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '9.2.0'
     pod 'GooglePlacesSwift', '0.3.0'
   end

   مطمئن شوید که به‌طور مرتب pod outdated را اجرا می‌کنید تا تشخیص دهید که نسخه جدیدتری وجود دارد تا مطمئن شوید که همیشه در آخرین نسخه هستید.
4. Podfile را ذخیره کنید.

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

   cd <path-to-project>

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

   pod install

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

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

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

سویفت

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

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

  import GooglePlaces

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

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

هدف-C

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

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

  @import GooglePlaces;

• روش زیر را به application:didFinishLaunchingWithOptions: متد، YOUR_API_KEY را با کلید API خود جایگزین کنید:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

GooglePlacesSwift

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

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

  import GooglePlacesSwift

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

  PlacesClient.provideAPIKey("YOUR_API_KEY")

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

Places SDK برای iOS را می توان از طریق Swift Package Manager نصب کرد. برای افزودن SDK، مطمئن شوید که هر مکان 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 را روی یکی از گزینه های مبتنی بر نسخه تنظیم کنید. برای پروژه های جدید، توصیه می کنیم آخرین نسخه را مشخص کنید و از گزینه "نسخه دقیق" استفاده کنید. پس از تکمیل، روی "افزودن بسته" کلیک کنید.
4. از پنجره انتخاب محصولات بسته ، بررسی کنید که GooglePlaces ، GooglePlacesSwift یا هر دو به هدف اصلی تعیین‌شده شما اضافه شود. پس از تکمیل، روی Add Package کلیک کنید.

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

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

5. برای تأیید نصب خود، به صفحه عمومی هدف خود بروید. در Frameworks، Libraries و Embedded Content ، باید بسته های نصب شده را ببینید. همچنین می‌توانید بخش Package Dependencies در Project Navigator را مشاهده کنید تا بسته و نسخه آن را تأیید کنید. Xcode نسخه GitHub را نشان می دهد که با نسخه GooglePlaces (به عنوان مثال 9.2.0) مطابقت دارد اما با نسخه GooglePlacesSwift (مثلا 0.3.0) مطابقت ندارد.

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

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

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

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

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

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

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

نصب دستی

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

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

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

CocoaPods

Places SDK برای iOS و Places Swift SDK برای iOS (پیش‌نمایش) به‌عنوان pods CocoaPod ، GooglePlaces و GooglePlacesSwift در دسترس هستند.

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

sudo gem install cocoapods

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

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

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '9.2.0'
     pod 'GooglePlacesSwift', '0.3.0'
   end

   مطمئن شوید که به‌طور مرتب pod outdated را اجرا می‌کنید تا تشخیص دهید که نسخه جدیدتری وجود دارد تا مطمئن شوید که همیشه در آخرین نسخه هستید.
4. Podfile را ذخیره کنید.

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

   cd <path-to-project>

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

   pod install

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

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

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

سویفت

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

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

  import GooglePlaces

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

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

هدف-C

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

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

  @import GooglePlaces;

• روش زیر را به application:didFinishLaunchingWithOptions: متد، YOUR_API_KEY را با کلید API خود جایگزین کنید:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

GooglePlacesSwift

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

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

  import GooglePlacesSwift

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

  PlacesClient.provideAPIKey("YOUR_API_KEY")