iOS용 Places SDK 버전

플랫폼 선택: Android iOS JavaScript

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

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

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

    혜택:

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

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

    혜택:

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

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

설치

Swift Package Manager

iOS용 Places SDK는 Swift Package Manager를 통해 설치할 수 있습니다. SDK를 추가하려면 기존 iOS용 Places SDK 종속 항목을 삭제해야 합니다.

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

  1. Xcode project 또는 workspace를 연 다음 File > Add Package Dependencies(파일 > 패키지 종속 항목 추가)로 이동합니다.
  2. URL로 https://github.com/googlemaps/ios-places-sdk를 입력하고 Enter 키를 눌러 패키지를 가져온 다음 'Add Package'(패키지 추가)를 클릭합니다.
  3. 특정 version을 설치하려면 Dependency Rule 필드를 버전 기반 옵션 중 하나로 설정합니다. 새 프로젝트의 경우 최신 버전을 지정하고 'Exact Version'(정확한 버전) 옵션을 사용하는 것이 좋습니다. 완료되면 'Add Package'(패키지 추가)를 클릭합니다.
  4. Choose Package Products(패키지 제품 선택) 창에서 GooglePlaces, GooglePlacesSwift 또는 둘 다 지정된 기본 대상에 추가되는지 확인합니다. 완료되면 Add Package(패키지 추가)를 클릭합니다.

    지원 중단된 GitHub URL에서 Google Places Swift를 업데이트하는 경우

    중요: Google Places Swift에 액세스하는 GitHub URL이 버전 0.3.0부터 변경되었습니다. 이전 URL(https://github.com/googlemaps/ios-places-swift-sdk)을 통해 액세스한 GooglePlacesSwift 버전을 업데이트하는 경우 Xcode의 패키지 종속 항목 섹션에서 삭제하세요.

  5. 설치를 확인하려면 대상의 General(일반) 창으로 이동합니다. Frameworks, Libraries, and Embedded Content(프레임워크, 라이브러리, 삽입된 콘텐츠)에 설치된 패키지가 표시됩니다. Project Navigator(프로젝트 탐색기)의 Package Dependencies(패키지 종속 항목) 섹션을 확인하여 패키지와 버전을 확인할 수도 있습니다.

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

  1. Xcode에서 File > Packages > Update To Latest Package Versions(파일 > 패키지 > 최신 패키지 버전으로 업데이트)로 이동합니다.

    지원 중단된 GitHub URL에서 Google Places Swift를 업데이트하는 경우

    중요: Google Places Swift에 액세스하는 GitHub URL이 버전 0.3.0부터 변경되었습니다. 이전 URL(https://github.com/googlemaps/ios-places-swift-sdk)을 통해 액세스한 GooglePlacesSwift 버전을 업데이트하는 경우 Xcode의 패키지 종속 항목 섹션에서 삭제하세요.

  2. 설치를 확인하려면 Project Navigator(프로젝트 탐색기)의 Package Dependencies(패키지 종속 항목) 섹션으로 이동하여 패키지와 버전을 확인합니다.

유지보수 및 업그레이드

최신 개선사항으로 빌드하려면 최신 버전을 정기적으로 확인하고 버전 사양을 업데이트하세요. 새로운 메이저 버전으로 업데이트하는 경우 출시 노트를 확인하여 이전 버전과 호환되지 않는 변경사항을 확인하고 코드 업데이트 방법을 살펴보세요.

Swift Package Manager

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

  1. 설치를 확인하려면 Project Navigator(프로젝트 탐색기)의 Package Dependencies(패키지 종속 항목) 섹션으로 이동하여 패키지와 버전을 확인합니다.

수동 설치

최신 소스 파일 링크를 가져옵니다. SDK 설치에서.

Google Cloud 프로젝트 소유자는 최신 버전에 대한 설문조사 외에도 이전 버전과 호환되지 않아 프로젝트에 영향을 줄 수도 있는 변경사항에 관한 이메일을 받게 됩니다. 이전 버전과 호환되지 않는 변경사항에 관한 사전 알림을 받으려면 프로젝트별로 모니터링되는 이메일 주소를 보유하는 소유자 역할을 할당하세요.