Maps SDK برای نسخه‌های iOS

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

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

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

1. project یا workspace Xcode خود را باز کنید، سپس به File > Add Package Dependencies بروید.
2. آدرس https://github.com/googlemaps/ios-maps-sdk را به عنوان URL وارد کنید، برای دریافت بسته، Enter را فشار دهید و روی «افزودن بسته» کلیک کنید.
3. برای نصب یک version خاص، فیلد Dependency Rule را روی یکی از گزینه‌های مبتنی بر نسخه تنظیم کنید. برای پروژه‌های جدید، توصیه می‌کنیم آخرین نسخه را مشخص کرده و از گزینه "Exact Version" استفاده کنید. پس از تکمیل، روی "Add Package" کلیک کنید.
4. از پنجره Choose Package Products ، تأیید کنید که GoogleMaps (برای نسخه‌های قبل از ۹.۰.۰، GoogleMaps ، GoogleMapsBase و GoogleMapsCore ) به هدف main تعیین‌شده شما اضافه شوند. پس از تکمیل، روی «افزودن بسته» کلیک کنید.
5. برای تأیید نصب، به بخش عمومی (General ) سیستم هدف خود بروید. در قسمت‌های چارچوب‌ها (Frameworks)، کتابخانه‌ها (Libraries) و محتوای جاسازی‌شده (Embedded Content) باید بسته‌های نصب‌شده را مشاهده کنید. همچنین می‌توانید بخش «وابستگی‌های بسته» (Package Dependencies) را در «Project Navigator» مشاهده کنید تا بسته و نسخه آن را تأیید کنید.

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

1. اگر از نسخه‌ای قبل از ۹.۰.۰ ارتقا می‌دهید، باید وابستگی‌های زیر را حذف کنید: GoogleMapsBase ، GoogleMapsCore و GoogleMapsM4B پس از ارتقا. وابستگی مربوط به GoogleMaps را حذف نکنید. برای اطلاعات بیشتر، به یادداشت‌های انتشار نسخه ۹.۰.۰ مراجعه کنید.

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

   • GoogleMapsBase (فقط برای ارتقاء از نسخه‌های قبل از ۹.۰.۰)
   • GoogleMapsCore (فقط برای ارتقاء از نسخه‌های پایین‌تر از ۹.۰.۰)
   • GoogleMapsM4B (فقط برای ارتقاء از نسخه‌های قبل از ۹.۰.۰)
2. از Xcode، به مسیر File > Packages > Update To Latest Package Versions بروید.
3. برای تأیید نصب خود، به بخش وابستگی‌های بسته‌بندی در Project Navigator بروید تا بسته و نسخه آن را تأیید کنید.

برای حذف وابستگی‌های Maps SDK موجود برای iOS که با استفاده از CocoaPods اضافه شده‌اند، این مراحل را دنبال کنید:

1. فضای کاری Xcode خود را ببندید. ترمینال را باز کنید و دستور زیر را اجرا کنید:

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all

2. اگر از Podfile ، Podfile.resolved و workspace Xcode برای چیزی غیر از CocoaPods استفاده نمی‌کنید، آنها را حذف کنید.