Navigation SDK는 Maven을 통해 사용할 수 있습니다. 후(After) 개발 프로젝트를 생성한 경우, 다음 접근 방식 중 하나를 사용할 수 있습니다.
Navigation SDK에 Maven 사용 (권장)
다음은 가장 간단하고 간단한 google()
Maven 저장소를 사용합니다.
프로젝트에 Navigation SDK를 추가하는 것이 좋습니다.
Gradle 또는 Maven 구성에 다음 종속 항목을 추가합니다.
VERSION_NUMBER
자리표시자를 원하는 버전의 Android용 Navigation SDK를 사용해야 합니다.Gradle
모듈 수준
build.gradle
에 다음을 추가합니다.dependencies { ... implementation 'com.google.android.libraries.navigation:navigation:VERSION_NUMBER' }
Maven
pom.xml
에 다음을 추가합니다.<dependencies> ... <dependency> <groupId>com.google.android.libraries.navigation</groupId> <artifactId>navigation</artifactId> <version>VERSION_NUMBER</version> </dependency> </dependencies>
Maps SDK를 사용하는 종속 항목이 있는 경우 Maps SDK를 사용하는 선언된 각 종속 항목의 종속 항목입니다.
Gradle
최상위 수준
build.gradle
에 다음을 추가합니다.allprojects { ... // Required: you must exclude the Google Play service Maps SDK from // your transitive dependencies. This is to ensure there won't be // multiple copies of Google Maps SDK in your binary, as the Navigation // SDK already bundles the Google Maps SDK. configurations { implementation { exclude group: 'com.google.android.gms', module: 'play-services-maps' } } }
Maven
pom.xml
에 다음을 추가합니다.<dependencies> <dependency> <groupId>project.that.brings.in.maps</groupId> <artifactId>MapsConsumer</artifactId> <version>1.0</version> <exclusions> <!-- Navigation SDK already bundles Maps SDK. You must exclude it to prevent duplication--> <exclusion> <!-- declare the exclusion here --> <groupId>com.google.android.gms</groupId> <artifactId>play-services-maps</artifactId> </exclusion> </exclusions> </dependency> </dependencies>
빌드 구성
프로젝트를 생성한 후에는 해당 프로젝트의 설정을 구성할 수 있습니다. Navigation SDK를 사용하는 방법을 설명합니다.
로컬 숙박 시설 업데이트
- Gradle Scripts 폴더에서
local.properties
파일을 열고android.useDeprecatedNdk=true
입니다.
Gradle 빌드 스크립트 업데이트
build.gradle (Module:app)
파일을 열고 다음 가이드라인을 사용합니다. 설정을 업데이트하여 Navigation SDK를 설정하고 최적화 옵션을 사용할 수 있습니다.Navigation SDK의 필수 설정
minSdkVersion
를 23 이상으로 설정합니다.targetSdkVersion
를 33 이상으로 설정합니다.javaMaxHeapSize
를 늘리는dexOptions
설정을 추가합니다.- 추가 라이브러리의 위치를 설정합니다.
repositories
및dependencies
를 Navigation SDK를 지원합니다.- 종속 항목의 버전 번호를 최신 버전으로 바꿉니다. 사용할 수 있습니다
빌드 시간을 줄이기 위한 선택적 설정
- 코드 축소 및 리소스 사용 설정 축소 R8/ProGuard를 사용하여 종속 항목에서 사용하지 않는 코드와 리소스를 삭제합니다. 만약 R8/ProGuard 단계를 실행하는 데 시간이 너무 오래 걸립니다. multidex 여러 가지 방법이 있습니다
- 빌드에 포함된 언어 번역 수를 줄입니다.
개발 중에는 한 언어에
resConfigs
를 사용합니다. 최종 빌드의 경우 실제로 사용하는 언어에resConfigs
를 설정합니다. 기본적으로 Gradle은 는 Navigation SDK를 지원합니다.
Java8 지원을 위해 디슈가링 추가
- Android Gradle 플러그인 4.0.0 또는 다양한 Java 8 언어 사용 지원을 확장합니다. API에 액세스할 수 있습니다 자바 8 디슈가링을 참고하세요. 지원 를 참조하세요. 방법은 아래의 빌드 스크립트 스니펫 예를 참고하세요. 종속 항목 옵션을 제공합니다.
다음은 애플리케이션의 Gradle 빌드 스크립트의 예입니다. 자세한 내용은 업데이트된 종속 항목 집합을 위한 샘플 앱을 사용 중인 Navigation SDK가 약간 앞서거나 살펴봤습니다
apply plugin: 'com.android.application'
ext {
navSdk = "__NAVSDK_VERSION__"
}
android {
compileSdk 33
buildToolsVersion='28.0.3'
defaultConfig {
applicationId "<your id>"
// Navigation SDK supports SDK 23 and later.
minSdkVersion 23
targetSdkVersion 33
versionCode 1
versionName "1.0"
// Set this to the languages you actually use, otherwise you'll include resource strings
// for all languages supported by the Navigation SDK.
resConfigs "en"
multiDexEnabled true
}
dexOptions {
// This increases the amount of memory available to the dexer. This is required to build
// apps using the Navigation SDK.
javaMaxHeapSize "4g"
}
buildTypes {
// Run ProGuard. Note that the Navigation SDK includes its own ProGuard configuration.
// The configuration is included transitively by depending on the Navigation SDK.
// If the ProGuard step takes too long, consider enabling multidex for development work
// instead.
all {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
compileOptions {
// Flag to enable support for the new language APIs
coreLibraryDesugaringEnabled true
// Sets Java compatibility to Java 8
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
repositories {
// Navigation SDK for Android and other libraries are hosted on Google's Maven repository.
google()
}
dependencies {
// Include the Google Navigation SDK.
// Note: remember to exclude Google Play service Maps SDK from your transitive
// dependencies to avoid duplicate copies of the Google Maps SDK.
api "com.google.android.libraries.navigation:navigation:${navSdk}"
// Declare other dependencies for your app here.
annotationProcessor "androidx.annotation:annotation:1.7.0"
coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.1.9'
}
앱에 API 키 추가
이 섹션에서는 앱이 더욱 안전하게 참조할 수 있도록 API 키를 저장하는 방법을 설명합니다. API 키는 버전 제어 시스템에 체크인하면 안 되며, 프로젝트의 루트 디렉터리에 있는 secrets.properties
파일에 저장하는 것이 좋습니다. secrets.properties
파일에 관한 자세한 내용은
Gradle 속성 파일을 참고하세요.
이 작업을 간소화하려면 Android용 Secrets Gradle 플러그인을 사용하는 것이 좋습니다.
Google 지도 프로젝트에 Android용 Secrets Gradle 플러그인을 설치하려면 다음 단계를 따르세요.
-
Android 스튜디오에서 최상위 수준
build.gradle.kts
또는build.gradle
파일을 열고 다음 코드를buildscript
아래dependencies
요소에 추가합니다.Kotlin
buildscript { dependencies { classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1") } }
Groovy
buildscript { dependencies { classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1" } }
-
모듈 수준
build.gradle.kts
또는build.gradle
파일을 열고 다음 코드를plugins
요소에 추가합니다.Kotlin
plugins { // ... id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") }
Groovy
plugins { // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' }
- 모듈 수준
build.gradle.kts
또는build.gradle
파일에서 다음을 확인합니다.targetSdk
및compileSdk
가 설정되어 있음 34로 설정합니다. - 파일을 저장하고 프로젝트를 Gradle과 동기화합니다.
-
최상위 수준 디렉터리에서
secrets.properties
파일을 연 후 다음 코드를 추가합니다.YOUR_API_KEY
를 직접 생성한 API 키로 변경합니다.secrets.properties
가 버전 제어 시스템에 체크인되는 데서 제외되었으므로 키를 이 파일에 저장합니다.NAV_API_KEY=YOUR_API_KEY
- 파일을 저장합니다.
-
최상위 수준 디렉터리에서
secrets.properties
파일과 동일한 폴더에local.defaults.properties
파일을 만든 후 다음 코드를 추가합니다.NAV_API_KEY=DEFAULT_API_KEY
이 파일의 목적은
secrets.properties
파일이 없는 경우 빌드에 실패하지 않도록 API 키의 백업 위치를 제공하는 것입니다. 이는 버전 제어 시스템에서secrets.properties
가 빠진 앱을 복제하거나 API 키를 제공하는secrets.properties
파일을 아직 로컬에서 생성하지 않은 경우 발생할 수 있습니다. - 파일을 저장합니다.
-
AndroidManifest.xml
파일에서com.google.android.geo.API_KEY
로 이동한 후android:value attribute
를 업데이트합니다.<meta-data>
태그가 존재하지 않으면<application>
태그의 하위 요소로 태그를 만듭니다.<meta-data android:name="com.google.android.geo.API_KEY" android:value="${MAPS_API_KEY}" />
Note:
com.google.android.geo.API_KEY
is the recommended metadata name for the API key. A key with this name can be used to authenticate to multiple Google Maps-based APIs on the Android platform, including the Navigation SDK for Android. For backwards compatibility, the API also supports the namecom.google.android.maps.v2.API_KEY
. This legacy name allows authentication to the Android Maps API v2 only. An application can specify only one of the API key metadata names. If both are specified, the API throws an exception. -
In Android Studio, open your module-level
build.gradle.kts
orbuild.gradle
file and edit thesecrets
property. If thesecrets
property does not exist, add it.Edit the properties of the plugin to set
propertiesFileName
tosecrets.properties
, setdefaultPropertiesFileName
tolocal.defaults.properties
, and set any other properties.Kotlin
secrets { // To add your Maps API key to this project: // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file. // 2. Add this line, where YOUR_API_KEY is your API key: // MAPS_API_KEY=YOUR_API_KEY propertiesFileName = "secrets.properties" // A properties file containing default secret values. This file can be // checked in version control. defaultPropertiesFileName = "local.defaults.properties" // Configure which keys should be ignored by the plugin by providing regular expressions. // "sdk.dir" is ignored by default. ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore" ignoreList.add("sdk.*") // Ignore all keys matching the regexp "sdk.*" }
Groovy
secrets { // To add your Maps API key to this project: // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file. // 2. Add this line, where YOUR_API_KEY is your API key: // MAPS_API_KEY=YOUR_API_KEY propertiesFileName = "secrets.properties" // A properties file containing default secret values. This file can be // checked in version control. defaultPropertiesFileName = "local.defaults.properties" // Configure which keys should be ignored by the plugin by providing regular expressions. // "sdk.dir" is ignored by default. ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore" ignoreList.add("sdk.*") // Ignore all keys matching the regexp "sdk.*" }
앱에 필수 저작자 표시 포함
앱에서 Android용 Navigation SDK를 사용하는 경우 앱 법적 고지에 포함된 저작자 표시 텍스트 및 오픈소스 라이선스 섹션으로 이동합니다.
필요한 저작자 표시 텍스트와 오픈소스 라이선스는 다음 페이지에서 확인할 수 있습니다. Android용 Navigation SDK ZIP 파일:
NOTICE.txt
LICENSES.txt
모빌리티 또는 플릿 엔진 배달 고객인 경우
Mobility 또는 Fleet Engine Deliveries 고객인 경우 모바일 문서에 대한 청구 관련 사항을 참조하세요. 자세한 내용은 거래 기록, 결제 설정 청구 가능한 거래 기록 보고 청구 가능한 거래 기록 (Android).
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-08-21(UTC)
[] [] { "last_modified": "최종 업데이트: 2024-08-21(UTC)", "state": "" }