iOS용 Maps SDK 버전

플랫폼 선택: Android iOS JavaScript

Google Maps Platform팀은 새로운 기능, 버그 수정, 성능 개선 사항을 반영하여 SDK를 정기적으로 업데이트합니다. 이 페이지에서는 모바일 SDK의 종속 항목을 관리하는 방법을 안내합니다.

  • 미션 크리티컬 앱의 경우 사용 중인 메이저 버전의 최신 도트 버전(X.*)에 연결하고 매년 새 메이저 버전으로 업그레이드하세요.

    애플리케이션의 새 버전을 출시할 때 iOS용 Maps SDK의 최신 도트 버전을 사용할 수 있습니다. 새 도트 버전은 이전 버전과 호환되므로 애플리케이션에서 업데이트하지 않아도 됩니다.

    장점:

    • iOS용 Maps SDK에서 문제가 발견되면 수정사항이 12개월 동안 이전 버전과 호환되는 방식으로 모바일 지원 정책을 참조하세요. 호환되지 않는 SDK 버전으로 급하게 업그레이드하지 않아도 수정사항의 이점을 누릴 수 있습니다.
    • 앱이 이미 최신 버전으로 빌드되면 최신 개선사항과 기능을 쉽게 적용할 수 있습니다.
    • 한 해 동안 점진적으로 최신 메이저 버전의 SDK에 대한 업데이트가 이루어지면 여러 메이저 버전에 도입된 하위 비호환 변경사항을 처리해야 할 때보다 더 적은 노력으로 애플리케이션을 조정, 재작성, 테스트할 수 있습니다.

  • 미션 크리티컬 앱이 아닌 경우 수정된 버전에 연결합니다. 수정된 버전에 대한 지원 중단 알림을 받은 경우 12개월 이내에 업데이트된 앱 코드를 사용자에게 제공해야 합니다.

    장점:

    • 유지보수 작업 빈도가 줄어듭니다.
    • 앱의 새 버전은 새 SDK 버전으로 업그레이드해야 할 때까지 이전 모바일 운영체제를 실행하는 사용자의 기기를 더 오래 지원합니다.

모니터링되는 이메일 주소가 있는 프로젝트 소유자는 각 프로젝트에 영향을 미치는 변경사항에 대한 사전 알림을 받습니다. 주요 업데이트, 지원 중단 및 기타 변경사항에 대한 최신 정보를 확인하세요.

설치

Swift Package Manager

iOS용 Maps SDK는 을(를) 통해 설치할 수 있습니다. Swift Package Manager SDK를 추가하려면 기존의 iOS용 Maps SDK 종속 항목이 삭제되었습니다.

새 프로젝트 또는 기존 프로젝트에 SDK를 추가하려면 다음 단계를 따르세요.

  1. Xcode project 또는 workspace를 열고 File(파일) > 패키지 종속 항목 추가를 참조하세요.
  2. URL에 https://github.com/googlemaps/ios-maps-sdk를 입력하고 Enter 키를 누릅니다. 패키지를 가져오고 '패키지 추가'를 클릭합니다.
  3. 특정 version를 설치하려면 종속 항목 규칙 필드를 버전 기반 옵션입니다 새 프로젝트의 경우 최신 버전을 지정하고 '정확한 버전'을 사용하는 경우 옵션을 선택합니다. 완료되면 'Add Package'를 클릭합니다.
  4. Choose Package Products 창에서 GoogleMaps을 확인합니다 (9.0.0 이전 버전의 경우 GoogleMaps, GoogleMapsBase, GoogleMapsCore)이(가) 추가될 예정 지정된 main 타겟 완료되면 'Add Package'를 클릭합니다.
  5. 설치를 확인하려면 대상의 General 창으로 이동합니다. 프레임워크, 라이브러리 및 삽입된 콘텐츠에서 설치된 패키지를 확인할 수 있습니다. '프로젝트 탐색기'의 '패키지 종속 항목' 섹션을 확인하여 패키지와 버전을 확인할 수도 있습니다.

