تیم «پلاتفرم Google Maps» بهطور منظم کیتهای توسعه نرمافزار را با ویژگیهای جدید، رفع اشکالات، و بهبود عملکرد بهروزرسانی میکند. این صفحه راهنماییهایی درباره نحوه مدیریت وابستگیهایتان به کیتهای توسعه نرمافزار تلفن همراه ارائه میدهد.
به کدام نسخه پیوند داده شود؟
-
برای برنامههای حیاتی، به جدیدترین نسخه فرعی از نسخه اصلی که استفاده میکنید (X.*) پیوند دهید و سالانه به نسخه اصلی جدید ارتقا دهید.
همانطور که نسخههای جدید برنامهتان را درطول سال منتشر میکنید، ممکن است استفاده از نسخههای جدیدتر Maps SDK for iOS را شروع کنید. این کار نیازی به بهروزرسانی در برنامه شما ندارد زیرا نسخههای نقطهای جدید سازگار با نسخه قدیمی هستند.
مزایا:
- اگر در «کیت توسعه نرمافزار Maps برای iOS» مشکلی پیدا کنید، طبق خطمشی پشتیبانی تلفن همراه، اصلاحات بهمدت ۱۲ ماه پساز انتشار اولیه نسخه اصلی بهصورت سازگار با نسخه قدیمی ارائه خواهد شد. برای بهرهمندی از اصلاحات، نیازی نیست فوراً به نسخه کیت توسعه نرمافزار ناسازگار ارتقا دهید.
- وقتی برنامهتان ازقبل روی جدیدترین نسخه ساخته شده باشد، بهکارگیری جدیدترین بهبودها و ویژگیها آسان است.
- بهروزرسانیهای افزایشی سالانه به جدیدترین نسخه عمده کیت توسعه نرمافزار ممکن است به کار کمتری برای سازگار کردن، بازنویسی، و آزمایش کردن برنامهتان نیاز داشته باشد تا اینکه بخواهید تغییرات ناسازگار با نسخههای قبلی را که در چندین نسخه عمده معرفی شدهاند مدیریت کنید.
برای برنامههای غیربحرانی، به هر نسخه اصلاحشدهای پیوند دهید. وقتی برای آن نسخه اصلاحشده اعلان منسوخ شدن دریافت میکنید، ۱۲ ماه فرصت خواهید داشت تا کد برنامه بهروزشدهتان را دردسترس کاربران قرار دهید.
مزایا:
- کاهش دفعات کارهای تعمیر و نگهداری.
- نسخههای جدید برنامه شما برای مدت طولانیتری از دستگاههای کاربران با سیستمعاملهای همراه قدیمیتر پشتیبانی میکنند (تا زمانی که لازم باشد به نسخه جدید کیت توسعه نرمافزار ارتقا دهید).
«مالکان پروژه» با نشانیهای ایمیل تحت نظارت، اعلانهای پیشکنشی درباره تغییراتی که بر هریک از پروژههایشان تأثیر میگذارد دریافت میکنند. درباره بهروزرسانیهای مهم، منسوخ شدنها، و تغییرات دیگر مطلع بمانید.
نصب
Swift Package Manager
«کیت توسعه نرمافزار Google Maps برای iOS» را میتوان ازطریق مدیر بسته Swift نصب کرد. برای افزودن کیت توسعه نرمافزار، مطمئن شوید که همه وابستگیهای موجود «کیت توسعه نرمافزار Google Maps برای iOS» را برداشتهاید.
برای افزودن SDK به پروژه جدید یا موجود، این مراحل را دنبال کنید:
-
Xcode
projectیاworkspaceرا باز کنید، سپس به File > Add Package Dependencies (فایل > افزودن وابستگیهای بسته) بروید. - https://github.com/googlemaps/ios-maps-sdk را بهعنوان نشانی وب وارد کنید، برای کشیدن بسته کلید Enter را فشار دهید، و روی «افزودن بسته» کلیک کنید.
-
برای نصب
versionخاص، فیلد قانون وابستگی را روی یکی از گزینههای مبتنی بر نسخه تنظیم کنید. برای پروژههای جدید، توصیه میکنیم جدیدترین نسخه را مشخص کنید و از گزینه «نسخه دقیق» استفاده کنید. پساز تکمیل، روی «افزودن بسته» کلیک کنید. -
در پنجره انتخاب محصولات بسته، تأیید کنید که
GoogleMaps(برای نسخههای قدیمیتر از ۹.۰.۰، تأیید کنید کهGoogleMaps،GoogleMapsBase، وGoogleMapsCore) به هدفmainتعیینشده شما اضافه خواهد شد. پساز تکمیل، روی «افزودن بسته» کلیک کنید. - برای درستیسنجی نصب، به صفحه General (عمومی) هدف بروید. در Frameworks, Libraries, and Embedded Content باید بستههای نصبشده را ببینید. همچنین میتوانید بخش «وابستگیهای بسته» در «پیمایشگر پروژه» را برای تأیید بسته و نسخه آن مشاهده کنید.
برای بهروزرسانی package برای پروژه موجود، این مراحل را دنبال کنید:
اگر از نسخهای قدیمیتر از ۹.۰.۰ ارتقا میدهید، باید وابستگیهای زیر را پساز ارتقا دادن بردارید:
GoogleMapsBase،GoogleMapsCore، وGoogleMapsM4B. وابستگی را برایGoogleMapsبرندارید. برای اطلاعات بیشتر، یادداشتهای انتشار نسخه ۹.۰.۰ را ببینید.از تنظیمات پیکربندی پروژه Xcode، Frameworks, Libraries, and Embedded Content را پیدا کنید. از علامت منفی(-) برای برداشتن چارچوب زیر استفاده کنید:
GoogleMapsBase(فقط برای ارتقا از نسخههای قدیمیتر از ۹.۰.۰)-
GoogleMapsCore(فقط برای ارتقا از نسخههای قدیمیتر از ۹.۰.۰) GoogleMapsM4B(فقط برای ارتقا از نسخههای قدیمیتر از ۹.۰.۰)
- از Xcode، به File > Packages > Update To Latest Package Versions بروید.
- برای درستیسنجی نصب، به بخش وابستگیهای بسته در Project Navigator بروید تا بسته و نسخه آن را درستیسنجی کنید.
برای برداشتن وابستگیهای موجود «کیت توسعه نرمافزار Maps برای iOS» که بااستفاده از
CocoaPods اضافه شدهاند، این مراحل را دنبال کنید:
- فضای کاری Xcode را ببندید. پایانه را باز کنید و فرمان زیر را اجرا کنید:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
اگر از
Podfile،Podfile.resolved، و Xcodeworkspaceبرای چیزی غیراز CocoaPods استفاده نمیکنید، آنها را بردارید.
تعمیرات و نگهداری و ارتقا
برای ساختن با جدیدترین بهبودها، بهطور مرتب نسخههای جدیدتر را بررسی کنید و مشخصات نسخهتان را بهروز کنید. اگر درحال بهروزرسانی به نسخه اصلی جدیدی هستید، یادداشتهای انتشار را برای تغییرات ناسازگار با نسخههای قبلی و نحوه بهروزرسانی کد بررسی کنید.
مدیر بسته Swift
برای بهروزرسانی package برای پروژه موجود، این مراحل را دنبال کنید:
- برای درستیسنجی نصب، به بخش وابستگیهای بسته در پیمایشگر پروژه بروید تا بسته و نسخه آن را درستیسنجی کنید.
نصب دستی
پیوند جدیدترین فایلهای منبع را در «نصب کیت توسعه نرمافزار» دریافت کنید.
علاوهبر نظرسنجی برای نسخههای جدیدتر، مالکان پروژه Google Cloud ایمیلهایی درباره تغییرات ناسازگار با نسخههای قبلی دریافت میکنند که ممکن است بر پروژههای آنها تأثیر بگذارد. برای دریافت اعلان پیشکنش درباره تغییرات ناسازگار با نسخههای قبلی، نقش مالک را با نشانی ایمیل پایششده برای هریک از پروژههایتان اختصاص دهید.