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를 추가하려면 다음 단계를 따르세요.
-
Xcode
project
또는workspace
를 열고 File(파일) > 패키지 종속 항목 추가를 참조하세요. - URL에 https://github.com/googlemaps/ios-maps-sdk를 입력하고 Enter 키를 누릅니다. 패키지를 가져오고 '패키지 추가'를 클릭합니다.
-
특정
version
를 설치하려면 종속 항목 규칙 필드를 버전 기반 옵션입니다 새 프로젝트의 경우 최신 버전을 지정하고 '정확한 버전'을 사용하는 경우 옵션을 선택합니다. 완료되면 'Add Package'를 클릭합니다. -
Choose Package Products 창에서
GoogleMaps
을 확인합니다 (9.0.0 이전 버전의 경우GoogleMaps
,GoogleMapsBase
,GoogleMapsCore
)이(가) 추가될 예정 지정된main
타겟 완료되면 'Add Package'를 클릭합니다. -
설치를 확인하려면 대상의
General
창으로 이동합니다. 프레임워크, 라이브러리 및 삽입된 콘텐츠에서 설치된 패키지를 확인할 수 있습니다. '프로젝트 탐색기'의 '패키지 종속 항목' 섹션을 확인하여 패키지와 버전을 확인할 수도 있습니다.
기존 프로젝트의 package
를 업데이트하려면 다음 단계를 따르세요.
9.0.0 이전 버전에서 업그레이드하는 경우
GoogleMapsBase
,GoogleMapsCore
, 업그레이드 후GoogleMapsM4B
의 비용이 청구됩니다. 다음 종속 항목을 삭제하지 마세요.GoogleMaps
자세한 내용은 버전 9.0.0 출시 노트Xcode 프로젝트 구성 설정에서 프레임워크, 라이브러리, 및 삽입된 콘텐츠를 선택합니다. 빼기 기호(-)를 사용하여 다음 프레임워크를 삭제합니다.
GoogleMapsBase
(9.0.0 이전 버전에서 업그레이드하는 경우에만)GoogleMapsCore
(9.0.0 이전 버전에서 업그레이드하는 경우에만)GoogleMapsM4B
(9.0.0 이전 버전에서 업그레이드하는 경우에만)
- Xcode에서 'File(파일) > 패키지 > 최신 패키지 버전으로 업데이트'라는 메시지가 표시됩니다.
- 설치를 확인하려면 Project Navigator의 Package Dependencies 섹션으로 이동합니다. 패키지와 해당 버전을 확인합니다.
다음을 사용하여 추가된 기존 iOS용 Maps SDK 종속 항목을 삭제하려면 다음 단계를 따르세요.
CocoaPods
인 경우 다음 단계를 따르세요.
- Xcode 작업공간을 닫습니다. 터미널을 열고 다음 명령어를 실행합니다.
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
Podfile
,Podfile.resolved
, CocoaPods 외의 용도로 사용하지 않는 경우 Xcodeworkspace
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
를 업데이트하려면 다음 단계를 따르세요.
- Xcode에서 'File(파일) > Packages(패키지) > Update To Latest Package Versions(최신 패키지 버전으로 업데이트)'로 이동합니다.
- 설치를 확인하려면 Project Navigator의 Package Dependencies 섹션으로 이동합니다. 패키지와 해당 버전을 확인합니다.
CocoaPods
터미널을 열고
Podfile
가 포함된 디렉터리로 이동합니다.cd <path-to-project>
pod outdated
를 실행하여 최신 버전의 iOS용 Maps SDK가 있는지 확인합니다. 을(를) 사용할 수 있습니다.- 새 버전의 SDK가 발견되면 이 새 버전으로
Podfile
을 업데이트합니다.Podfile
에서 특정 버전을 설정하는 방법을 알아보려면 포드 버전 지정을 참고하세요. pod update
을 실행합니다.- 업그레이드로 인해 필요한 사항을 변경합니다. 자세한 내용은 출시 노트에서 각 버전의 변경사항 목록을 확인하세요.
- 제품 > > 프로젝트를 정리하고 다시 빌드합니다. 정리를 선택한 다음 제품 > 빌드
수동 설치
최신 소스 파일의 링크 가져오기 확인하시기 바랍니다.
Google Cloud는 최신 버전을 폴링하는 것 외에도 프로젝트 소유자는 이전 버전과 호환되지 않아 프로젝트에 영향을 줄 수 있는 변경사항에 관한 이메일을 받게 됩니다. 받는사람 이전 버전과 호환되지 않는 변경사항에 관한 사전 알림을 받을 수 있음 할당 소유자 역할을 프로젝트별로 모니터링하는 이메일 주소가 필요합니다.