기존 프로젝트의 package를 업데이트하려면 다음 단계를 따르세요.

  1. 9.0.0 이전 버전에서 업그레이드하는 경우 GoogleMapsBase, GoogleMapsCore, 업그레이드 후 GoogleMapsM4B의 비용이 청구됩니다. 다음 종속 항목을 삭제하지 마세요. GoogleMaps 자세한 내용은 버전 9.0.0 출시 노트

    Xcode 프로젝트 구성 설정에서 프레임워크, 라이브러리, 및 삽입된 콘텐츠를 선택합니다. 빼기 기호(-)를 사용하여 다음 프레임워크를 삭제합니다.

    • GoogleMapsBase (9.0.0 이전 버전에서 업그레이드하는 경우에만)
    • GoogleMapsCore (9.0.0 이전 버전에서 업그레이드하는 경우에만)
    • GoogleMapsM4B (9.0.0 이전 버전에서 업그레이드하는 경우에만)
  2. Xcode에서 'File(파일) > 패키지 > 최신 패키지 버전으로 업데이트'라는 메시지가 표시됩니다.
  3. 설치를 확인하려면 Project NavigatorPackage Dependencies 섹션으로 이동합니다. 패키지와 해당 버전을 확인합니다.

다음을 사용하여 추가된 기존 iOS용 Maps SDK 종속 항목을 삭제하려면 다음 단계를 따르세요. CocoaPods인 경우 다음 단계를 따르세요.

  1. Xcode 작업공간을 닫습니다. 터미널을 열고 다음 명령어를 실행합니다.
    sudo gem install cocoapods-deintegrate cocoapods-clean 
    pod deintegrate 
    pod cache clean --all
  2. Podfile, Podfile.resolved, CocoaPods 외의 용도로 사용하지 않는 경우 Xcode workspace

CocoaPods

낙관적 연산자를 사용하는 대신 항상 종속 항목에 버전 번호를 지정합니다. (~>)로 설정합니다. 이는 예측 불가능하고 반복 불가능한 빌드로 이어질 수 있기 때문입니다. iOS용 Maps SDK는 의미론적 버전 관리를 준수하며, 새로운 메이저 버전에는 브레이킹 체인지가 포함됩니다.

다음을 사용하는 Podfile 종속 항목의 예 Podfile 구문:

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

platform :ios, '15.0'

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

유지보수 및 업그레이드

최신 개선사항으로 빌드하려면 정기적으로 최신 버전을 확인하고 버전을 업데이트하세요. 지정할 수도 있습니다 새로운 메이저 버전으로 업데이트하는 경우 출시 노트를 참조하세요.

Swift Package Manager

기존 프로젝트의 package를 업데이트하려면 다음 단계를 따르세요.

  1. Xcode에서 'File(파일) > Packages(패키지) > Update To Latest Package Versions(최신 패키지 버전으로 업데이트)'로 이동합니다.
  2. 설치를 확인하려면 Project NavigatorPackage Dependencies 섹션으로 이동합니다. 패키지와 해당 버전을 확인합니다.

CocoaPods

  1. 터미널을 열고 Podfile가 포함된 디렉터리로 이동합니다.

    cd <path-to-project>
  2. pod outdated를 실행하여 최신 버전의 iOS용 Maps SDK가 있는지 확인합니다. 을(를) 사용할 수 있습니다.
  3. 새 버전의 SDK가 발견되면 이 새 버전으로 Podfile을 업데이트합니다. Podfile에서 특정 버전을 설정하는 방법을 알아보려면 포드 버전 지정을 참고하세요.
  4. pod update을 실행합니다.
  5. 업그레이드로 인해 필요한 사항을 변경합니다. 자세한 내용은 출시 노트에서 각 버전의 변경사항 목록을 확인하세요.
  6. 제품 > > 프로젝트를 정리하고 다시 빌드합니다. 정리를 선택한 다음 제품 > 빌드

수동 설치

최신 소스 파일의 링크 가져오기 확인하시기 바랍니다.

Google Cloud는 최신 버전을 폴링하는 것 외에도 프로젝트 소유자는 이전 버전과 호환되지 않아 프로젝트에 영향을 줄 수 있는 변경사항에 관한 이메일을 받게 됩니다. 받는사람 이전 버전과 호환되지 않는 변경사항에 관한 사전 알림을 받을 수 있음 할당 소유자 역할을 프로젝트별로 모니터링하는 이메일 주소가 필요합니다.