نسخه‌های کیت توسعه نرم‌افزار Google Maps برای iOS

پلاتفرم را انتخاب کنید: Android iOS JavaScript

تیم Google Maps Platform به‌طور مرتب کیت‌های توسعه نرم‌افزار را با ویژگی‌های جدید، رفع اشکال، و بهبود عملکرد به‌روز می‌کند. این صفحه راهنمایی‌هایی درباره نحوه مدیریت وابستگی‌هایتان به کیت‌های توسعه نرم‌افزار تلفن همراه ارائه می‌دهد.

به کدام نسخه پیوند داده شود؟

• برای برنامه‌های حیاتی، به جدیدترین نسخه فرعی از نسخه اصلی که استفاده می‌کنید (X.*) پیوند دهید و سالانه به نسخه اصلی جدید ارتقا دهید.

  همان‌طور که نسخه‌های جدید برنامه‌تان را درطول سال منتشر می‌کنید، ممکن است استفاده از نسخه‌های جدیدتر «کیت توسعه نرم‌افزار Maps برای iOS» را شروع کنید. این کار نیازی به به‌روزرسانی در برنامه شما ندارد زیرا نسخه‌های نقطه‌ای جدید با نسخه‌های قدیمی سازگار هستند.

  مزایا:

  • اگر در «کیت توسعه نرم‌افزار Maps برای iOS» مشکلی پیدا کنید، طبق خط‌مشی پشتیبانی تلفن همراه، اصلاحات به‌مدت ۱۲ ماه پس‌از انتشار اولیه نسخه اصلی به‌صورت سازگار با نسخه قدیمی ارائه خواهد شد. برای بهره‌مندی از اصلاحات، نیازی نیست فوراً به نسخه کیت توسعه نرم‌افزار ناسازگار ارتقا دهید.
  • وقتی برنامه‌تان ازقبل براساس جدیدترین نسخه ساخته شده باشد، به‌راحتی می‌توانید جدیدترین بهبودها و ویژگی‌ها را اتخاذ کنید.
  • به‌روزرسانی‌های افزایشی سالانه به جدیدترین نسخه عمده کیت توسعه نرم‌افزار ممکن است به کار کمتری برای تطبیق، بازنویسی، و آزمایش برنامه شما نیاز داشته باشد تا اینکه مجبور باشید تغییرات ناسازگار با نسخه‌های قبلی را که در چندین نسخه عمده معرفی شده‌اند مدیریت کنید.

• برای برنامه‌های غیربحرانی، به هر نسخه اصلاح‌شده‌ای پیوند دهید. وقتی برای آن نسخه ثابت‌شده اعلان منسوخ شدن دریافت می‌کنید، ۱۲ ماه فرصت خواهید داشت تا کد برنامه به‌روزشده‌تان را دردسترس کاربران قرار دهید.

  مزایا:

  • کارهای نگهداری کمتر.
  • نسخه‌های جدید برنامه‌تان برای مدت طولانی‌تری از دستگاه‌های کاربران که سیستم‌عامل‌های قدیمی‌تر تلفن همراه را اجرا می‌کنند پشتیبانی می‌کنند (تا زمانی که نیاز به ارتقا به نسخه جدید کیت توسعه نرم‌افزار داشته باشید).

مالکان پروژه با نشانی‌های ایمیل تحت نظارت، اعلان‌های پیش‌کنشی درباره تغییراتی که بر هریک از پروژه‌هایشان تأثیر می‌گذارد دریافت می‌کنند. از به‌روزرسانی‌های مهم، موارد منسوخ‌شده، و تغییرات دیگر مطلع شوید.

نصب

Swift Package Manager

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

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

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

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

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

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

   • GoogleMapsBase (فقط برای ارتقا از نسخه‌های قدیمی‌تر از ۹.۰.۰)
   • GoogleMapsCore (فقط برای ارتقا از نسخه‌های قدیمی‌تر از ۹.۰.۰)
   • GoogleMapsM4B (فقط برای ارتقا از نسخه‌های قدیمی‌تر از ۹.۰.۰)
2. از Xcode، به فایل > بسته‌ها > به‌روزرسانی به جدیدترین نسخه‌های بسته بروید.
3. برای درستی‌سنجی نصب، به بخش وابستگی‌های بسته در Project Navigator بروید تا بسته و نسخه آن را درستی‌سنجی کنید.

مهم: گاهی اوقات، مصنوعات حل نمی‌شوند یا ممکن است خطاهایی رخ دهد، در این صورت «File > Packages > Reset Package Cache» (فایل > بسته‌ها> بازنشانی حافظه نهان بسته) را انتخاب کنید.

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

1. فضای کاری Xcode را ببندید. پایانه را باز کنید و فرمان زیر را اجرا کنید:

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

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

تعمیر و نگهداری و ارتقا

برای ساختن با جدیدترین بهبودها، به‌طور مرتب نسخه‌های جدیدتر را بررسی کنید و مشخصات نسخه‌تان را به‌روز کنید. اگر درحال به‌روزرسانی به نسخه عمده جدیدی هستید، یادداشت‌های انتشار را برای تغییرات ناسازگار با نسخه‌های قبلی و نحوه به‌روزرسانی کدتان بررسی کنید.

Swift Package Manager

To update the package for an existing project, follow these steps:

  

    
    
    

      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
  
  
  

    Important: Sometimes, artifacts cannot be resolved or errors can occur, 
    in this case select "File > Packages > Reset Package Cache".
  

نصب دستی

پیوند جدیدترین فایل‌های منبع را در «نصب کیت توسعه نرم‌افزار» دریافت کنید.

علاوه‌بر نظرسنجی برای نسخه‌های جدیدتر، مالکان پروژه Google Cloud ایمیل‌هایی درباره تغییرات ناسازگار با نسخه‌های قبلی دریافت می‌کنند که ممکن است بر پروژه‌های آن‌ها تأثیر بگذارد. برای دریافت اعلان پیش‌کنشی درباره تغییرات ناسازگار با نسخه‌های قبلی، نقش مالک را با نشانی ایمیل تحت نظارت برای هریک از پروژه‌هایتان اختصاص دهید.