تیم پلتفرم نقشههای گوگل مرتباً SDKها را با ویژگیهای جدید، رفع اشکالات و بهبود عملکرد بهروزرسانی میکند. این صفحه راهنماییهایی در مورد نحوه مدیریت وابستگیهای شما به SDKهای موبایل ارائه میدهد.
به کدام نسخه لینک بدهیم؟
برای برنامههای حیاتی ، به آخرین نسخهٔ منتشر شده از نسخهٔ اصلی که استفاده میکنید (X.*) لینک دهید و سالانه آن را به نسخهٔ اصلی جدید ارتقا دهید.
همزمان با انتشار نسخههای جدید برنامهتان در طول سال، میتوانید از نسخههای جدیدتر Places SDK برای iOS استفاده کنید. این کار نیازی به بهروزرسانی در برنامهتان نخواهد داشت زیرا نسخههای جدید dot با نسخههای قبلی سازگار هستند.
مزایا:
- اگر در Places SDK برای iOS مشکلی پیدا کردید، طبق سیاست پشتیبانی موبایل ، اصلاحات به مدت ۱۲ ماه پس از انتشار اولیه نسخه اصلی، به صورت سازگار با نسخههای قبلی ارائه خواهد شد. برای بهرهمندی از اصلاحات، نیازی به ارتقاء فوری به نسخه SDK ناسازگار نخواهید داشت.
- وقتی برنامه شما از قبل بر اساس آخرین نسخه ساخته شده باشد، جدیدترین پیشرفتها و ویژگیها به راحتی قابل استفاده هستند.
- بهروزرسانیهای تدریجی سالانه برای جدیدترین نسخه اصلی SDK ممکن است به کار کمتری برای تطبیق، بازنویسی و آزمایش برنامه شما نیاز داشته باشد، در مقایسه با اینکه مجبور باشید تغییرات ناسازگار با نسخههای قبلی را که در چندین نسخه اصلی منتشر شدهاند، مدیریت کنید.
برای برنامههای غیرحیاتی ، به هر نسخه اصلاحشدهای لینک دهید. وقتی اخطار منسوخ شدن آن نسخه اصلاحشده را دریافت کردید، ۱۲ ماه فرصت خواهید داشت تا کد بهروزرسانیشده برنامه خود را در دسترس کاربرانتان قرار دهید.
مزایا:
- کارهای تعمیر و نگهداری کمتر.
- نسخههای جدید برنامه شما، دستگاههای کاربرانی که سیستم عاملهای قدیمیتر موبایل را اجرا میکنند، برای مدت طولانیتری پشتیبانی میکنند (تا زمانی که نیاز به ارتقاء به نسخه جدید SDK داشته باشید).
صاحبان پروژه با آدرسهای ایمیل تحت نظارت، اعلانهای پیشگیرانهای در مورد تغییراتی که بر هر یک از پروژههایشان تأثیر میگذارد، دریافت میکنند. از بهروزرسانیهای عمده، منسوخشدهها و سایر تغییرات مطلع باشید .
نصب
مدیر بسته سوئیفت
کیت توسعه نرمافزار Places برای iOS را میتوان از طریق Swift Package Manager نصب کرد. برای افزودن SDK، مطمئن شوید که هرگونه وابستگی موجود Places SDK برای iOS را حذف کردهاید.
برای اضافه کردن SDK به یک پروژه جدید یا موجود، مراحل زیر را دنبال کنید:
-
projectیاworkspaceXcode خود را باز کنید، سپس به File > Add Package Dependencies بروید. - آدرس https://github.com/googlemaps/ios-places-sdk را به عنوان URL وارد کنید، برای دریافت بسته، Enter را فشار دهید و روی «افزودن بسته» کلیک کنید.
- برای نصب یک
versionخاص، فیلد Dependency Rule را روی یکی از گزینههای مبتنی بر نسخه تنظیم کنید. برای پروژههای جدید، توصیه میکنیم آخرین نسخه را مشخص کرده و از گزینه "Exact Version" استفاده کنید. پس از تکمیل، روی "Add Package" کلیک کنید. - از پنجره Choose Package Products ، تأیید کنید که
GooglePlaces،GooglePlacesSwiftیا هر دو به هدف اصلی تعیین شده شما اضافه میشوند. پس از تکمیل، روی Add Package کلیک کنید.اگر در حال بهروزرسانی Google Places Swift از آدرس اینترنتی منسوخشدهی GitHub هستید
مهم: آدرس اینترنتی گیتهاب برای دسترسی به Google Places Swift از نسخه ۰.۳.۰ تغییر کرده است. اگر نسخهای از GooglePlacesSwift را بهروزرسانی میکنید که از طریق آدرس اینترنتی قدیمی،
https://github.com/googlemaps/ios-places-swift-sdk، قابل دسترسی بوده است، آن را از بخش وابستگیهای بسته Xcode خود حذف کنید. - برای تأیید نصب، به بخش عمومی (General ) سیستم هدف خود بروید. در قسمتهای چارچوبها (Frameworks)، کتابخانهها (Libraries) و محتوای جاسازیشده (Embedded Content )، باید بستههای نصبشده را مشاهده کنید. همچنین میتوانید بخش وابستگیهای بسته (Package Dependencies) در Project Navigator را مشاهده کنید تا بسته و نسخه آن را تأیید کنید.
برای بهروزرسانی package برای یک پروژه موجود، مراحل زیر را دنبال کنید:
- از Xcode، به «فایل > بستهها > بهروزرسانی به آخرین نسخههای بسته» بروید.
اگر در حال بهروزرسانی Google Places Swift از آدرس اینترنتی منسوخشدهی GitHub هستید
مهم: آدرس اینترنتی گیتهاب برای دسترسی به Google Places Swift از نسخه ۰.۳.۰ تغییر کرده است. اگر نسخهای از GooglePlacesSwift را بهروزرسانی میکنید که از طریق آدرس اینترنتی قدیمی،
https://github.com/googlemaps/ios-places-swift-sdk، قابل دسترسی بوده است، آن را از بخش وابستگیهای بسته Xcode خود حذف کنید. - برای تأیید نصب خود، به بخش وابستگیهای بستهبندی در Project Navigator بروید تا بسته و نسخه آن را تأیید کنید.
کوکوپادز
همیشه به جای استفاده از عملگر خوشبینانه ( ~> )، شماره نسخه را در وابستگیهای خود مشخص کنید، زیرا این کار میتواند منجر به ساختهای غیرقابل پیشبینی و تکرارناپذیر شود. کیت توسعه نرمافزار Places برای iOS به نسخهبندی معنایی پایبند است و نسخههای اصلی جدید شامل تغییرات اساسی هستند.
یک مثال از وابستگی Podfile با استفاده از سینتکس Podfile :
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '16.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GooglePlaces', '10.8.0' pod 'GooglePlacesSwift', '10.8.0' end
نگهداری و ارتقاء
برای ایجاد جدیدترین پیشرفتها، مرتباً نسخههای جدیدتر را بررسی کنید و مشخصات نسخه خود را بهروزرسانی کنید. اگر در حال بهروزرسانی به یک نسخه اصلی جدید هستید، یادداشتهای انتشار را برای تغییرات ناسازگار با نسخههای قبلی و نحوه بهروزرسانی کد خود بررسی کنید.
مدیر بسته سوئیفت
برای بهروزرسانی package برای یک پروژه موجود، مراحل زیر را دنبال کنید:
- برای تأیید نصب خود، به بخش وابستگیهای بستهبندی در Project Navigator بروید تا بسته و نسخه آن را تأیید کنید.
کوکوپادها
یک ترمینال باز کنید و به دایرکتوری حاوی
Podfileبروید:cd <path-to-project>
- برای بررسی اینکه آیا نسخه جدیدتری از Places SDK برای iOS در دسترس است یا خیر،
pod outdatedرا اجرا کنید. - اگر نسخه جدیدتری از SDK پیدا شد،
Podfileخود را با این نسخه جدید بهروزرسانی کنید. برای یادگیری نحوه تنظیم یک نسخه خاص درPodfileخود، به بخش «مشخص کردن نسخههای pod» مراجعه کنید. - اجرای
pod update. - هرگونه تغییر لازم را در نتیجه ارتقا اعمال کنید. برای مشاهده فهرست تغییرات در هر نسخه ، به یادداشتهای انتشار مراجعه کنید.
- با انتخاب گزینه Product > Clean و سپس Product > Build، پروژه خود را پاکسازی و بازسازی کنید.
نصب دستی
علاوه بر نظرسنجی برای نسخههای جدیدتر، صاحبان پروژههای Google Cloud ایمیلهایی در مورد تغییرات ناسازگار با نسخههای قبلی که ممکن است بر پروژههایشان تأثیر بگذارد، دریافت میکنند. برای دریافت اعلانهای پیشگیرانه در مورد تغییرات ناسازگار با نسخههای قبلی، برای هر یک از پروژههای خود، یک آدرس ایمیل تحت نظارت به نقش مالک اختصاص دهید .