Google Maps Platform팀은 새로운 기능, 버그 수정, 성능 개선 사항을 반영하여 SDK를 정기적으로 업데이트합니다. 이 페이지에서는 모바일 SDK의 종속 항목을 관리하는 방법을 안내합니다.
연결할 버전
-
미션 크리티컬 앱의 경우 사용 중인 메이저 버전의 최신 도트 버전(X.*)에 연결하고 매년 새 메이저 버전으로 업그레이드하세요.
한 해 동안 애플리케이션의 새 버전을 출시하면 iOS용 Places SDK의 최신 도트 버전을 사용할 수 있습니다. 새 도트 버전은 이전 버전과 호환되므로 애플리케이션에서 업데이트하지 않아도 됩니다.
이점:
- iOS용 Places SDK에서 문제가 발견되면 모바일 지원 정책에 따라 메이저 버전의 첫 출시 후 12개월 동안 이전 버전과 호환되는 방식으로 수정사항이 제공됩니다. 호환되지 않는 SDK 버전으로 급하게 업그레이드하지 않아도 수정사항의 이점을 누릴 수 있습니다.
- 앱이 이미 최신 버전으로 빌드되면 최신 개선사항과 기능을 쉽게 적용할 수 있습니다.
- 최신 메이저 버전의 SDK에 대한 연례 점진 업데이트가 이루어지면 여러 메이저 버전에 도입된 하위 비호환 변경사항을 처리해야 할 때보다 더 적은 노력으로 애플리케이션을 조정, 재작성, 테스트할 수 있습니다.
미션 크리티컬 앱이 아닌 경우 수정된 버전에 연결합니다. 수정된 버전에 대한 지원 중단 알림을 받은 경우 12개월 이내에 업데이트된 앱 코드를 사용자에게 제공해야 합니다.
이점:
- 유지보수 작업 빈도가 줄어듭니다.
- 앱의 새 버전은 새 SDK 버전으로 업그레이드해야 할 때까지 이전 모바일 운영체제를 실행하는 사용자의 기기를 더 오래 지원합니다.
모니터링되는 이메일 주소가 있는 프로젝트 소유자는 각 프로젝트에 영향을 미치는 변경사항에 대한 사전 알림을 받습니다. 주요 업데이트, 지원 중단 및 기타 변경사항에 대한 최신 정보를 확인하세요.
설치
예측할 수 없고 반복할 수 없는 빌드로 이어질 수 있으므로 낙관적 연산자(~>
)를 사용하는 대신 항상 종속 항목에 버전 번호를 지정합니다. iOS용 Places SDK는 시맨틱 버전 관리를 준수하며 새로운 주요 버전 출시에는 브레이킹 체인지가 포함됩니다.
CocoaPods 사용
Podfile 구문을 사용하는 Podfile 종속 항목의 예:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '14.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GooglePlaces', '8.0.0' end
Carthage 사용
Cartfile 구문을 사용하는 Cartfile 종속 항목의 예:
binary "https://dl.google.com/geosdk/GooglePlaces.json" == 6.2.1
유지보수 및 업그레이드
최신 개선사항으로 빌드하려면 정기적으로 최신 버전을 확인하고 버전 사양을 업데이트하세요. 새로운 메이저 버전으로 업데이트하는 경우 출시 노트에서 이전 버전과 호환되지 않는 변경사항과 코드 업데이트 방법을 확인하세요.
CocoaPods 사용
터미널을 열고
Podfile
이 포함된 디렉터리로 이동합니다.cd <path-to-project>
pod outdated
를 실행하여 iOS용 Places SDK의 최신 버전을 사용할 수 있는지 확인하세요.- 최신 버전의 SDK가 있으면
Podfile
를 새 버전으로 업데이트합니다.Podfile
에서 특정 버전을 설정하는 방법은 포드 버전 지정을 참조하세요. pod update
를 실행합니다.- 업그레이드에 따라 필요한 사항을 변경합니다. 각 출시 버전의 변경사항 목록은 출시 노트를 참고하세요.
- Product > Clean을 선택한 다음 Product > Build를 선택하여 프로젝트를 정리하고 다시 빌드합니다.
Carthage 사용
터미널을 열고
Podfile
이 포함된 디렉터리로 이동합니다.cd <path-to-project>
carthage outdated
를 실행하여 iOS용 Places SDK의 최신 버전을 사용할 수 있는지 확인하세요.- 최신 버전의 SDK가 있으면
Cartfile
를 새 버전으로 업데이트합니다.Cartfile
에서 특정 버전을 설정하는 방법은 버전 요구사항을 참고하세요. carthage update
를 실행합니다.- 업그레이드에 따라 필요한 사항을 변경합니다. 각 출시 버전의 변경사항 목록은 출시 노트를 참고하세요.
- Product > Clean을 선택한 다음 Product > Build를 선택하여 프로젝트를 정리하고 다시 빌드합니다.
수동
SDK 설치 시 최신 소스 파일 링크를 가져옵니다.
Google Cloud 프로젝트 소유자는 최신 버전을 폴링하는 것 외에도 이전 버전과 호환되지 않아 프로젝트에 영향을 줄 수 있는 변경사항에 관한 이메일을 받게 됩니다. 이전 버전과 호환되지 않는 변경사항에 관한 사전 알림을 받으려면 프로젝트마다 모니터링되는 이메일 주소를 사용하여 소유자 역할을 할당합니다.