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

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

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

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

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

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

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

مدیر بسته Swift

«کیت توسعه نرم‌افزار مکان‌ها، ویژه 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 از نسخه ۰.۳.۰ تغییر کرده است. اگر درحال به‌روزرسانی نسخه‌ای از GooglePlacesSwift هستید که ازطریق نشانی وب قدیمی، https://github.com/googlemaps/ios-places-swift-sdk، به آن دسترسی پیدا شده است، آن را از بخش وابستگی‌های بسته Xcode بردارید.

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

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

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

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

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

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

مهم: گاهی اوقات، آرتیفکت‌ها قابل‌حل نیستند یا ممکن است خطا رخ دهد، در این صورت «فایل > بسته‌ها > بازنشانی حافظه نهان بسته» را انتخاب کنید.

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

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

نصب دستی

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

1. فایل‌های منبع و دودویی کیت توسعه نرم‌افزار زیر را بارگیری کنید:
   • GooglePlaces
   • GooglePlacesResources
2. اگر درحال نصب «کیت توسعه نرم‌افزار مکان‌ها» برای iOS هستید، فایل‌های زیر را نصب کنید:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. فایل‌ها را از حالت فشرده خارج کنید تا به XCFramework و منابع دسترسی پیدا کنید.
4. ‫Xcode را راه‌اندازی کنید و یا پروژه موجودی را باز کنید یا پروژه جدیدی ایجاد کنید. اگر در توسعه iOS تازه‌کار هستید، پروژه جدیدی ایجاد کنید و الگوی برنامه iOS را انتخاب کنید.
5. هرگونه بسته Maps از نسخه‌های قبلی را از پروژه‌تان بردارید.
6. زبانه عمومی را باز کنید. XCFramework زیر را به پروژه خود در بخش چارچوب‌ها، کتابخانه‌ها، و محتوای جاسازی‌شده بکشید. مطمئن شوید جاسازی نشود را انتخاب کنید:
   • GooglePlaces.xcframework
   اگر درحال نصب Places Swift SDK هستید، XCFramework زیر را به پروژه‌تان در بخش چارچوب‌ها، کتابخانه‌ها، و محتوای جاسازی‌شده بکشید. مطمئن شوید جاسازی نشود را انتخاب کنید:
   • GooglePlacesSwift.xcframework
7. GooglePlaces.bundle را از GooglePlacesResources که بارگیری کرده‌اید در دایرکتوری سطح بالای پروژه Xcode کپی کنید. وقتی درخواست شد، حتماً کپی کردن موارد در پوشه گروه مقصد را انتخاب کنید.
   
   اگر درحال نصب «کیت توسعه نرم‌افزار Swift مکان‌ها» هستید، GooglePlacesSwift.bundle را از GooglePlacesSwiftResources که بارگیری کرده‌اید در فهرست سطح بالای پروژه Xcode خود کپی کنید. هنگام درخواست، حتماً کپی کردن موارد در پوشه گروه مقصد را انتخاب کنید.
8. پروژه‌تان را از Project Navigator انتخاب کنید و هدف برنامه‌تان را انتخاب کنید.
9. برگه مراحل ساخت را باز کنید. در پیوند دادن باینری با کتابخانه‌ها، چارچوب‌ها و کتابخانه‌های زیر را اضافه کنید:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

10. پروژه‌تان را به‌جای هدف خاصی انتخاب کنید و برگه تنظیمات ساخت را باز کنید. در بخش پیوند دادن - عمومی -> پرچم‌های پیونددهنده دیگر، -ObjC را به «عیب‌یابی» و «انتشار» اضافه کنید. اگر این تنظیمات قابل‌مشاهده نیستند، فیلتر را در نوار تنظیمات ساخت از پایه به همه تغییر دهید.

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

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

GooglePlacesSwift

کلید میانای برنامه‌سازی کاربردی را به‌صورت زیر به 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» در دسته منابع کیت توسعه نرم‌افزار گنجانده شده است. برای تأیید اینکه «فایل مانیفست حریم خصوصی» اضافه شده است و برای بررسی محتوای آن، بایگانی‌ای از برنامه‌تان ایجاد کنید و از بایگانی گزارش حریم خصوصی تولید کنید.

مراحل بعدی

• شروع به نوشتن کد کنید. نقطه شروع پیشنهادی پیاده‌سازی برنامه آغازگری است که مکان فعلی کاربر را دریافت می‌کند.
• پس‌از پیکربندی پروژه، می‌توانید برنامه‌های نمونه را کاوش کنید.
• از «بررسی برنامه» برای ایمن کردن کلید میانای برنامه‌سازی کاربردی خود استفاده کنید.