Android Studio 설정

Kakao i Agent SDK를 사용하기 위해서는 Android Studio 프로젝트에서 Gradle 설정과 Manifest 설정을 완료해야 합니다.

Gradle 설정하기

1. Android Studio를 최신 버전으로 업데이트 합니다.

2. Android Studio > New Project 메뉴에서 신규 프로젝트를 생성합니다.

3. build.gradle로 이동하여 minSdkVersion, JavaVersion, jvmTarget 값을 설정하고, applicationId 값을 입력합니다.

   표Gradle 설정값

   구분	설정값
   minSdkVersion	21
   JavaVersion	8
   jvmTarget	1.8
   applicationId	서버에 등록된 애플리케이션 패키지명

   코드예제Gradle 설정

   Groovy

   android {
           defaultConfig {
               ...
               minSdkVersion 21  //Android SDK API 레벨을 21로 설정
               applicationId "{서버에 등록된 애플리케이션 패키지명}"
           }
            compileOptions {    //Java 컴파일러 타깃을 Java8로 설정
               sourceCompatibility JavaVersion.VERSION_1_8
               targetCompatibility JavaVersion.VERSION_1_8
           }
            kotlinOptions {    //Jvm Target을 1.8로 지정
               jvmTarget = "1.8"
           }
           }   
   

   안내
   SDK를 사용하기 위해서는 먼저 카카오 i 서버에 애플리케이션의 패키지명을 등록해야합니다.

   • 패키지명 등록과 관련한 자세한 설명은 사전 작업 문서를 참고하시기 바랍니다.

4. build.gradle(Project) 파일에서 allprojects-repositories 섹션의 mavenCentral()에 각 레포지토리 URL을 추가합니다.

   • Maven 저장소에 접근이 안될 경우에는 로컬 AAR(Android Archive package) 형태로 배포할 수 있습니다.

   코드예제레포지토리 URL 추가

   JavaScript

   maven { url "${projectDir}/repositories" }
   

   표Maven Repository 경로

   의존성 구분	개발 단계	경로
   Kakao SDK	공통	https://devepo.kakao.com/nexus/content/groups/public
   Kakao i Agent SDK	Release (출시)	https://maven.daumcorp.com/content/repositories/daum
   	Snapshots (테스트)	https://maven.daumcorp.com/content/repositories/daum-snapshots

   Maven 접근 가능 시

   코드예제build.gradle (Maven 접근 가능 시)

   Groovy

   allprojects {
   repositories {
       google()
       jcenter()
       mavenCentral()
      //공통 Repository
       maven { url 'http://devrepo.kakao.com/nexus/content/groups/public/' }
       //출시 시 Repository
       maven { url 'http://maven.daumcorp.com/content/repositories/daum' }
       //테스트 시 Repository
       maven { url 'http://maven.daumcorp.com/content/repositories/daum-snapshots' }
   }
   

   Maven 접근 불가능 시

   코드예제build.gradle (Maven 접근 불가능 시)

   Groovy

   allprojects {
   repositories {
       google()
       jcenter()
       mavenCentral()
         // 아래 경로에 aar 파일을 포함
         maven { url "${projectDir}/repositories" }
   }
   

   주의
   Release(출시)와 Snapshots(테스트)의 Maven Repository 경로가 상이하므로, 반드시 확인하여 추가하시기 바랍니다.

5. build.gradle (module: app) 파일에 SDK 의존성 항목을 추가합니다.

   표Kakao i Agent SDK 의존성 항목

   의존성 항목	필수 여부	설명
   com.kakao.i:sdk-android:1.3.5.5	필수	Kakao i 음성 서비스 SDK
   com.kakao.sdk:v2-user:2.8.2	필수	Kakao v2 계정 연동 라이브러리
   com.kakao.i:wakeup-dialoid:1.7.0	선택	Wake-up을 위한 음성 인식 라이브러리 - Wake-up Word(호출명령어)를 통한 Wake-up 구현 시 반드시 추가 필요 - 추가 시 Wake-up Detector 모듈이 자동 생성되며, SDK에 포함된 Dialoid 라이브러리가 사용됨
   com.kakao.sdk:v2-user:2.8.2	선택	음성 인식 결과 화면 라이브러리 - View Template Renderer가 포함되어 있음

6. SDK 최신 버전을 컴파일하기 위해 build.gradle (module: app) 파일의 dependencies {} 섹션에 다음을 추가합니다.

   안내
   Kakao i Agent SDK 의존성 항목은 추가 및 변경될 수 있으므로, 최신 정보는 카카오 i 담당자에게 문의하시기 바랍니다.

   코드예제dependencies 섹션
   Groovy

   dependencies {
     implementation 'com.kakao.sdk:v2-user:2.8.2'
      implementation 'com.kakao.i:sdk-android:1.3.5.5'
    }
   

Manifest 설정하기

사용자 권한을 획득하기 위해서 Android Manifest를 업데이트합니다.

1. Project/…/AndroidManifest.xml 파일을 엽니다.

2. 다음 Manifest 권한 획득 표를 참고하여, 필요한 퍼미션을 업데이트합니다.

   표Manifest 권한 획득

   퍼미션	필수 여부	설명
   android.permission.INTERNET	필수	인터넷 사용을 위한 권한
   android.permission.RECORD_AUDIO	필수	마이크 사용을 위한 권한
   android.permission.READ_CONTACTS	선택	전화 걸기 기능에서 주소록을 읽을 때 필요한 권한
   android.permission.CALL_PHONE	선택	전화 걸기 기능에서 전화를 사용할 때 필요한 권한

   코드예제Manifest Permission

   XML

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.READ_CONTACTS" />
    <uses-permission android:name="android.permission.CALL_PHONE"/>
   

   안내
   Manifest의 Permission 허용에 대한 자세한 설명은 Google Developers 사이트를 참고하시기 바랍니다.