تیم Google Maps Platform به‌طور مرتب کیت‌های توسعه نرم‌افزار را با ویژگی‌های جدید، رفع اشکال، و بهبود عملکرد به‌روز می‌کند. این صفحه راهنمایی‌هایی درباره نحوه مدیریت وابستگی‌هایتان به کیت‌های توسعه نرم‌افزار تلفن همراه ارائه می‌دهد.
به کدام نسخه پیوند داده شود؟
-
برای برنامه‌های حیاتی، به جدیدترین نسخه فرعی از نسخه اصلی که استفاده می‌کنید (X.*) پیوند دهید و سالانه به نسخه اصلی جدید ارتقا دهید.
همان‌طور که نسخه‌های جدید برنامه‌تان را درطول سال منتشر می‌کنید، ممکن است از نسخه‌های جدیدتر Driver SDK برای iOS استفاده کنید. این کار نیازی به به‌روزرسانی در برنامه شما ندارد زیرا نسخه‌های نقطه‌ای جدید با نسخه‌های قدیمی سازگار هستند.
مزایا:
- اگر در Driver SDK برای iOS مشکلی پیدا کنید، طبق خط‌مشی پشتیبانی تلفن همراه، اصلاحات به‌مدت ۱۲ ماه پس‌از انتشار اولیه نسخه اصلی به‌صورت سازگار با نسخه قدیمی ارائه خواهد شد. برای بهره‌مندی از اصلاحات، نیازی نیست فوراً به نسخه کیت توسعه نرم‌افزار ناسازگار ارتقا دهید.
- وقتی برنامه‌تان ازقبل براساس جدیدترین نسخه ساخته شده باشد، به‌راحتی می‌توانید جدیدترین بهبودها و ویژگی‌ها را اتخاذ کنید.
- به‌روزرسانی‌های افزایشی سالانه به جدیدترین نسخه عمده کیت توسعه نرم‌افزار ممکن است به کار کمتری برای تطبیق، بازنویسی، و آزمایش برنامه شما نیاز داشته باشد تا اینکه مجبور باشید تغییرات ناسازگار با نسخه‌های قبلی را که در چندین نسخه عمده معرفی شده‌اند مدیریت کنید.
برای برنامه‌های غیربحرانی، به هر نسخه اصلاح‌شده‌ای پیوند دهید. وقتی برای آن نسخه ثابت‌شده اعلان منسوخ شدن دریافت می‌کنید، ۱۲ ماه فرصت خواهید داشت تا کد برنامه به‌روزشده‌تان را دردسترس کاربران قرار دهید.
مزایا:
- کارهای نگهداری کمتر.
- نسخه‌های جدید برنامه‌تان برای مدت طولانی‌تری از دستگاه‌های کاربران که سیستم‌عامل‌های قدیمی‌تر تلفن همراه را اجرا می‌کنند پشتیبانی می‌کنند (تا زمانی که نیاز به ارتقا به نسخه جدید کیت توسعه نرم‌افزار داشته باشید).
مالکان پروژه با نشانی‌های ایمیل تحت نظارت، اعلان‌های پیش‌کنشی درباره تغییراتی که بر هریک از پروژه‌هایشان تأثیر می‌گذارد دریافت می‌کنند. از به‌روزرسانی‌های مهم، موارد منسوخ‌شده، و تغییرات دیگر مطلع شوید.
نصب
همیشه به‌جای استفاده از عملگر خوش‌بینانه (~>)، شماره نسخه را در وابستگی‌هایتان مشخص کنید زیرا این کار می‌تواند منجر به ساخت‌های غیرقابل‌پیش‌بینی و غیرقابل‌تکرار شود. «کیت توسعه نرم‌افزار راننده» برای iOS از
نسخه‌گذاری معنایی پیروی می‌کند و نسخه‌های اصلی جدید
شامل تغییرات اساسی هستند.
CocoaPods
نمونه‌ای از وابستگی Podfile بااستفاده از نحو Podfile:
source "https://github.com/CocoaPods/Specs.git"
target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
pod 'GoogleRidesharingDriver', '2.0.0'
end
Swift Package Manager
«کیت توسعه نرم‌افزار راننده» را می‌توان ازطریق مدیر بسته Swift نصب کرد. برای افزودن کیت توسعه نرم‌افزار، مطمئن شوید که هرگونه وابستگی موجود Driver SDK را برداشته‌اید.
برای افزودن SDK به پروژه جدید یا موجود، این مراحل را دنبال کنید:
-
Xcode
projectیاworkspaceرا باز کنید، سپس به File > Add Package Dependencies بروید. - https://github.com/googlemaps/ios-driver-sdk را به‌عنوان نشانی وب وارد کنید، Enter را فشار دهید تا بسته را وارد کنید، و روی «افزودن بسته» کلیک کنید.
-
برای نصب
versionخاص، فیلد قانون وابستگی را روی یکی از گزینه‌های مبتنی بر نسخه تنظیم کنید. برای پروژه‌های جدید، توصیه می‌کنیم جدیدترین نسخه را مشخص کنید و از گزینه «نسخه دقیق» استفاده کنید. پس‌از تکمیل، روی «افزودن بسته» کلیک کنید. -
در پنجره انتخاب محصولات بسته، تأیید کنید که
GoogleRidesharingDriverبه هدفmainتعیین‌شده شما اضافه خواهد شد. پس‌از تکمیل، روی «افزودن بسته» کلیک کنید. - برای درستی‌سنجی نصب، به قاب General (عمومی) هدف بروید. در Frameworks, Libraries, and Embedded Content باید بسته‌های نصب‌شده را ببینید. همچنین می‌توانید بخش «وابستگی‌های بسته» را در «Project Navigator» مشاهده کنید تا بسته و نسخه آن را تأیید کنید.
برای به‌روزرسانی package برای پروژه موجود، این مراحل را دنبال کنید:
- از Xcode، به فایل > بسته‌ها > به‌روزرسانی به جدیدترین نسخه‌های بسته بروید.
- برای درستی‌سنجی نصب، به بخش وابستگی‌های بسته در Project Navigator بروید تا بسته و نسخه آن را درستی‌سنجی کنید.
تعمیر و نگهداری و ارتقا
برای ساختن با جدیدترین بهبودها، به‌طور مرتب نسخه‌های جدیدتر را بررسی کنید و مشخصات نسخه‌تان را به‌روز کنید. اگر درحال به‌روزرسانی به نسخه عمده جدیدی هستید، یادداشت‌های انتشار را برای تغییرات ناسازگار با نسخه‌های قبلی و نحوه به‌روزرسانی کدتان بررسی کنید.
Cocoapods
-
پایانه‌ای را باز کنید و به دایرکتوری حاوی
Podfileبروید:cd <path-to-project>
pod outdatedرا اجرا کنید تا ببینید نسخه جدیدتری از Driver SDK for iOS دردسترس است یا نه.- اگر نسخه جدیدتری از کیت توسعه نرم‌افزار پیدا شد،
Podfileخود را با این نسخه جدید به‌روز کنید. برای آشنایی با نحوه تنظیم نسخه‌ای خاص درPodfile، مشخص کردن نسخه‌های pod را ببینید. -
pod updateرا اجرا کنید. - هرگونه تغییر لازم را درنتیجه ارتقا اعمال کنید. برای مشاهده فهرست تغییرات در هر نسخه، یادداشت‌های انتشار را ببینید.
- با انتخاب محصول > پاک کردن و سپس محصول > ساختن، پروژه‌تان را پاک و بازسازی کنید
نصب دستی
پیوند جدیدترین فایل‌های منبع را در «نصب کیت توسعه نرم‌افزار» دریافت کنید.
علاوه‌بر نظرسنجی برای نسخه‌های جدیدتر، مالکان پروژه Google Cloud ایمیل‌هایی درباره تغییرات ناسازگار با نسخه‌های قبلی دریافت می‌کنند که ممکن است بر پروژه‌های آن‌ها تأثیر بگذارد. برای دریافت اعلان پیش‌کنشی درباره تغییرات ناسازگار با نسخه‌های قبلی، نقش مالک را با نشانی ایمیل تحت نظارت برای هریک از پروژه‌هایتان اختصاص دهید.