Maps SDK برای نسخه‌های iOS

پلتفرم مورد نظر را انتخاب کنید: اندروید، iOS، جاوا اسکریپت

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

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

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

    مزایا:

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

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

    مزایا:

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

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

نصب

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

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

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

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

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

  1. اگر از نسخه‌ای قبل از ۹.۰.۰ ارتقا می‌دهید، باید وابستگی‌های زیر را حذف کنید: GoogleMapsBase ، GoogleMapsCore و GoogleMapsM4B پس از ارتقا. وابستگی مربوط به GoogleMaps را حذف نکنید. برای اطلاعات بیشتر، به یادداشت‌های انتشار نسخه ۹.۰.۰ مراجعه کنید.

    از تنظیمات پیکربندی پروژه Xcode خود، Frameworks، Libraries و Embedded Content را پیدا کنید. از علامت منها (-) برای حذف framework زیر استفاده کنید:

    • GoogleMapsBase (فقط برای ارتقاء از نسخه‌های قبل از ۹.۰.۰)
    • GoogleMapsCore (فقط برای ارتقاء از نسخه‌های پایین‌تر از ۹.۰.۰)
    • GoogleMapsM4B (فقط برای ارتقاء از نسخه‌های قبل از ۹.۰.۰)
  2. از Xcode، به «فایل > بسته‌ها > به‌روزرسانی به آخرین نسخه‌های بسته» بروید.
  3. برای تأیید نصب خود، به بخش وابستگی‌های بسته‌بندی در Project Navigator بروید تا بسته و نسخه آن را تأیید کنید.

برای حذف وابستگی‌های Maps SDK موجود برای iOS که با استفاده از CocoaPods اضافه شده‌اند، این مراحل را دنبال کنید:

  1. فضای کاری Xcode خود را ببندید. ترمینال را باز کنید و دستور زیر را اجرا کنید: 
    sudo gem install cocoapods-deintegrate cocoapods-clean
pod deintegrate
pod cache clean --all
  2. اگر از Podfile ، Podfile.resolved و workspace Xcode برای چیزی غیر از CocoaPods استفاده نمی‌کنید، آنها را حذف کنید.

کوکوپادز

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

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

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

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '10.8.0'
end

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

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

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

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

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

کوکوپادها

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

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

نصب دستی

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

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