تیم Google Maps Platform به‌طور مرتب کیت‌های توسعه نرم‌افزار را با ویژگی‌های جدید، رفع اشکال، و بهبود عملکرد به‌روز می‌کند. این صفحه راهنمایی‌هایی درباره نحوه مدیریت وابستگی‌های شما به کیت‌های توسعه نرم‌افزار تلفن همراه ارائه می‌دهد.
به کدام نسخه پیوند داده شود؟
-
برای برنامه‌های مأموریت‌محور، به جدیدترین نسخه نقطه از نسخه اصلی که استفاده می‌کنید (X.*) پیوند دهید و هر سال به نسخه اصلی جدید ارتقا دهید.
همان‌طور که نسخه‌های جدید برنامه‌تان را درطول سال منتشر می‌کنید، ممکن است استفاده از نسخه‌های جدیدتر Driver SDK برای iOS را شروع کنید. این کار نیازی به به‌روزرسانی در برنامه شما ندارد زیرا نسخه‌های نقطه‌ای جدید سازگار با نسخه قدیمی هستند.
مزایا:
- اگر در «کیت توسعه نرم‌افزار راننده» برای 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 نصب کرد. برای افزودن کیت توسعه نرم‌افزار، مطمئن شوید که همه وابستگی‌های «کیت توسعه نرم‌افزار راننده» موجود را برداشته‌اید.
برای افزودن کیت توسعه نرم‌افزار به پروژه جدید یا موجود، این مراحل را دنبال کنید:
-
Xcode
projectیاworkspaceرا باز کنید، سپس به File (فایل) > Add Package Dependencies (افزودن وابستگی‌های بسته) بروید. - https://github.com/googlemaps/ios-driver-sdk را به‌عنوان نشانی وب وارد کنید، کلید Enter را فشار دهید تا بسته را بکشید، و روی «افزودن بسته» کلیک کنید.
-
برای نصب
versionخاص، فیلد قانون وابستگی را روی یکی از گزینه‌های مبتنی بر نسخه تنظیم کنید. برای پروژه‌های جدید، توصیه می‌کنیم جدیدترین نسخه را مشخص کنید و از گزینه «نسخه دقیق» استفاده کنید. پس‌از تکمیل، روی «افزودن بسته» کلیک کنید. -
از پنجره انتخاب محصولات بسته، تأیید کنید که
GoogleRidesharingDriverبه هدفmainتعیین‌شده شما اضافه خواهد شد. پس‌از تکمیل، روی «افزودن بسته» کلیک کنید. - برای درستی‌سنجی نصب، به قاب کلی هدف خود پیمایش کنید. در چارچوب‌ها، کتابخانه‌ها، و محتوای جاسازی‌شده باید بسته‌های نصب‌شده را ببینید. همچنین می‌توانید بخش «وابستگی‌های بسته» در «پیمایشگر پروژه» را برای تأیید بسته و نسخه آن مشاهده کنید.
برای به‌روزرسانی package برای پروژه موجود، این مراحل را دنبال کنید:
- از Xcode، به File > Packages > Update To Latest Package Versions بروید.
- برای درستی‌سنجی نصب، به بخش وابستگی‌های بسته در پیمایشگر پروژه بروید تا بسته و نسخه آن را درستی‌سنجی کنید.
تعمیر و نگهداری و ارتقا
برای ساختن با جدیدترین بهبودها، به‌طور مرتب نسخه‌های جدیدتر را بررسی کنید و مشخصات نسخه خود را به‌روز کنید. اگر درحال به‌روزرسانی به نسخه اصلی جدیدی هستید، یادداشت‌های انتشار را برای تغییرات ناسازگار با نسخه‌های قبلی و نحوه به‌روزرسانی کدتان بررسی کنید.
Cocoapods
-
پایانه‌ای را باز کنید و به دایرکتوری حاوی
Podfileبروید:cd <path-to-project>
pod outdatedرا اجرا کنید تا ببینید آیا نسخه جدیدتری از Driver SDK برای iOS دردسترس است یا نه.- اگر نسخه جدیدتری از کیت توسعه نرم‌افزار پیدا شد،
Podfileخود را با این نسخه جدید به‌روز کنید. برای آشنایی با نحوه تنظیم نسخه خاص درPodfile، به مشخص کردن نسخه‌های واحد مراجعه کنید. -
pod updateرا اجرا کنید. - هرگونه تغییر لازم را در نتیجه ارتقا انجام دهید. برای مشاهده فهرست تغییرات در هر نسخه، یادداشت‌های انتشار را ببینید.
- با انتخاب محصول > پاک‌سازی و سپس محصول > ساختن، پروژه خود را پاک‌سازی و بازسازی کنید
نصب دستی
دریافت پیوند به جدیدترین فایل‌های منبع در نصب کیت توسعه نرم‌افزار.
علاوه‌بر نظرسنجی برای نسخه‌های جدیدتر، مالکان پروژه در Google Cloud ایمیل‌هایی درباره تغییرات ناسازگار با نسخه‌های قبلی دریافت می‌کنند که ممکن است بر پروژه‌هایشان تأثیر بگذارد. برای دریافت اعلان پیش‌کنشی درباره تغییرات ناسازگار با نسخه‌های قبلی، نقش مالک را با نشانی ایمیل تحت نظارت برای هریک از پروژه‌هایتان اختصاص دهید.