درایور SDK برای نسخه های iOS

تیم پلتفرم نقشه‌های گوگل مرتباً SDKها را با ویژگی‌های جدید، رفع اشکالات و بهبود عملکرد به‌روزرسانی می‌کند. این صفحه راهنمایی‌هایی در مورد نحوه مدیریت وابستگی‌های شما به SDKهای موبایل ارائه می‌دهد.

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

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

    مزایا:

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

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

    مزایا:

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

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

نصب

همیشه به جای استفاده از عملگر خوش‌بینانه ( ~> ) یک شماره نسخه در وابستگی‌های خود مشخص کنید، زیرا این کار می‌تواند منجر به ساخت‌های غیرقابل پیش‌بینی و تکرارناپذیر شود. درایور SDK برای iOS به نسخه‌بندی معنایی پایبند است و نسخه‌های اصلی جدید شامل تغییرات اساسی هستند.

کوکوپادز

یک مثال از وابستگی Podfile با استفاده از سینتکس Podfile :

      source "https://github.com/CocoaPods/Specs.git"

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end

مدیر بسته سوئیفت

درایور SDK را می‌توان از طریق Swift Package Manager نصب کرد. برای افزودن SDK، مطمئن شوید که هرگونه وابستگی درایور SDK موجود را حذف کرده‌اید.

برای اضافه کردن SDK به یک پروژه جدید یا موجود، مراحل زیر را دنبال کنید:

  1. project یا workspace Xcode خود را باز کنید، سپس به File > Add Package Dependencies بروید.
  2. آدرس https://github.com/googlemaps/ios-driver-sdk را به عنوان URL وارد کنید، Enter را بزنید تا بسته را دریافت کنید و روی «افزودن بسته» کلیک کنید.
  3. برای نصب یک version خاص، فیلد Dependency Rule را روی یکی از گزینه‌های مبتنی بر نسخه تنظیم کنید. برای پروژه‌های جدید، توصیه می‌کنیم آخرین نسخه را مشخص کرده و از گزینه "Exact Version" استفاده کنید. پس از تکمیل، روی "Add Package" کلیک کنید.

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

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

نگهداری و ارتقاء

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

کوکوپادها

  1. یک ترمینال باز کنید و به دایرکتوری حاوی Podfile بروید:

    cd <path-to-project>
  2. برای بررسی اینکه آیا نسخه جدیدتری از Driver SDK برای iOS در دسترس است یا خیر، pod outdated را اجرا کنید.
  3. اگر نسخه جدیدتری از SDK پیدا شد، Podfile خود را با این نسخه جدید به‌روزرسانی کنید. برای یادگیری نحوه تنظیم یک نسخه خاص در Podfile خود، به بخش «مشخص کردن نسخه‌های pod» مراجعه کنید.
  4. اجرای pod update .
  5. هرگونه تغییر لازم را در نتیجه ارتقا اعمال کنید. برای مشاهده فهرست تغییرات در هر نسخه ، به یادداشت‌های انتشار مراجعه کنید.
  6. با انتخاب گزینه Product > Clean و سپس Product > Build، پروژه خود را پاکسازی و بازسازی کنید.

نصب دستی

لینک جدیدترین فایل‌های منبع را از نصب SDK دریافت کنید .

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