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

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

توجه: ویژگی‌های Places SDK for iOS که در برنامه‌تان دردسترس است براساس ترکیبی از شماره نسخه SDK که در پیکربندی برنامه‌تان مشخص می‌کنید و میاناهای برنامه‌سازی کاربردی فعال‌شده در کلید میانای برنامه‌سازی کاربردی شما تعیین می‌شود. برای اطلاعات بیشتر، انتخاب نسخه کیت توسعه نرم‌افزار را ببینید.

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

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

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

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

  مزایا:

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

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

  مزایا:

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

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

نصب

Swift Package Manager

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

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

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

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

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

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

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

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

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

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

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 ایمیل‌هایی درباره تغییرات ناسازگار با نسخه‌های قبلی دریافت می‌کنند که ممکن است بر پروژه‌های آن‌ها تأثیر بگذارد. برای دریافت اعلان پیش‌کنشی درباره تغییرات ناسازگار با نسخه‌های قبلی، نقش مالک را با نشانی ایمیل تحت نظارت برای هریک از پروژه‌هایتان اختصاص دهید.