준비하기

아이나비 지도 SDK를 사용하기 위한 프로젝트 기본 설정 방법을 설명합니다.

0.20.0 미만 버전은 일정 시간이 지난 후 지원이 종료될 수 있습니다. 0.20.0 이상 버전으로 업그레이드를 권장합니다.

사전 준비

‌아이나비 지도 SDK를 사용하기 위해서는 인증을 위한 APP KEY가 필요합니다.‌

서비스 활성화 및 APP KEY 발급

• APP KEY 발급을 위해서는 iMPS 계정이 필요합니다. 계정이 없다면 먼저 계정을 생성해주세요.

• iMPS Console 에서 APP을 생성합니다.

• 생성된 APP에서 상품을 신청을 신청하시면, APP KEY를 확인할 수 있습니다.

Android Studio 프로젝트 환경 구성

아이나비 지도 SDK는 별도 저장소를 통해 배포되므로, 다음과 같이 프로젝트 및 앱 모듈 레벨의 build.gradle 파일에 저장소 설정과 아이나비 지도 SDK에 대한 의존성을 추가합니다.

/* Root Project build.gradle */
allprojects {
    repositories {
        google()
        ...
        // 아이나비 지도 저장소
        maven { url 'https://repo.inavi.com/artifactory/maps' }
    }
}

/* App Module build.gradle */
dependencies {
    implementation 'com.inavi.mapsdk:inavi-maps-sdk:0.21.1'
}

난독화 설정

R8/ProGuard를 사용하는 릴리스 빌드에서는 iNavi Maps SDK 관련 클래스 보존을 위해 아래 규칙을 proguard-rules.pro 또는 consumer-rules.pro에 필수로 추가해야 합니다.

-keep class com.inavi.mapsdk.** { *; }
-dontwarn com.inavi.mapsdk.**

APP KEY 설정

발급받은 APP KEY를 설정할 수 있도록 아래의 두 가지 방법을 제공합니다.

APP KEY가 설정되지 않으면 지도 초기화 단계에서 인증 오류가 발생합니다.

AndroidManifest.xml에서 설정

AndroidManifest.xml에 다음과 같이 <meta-data>를 추가하여 APP KEY를 설정할 수 있습니다.

<!-- AndroidManifext.xml -->
<manifest>
    <application>
        <meta-data
            android:name="com.inavi.mapsdk.AppKey"
            android:value="YOUR_APP_KEY" />
    </application>
</manifest>

InaviMapSdk API 호출로 설정

Application 생성 시점에 동적으로 InaviMapSdk 싱글턴 객체의 함수를 호출하여 APP KEY를 설정할 수 있습니다.

Kotlin

InaviMapSdk.getInstance(context).appKey = "YOUR_APP_KEY"

인증 실패 처리

지도 초기화 단계에서 인증을 실패하면 SDK 내부에 등록된 콜백 함수로 에러 코드와 메시지를 전달합니다. 인증 실패에 대한 이벤트를 처리하려면 InaviMapSdk 싱글턴 객체의 authFailureCallback 속성을 아래와 같이 설정해야 합니다.

Kotlin

InaviMapSdk.getInstance(context).authFailureCallback =
    InaviMapSdk.AuthFailureCallback { errCode: Int, msg: String ->
        // 인증 실패 처리
}

authFailureCallback 속성을 별도로 설정하지 않으면 기본적으로 에러 코드와 메시지가 팝업 형태로 표출됩니다.

인증 에러 코드

Code	Description
300	앱키 인증 오류
401	앱키 설정되지 않음
503	서버 연결 실패
504	서버 연결 시간 초과
500	알 수 없는 에러