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

پلتفرم را انتخاب کنید: Android iOS JavaScript

تیم Google Maps Platform به طور منظم SDK ها را با ویژگی های جدید، رفع اشکالات و بهبود عملکرد به روز می کند. این صفحه راهنمایی در مورد نحوه مدیریت وابستگی های خود به SDK های تلفن همراه ارائه می دهد.

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

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

    مزایا:

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

  • برای برنامه‌های غیر مهم ، به هر نسخه ثابتی پیوند دهید. وقتی یک اخطار منسوخ برای آن نسخه ثابت دریافت می کنید، 12 ماه فرصت خواهید داشت تا کد برنامه به روز شده خود را در دسترس کاربران خود قرار دهید.

    مزایا:

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

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

نصب و راه اندازی

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

Maps SDK برای iOS را می توان از طریق Swift Package Manager نصب کرد. برای افزودن SDK، مطمئن شوید که نقشه های 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 را روی یکی از گزینه های مبتنی بر نسخه تنظیم کنید. برای پروژه های جدید، توصیه می کنیم آخرین نسخه را مشخص کنید و از گزینه "نسخه دقیق" استفاده کنید. پس از تکمیل، روی "افزودن بسته" کلیک کنید.

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

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

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

    • GoogleMapsBase (فقط برای ارتقا از نسخه های قبل از 9.0.0)
    • GoogleMapsCore (فقط برای ارتقا از نسخه های قبل از 9.0.0)
    • GoogleMapsM4B (فقط برای ارتقاء نسخه های قبل از 9.0.0)
  2. از Xcode، به "File > Packages > Update To Latest Package Versions" بروید.
  3. برای تأیید نصب خود، به بخش Package Dependencies در Project Navigator بروید تا بسته و نسخه آن را تأیید کنید.

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

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

CocoaPods

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

نمونه ای از وابستگی Podfile با استفاده از نحو Podfile :

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

platform :ios, '15.0'

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

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

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

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

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

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

کوکوپودها

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

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

نصب دستی

پیوند آخرین فایل های منبع را در نصب SDK دریافت کنید .

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

،
پلتفرم را انتخاب کنید: Android iOS JavaScript

تیم Google Maps Platform به طور منظم SDK ها را با ویژگی های جدید، رفع اشکالات و بهبود عملکرد به روز می کند. این صفحه راهنمایی در مورد نحوه مدیریت وابستگی های خود به SDK های تلفن همراه ارائه می دهد.

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

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

    مزایا:

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

  • برای برنامه‌های غیر مهم ، به هر نسخه ثابتی پیوند دهید. وقتی یک اخطار منسوخ برای آن نسخه ثابت دریافت می کنید، 12 ماه فرصت خواهید داشت تا کد برنامه به روز شده خود را در دسترس کاربران خود قرار دهید.

    مزایا:

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

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

نصب و راه اندازی

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

Maps SDK برای iOS را می توان از طریق Swift Package Manager نصب کرد. برای افزودن SDK، مطمئن شوید که نقشه های 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 را روی یکی از گزینه های مبتنی بر نسخه تنظیم کنید. برای پروژه های جدید، توصیه می کنیم آخرین نسخه را مشخص کنید و از گزینه "نسخه دقیق" استفاده کنید. پس از تکمیل، روی "افزودن بسته" کلیک کنید.

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

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

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

    • GoogleMapsBase (فقط برای ارتقا از نسخه های قبل از 9.0.0)
    • GoogleMapsCore (فقط برای ارتقا از نسخه های قبل از 9.0.0)
    • GoogleMapsM4B (فقط برای ارتقاء نسخه های قبل از 9.0.0)
  2. از Xcode، به "File > Packages > Update To Latest Package Versions" بروید.
  3. برای تأیید نصب خود، به بخش Package Dependencies در Project Navigator بروید تا بسته و نسخه آن را تأیید کنید.

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

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

CocoaPods

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

نمونه ای از وابستگی Podfile با استفاده از نحو Podfile :

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

platform :ios, '15.0'

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

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

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

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

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

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

کوکوپودها

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

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

نصب دستی

پیوند آخرین فایل های منبع را در نصب SDK دریافت کنید .

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