Android용 Maps SDK v3.1.0 베타 설치하기

이 가이드에서는 Android용 Maps SDK v3.1.0 베타를 설치하는 방법을 소개합니다. 설정이 완료되면 새 지형지물을 사용하는 방법을 알아보세요.

Android용 Maps SDK v3.1.0 베타 버전 설치하기

다음 단계에 따라 Android 스튜디오 프로젝트에 v3.1.0 베타 버전의 Android 클라이언트 라이브러리용 Maps SDK를 직접 추가합니다.

  1. Places 정적 라이브러리를 다운로드합니다(Places를 사용하지 않는 경우 이 단계를 건너뛸 수 있음).

  2. AAR 파일을 Android 스튜디오 프로젝트의 app/libs 폴더에 복사합니다.

    3. Android용 Maps SDK 라이브러리는 Google의 Maven 저장소를 통해 사용할 수 있습니다. 앱에 SDK를 추가하려면 다음 지침을 따르세요.

  3. 최상위 수준 build.gradle 파일의 buildscript.repositories 섹션에 다음과 같이 Google의 Maven 저장소가 나열되어 있는지 확인합니다.

    buildscript {
    repositories {
        google()
        // ...
    }
}

  4. 앱 수준 build.gradle 파일의 dependencies 섹션에서 Android용 Maps SDK를 추가하고 선택사항으로 Places 정적 라이브러리와 필수 종속 항목을 다음과 같이 추가합니다.

    dependencies {
  implementation 'com.google.android.libraries.maps:maps:3.1.0-beta'

  // If you are using Places, add all of the dependencies below
  implementation name:'places-maps-sdk-3.1.0-beta', ext:'aar'
  implementation 'com.google.android.gms:play-services-gcm:17.0.0'
  implementation 'com.google.auto.value:auto-value-annotations:1.6.2'
}

  5. 앱 수준 build.gradle 파일의 dependencies 섹션에서 이전 버전의 구현 라인을 삭제합니다(다음과 비슷하게 표시됩니다).

    6. implementation 'com.google.android.gms:play-services-maps:17.0.0'

    Google Maps Platform 프리미엄 플랜을 사용하는 경우 삭제할 구현 라인은 다음 중 하나로 나타납니다.

    implementation(name:'google-maps-sdk-m4b', ext:'aar')
implementation project(':googlemapssdkm4b_lib')
  6. Gradle 프로젝트를 동기화합니다.

  7. 기존 구성을 변환합니다.

    • 기존 앱에서 Google Play 서비스를 통해 Android용 Maps SDK를 사용하는 경우 com.google.android.gms.maps 패키지에 대한 모든 참조를 com.google.android.libraries.maps 패키지로 바꿉니다(Android 스튜디오에서 편집 > 경로 내 바꾸기... 사용).
    • 기존 앱에서 Google Maps Platform 프리미엄 플랜을 사용하는 경우 com.google.android.m4b.maps 패키지에 대한 모든 참조를 com.google.android.libraries.maps 패키지로 바꿉니다. 또한 XML 레이아웃 속성에 대한 모든 참조에서 m4b_ 프리픽스를 삭제합니다. 예를 들어 m4b_mapType은 mapType이 되어야 하고 m4b_cameraZoom은 cameraZoom이 되어야 합니다.

  8. 출시 빌드에 코드 축소 및 난독화를 사용 설정할 경우 Android용 Maps SDK 클래스를 유지할 수 있도록 ProGuard 규칙을 업데이트합니다. 

    -keep,allowoptimization class com.google.android.libraries.maps.** { *; }

베타 버전 호환 유틸리티 라이브러리 가져오기

Google Maps Android API 유틸리티 라이브러리를 사용 중인 경우, 다음 방법으로 프로젝트 종속 항목을 업데이트하여 기존 버전을 베타 호환 버전으로 대체해야 합니다.

  1. build.gradle 파일에서 베타 호환 유틸리티 라이브러리를 가져옵니다. 
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
  2. build.gradle에서 다음 명령어를 삭제하여 베타 버전에서 호환되지 않는 유틸리티 라이브러리를 삭제합니다. 
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'

샘플 실행

GitHub의 Google 샘플 저장소에는 v3.1.0 베타 Android용 Maps SDK를 사용하는 방법을 보여주는 샘플 앱이 포함되어 있습니다.