Kakao i Agent SDK::Android::개발 프로세스::Android Studio 설정

페이지 이동경로

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 설정

    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 추가

    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 접근 가능 시)

    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 접근 불가능 시)

    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 섹션

    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

     <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 사이트를 참고하시기 바랍니다.
이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 documentation@kakaoenterprise.com 으로 제보해주세요.