Kakao i Agent SDK::iOS::개발 프로세스::iOS 개발 환경 설정

페이지 이동경로

iOS 개발 환경 설정

iOS 버전의 Kakao i Agent SDK를 사용하기 위해 필요한 최소 요구 사양과 설정 항목은 다음과 같습니다.

iOS 버전 Kakao i Agent SDK 최소 요구 사양

  • iOS 10.0 이상
  • iOS Deployment Target 10.0 이상
  • Xcode 13.0 이상
  • Swift 5.5 이상

CocoaPods으로 설치하기

CocoaPods을 통해 간편하게 SDK를 설치할 수 있습니다.

  1. 터미널 창을 열고 다음의 명령어를 실행하여 CocoaPods을 설치합니다.

    • 이미 CocoaPods이 설치되어 있는 경우에는 2번 작업부터 시작하시기 바랍니다.
    sudo gem install cocoapods
    
  2. SDK를 설치하고자 하는 프로젝트 폴더 경로로 이동합니다.

  3. 터미널 창에 다음의 명령을 실행하여 프로젝트의 Podfile을 생성합니다.

    pod init
    
  4. 생성된 Podfile을 열어서 아래와 같이 다음 행을 추가하고 저장합니다.

    target '[프로젝트명]' do
        use_frameworks!
            pod 'KakaoISDK' // KakaoISDK Pod를 추가합니다.
    end
    
  5. 터미널 창에서 다음의 명령을 실행하여 SDK를 설치합니다.

    pod install
    

안내
Kakao i Agent SDK는 외부 라이브러리에 대한 의존성을 갖지 않으며 독립적으로 실행됩니다. 따라서 함께 설치되는 별도의 외부 라이브러리는 존재하지 않습니다.

Info.plist 권한 설정

iOS 버전의 Kakao i Agent SDK를 이용하기 위해서는 권한 설정이 필요합니다. 다음의 권한(Runtime Permission)을 Info.plist에 추가하여, 사용자가 런타임에 각 권한을 승인하도록 요청합니다.
이 설정은 사용자 정보 보호를 위한 OS 정책에 따라 필요한 것으로, 자세한 설명은 Apple Developers 사이트의 앱의 정보 속성 목록 관리 문서를 참고하시기 바랍니다.

Information Property List 권한
권한 필수 여부 설명
Privacy - Contacts Usage Description 선택 전화 걸기 기능을 지원하기 위해 필요한 권한
Privacy - Location Always and When In Use Usage Description 필수 (항상) 사용자의 현재 위치를 기반으로 날씨나 장소정보를 제공하기 위해 필요한 권한
- iOS 11.0 이상 지원 시
Privacy - Location Always Usage Description 필수 (항상) 사용자의 현재 위치를 기반으로 날씨나 장소정보를 제공하기 위해 필요한 권한
- iOS 8.0–10.0 지원 시
Privacy - Location When in Use Usage Description 필수 (앱 사용중) 사용자의 현재 위치를 기반으로 날씨나 장소정보를 제공하기 위해 필요한 권한
Privacy - Microphone Usage Description 필수 마이크를 사용하기 위해 필요한 권한
Privacy - Speech Recognition Usage Description 필수 음성 명령을 입력하는데 필요한 권한

코드예제information Property List Permission

<key>NSContactsUsageDescription</key>
<string>전화 걸기 기능을 지원하기 위해 필요한 권한입니다.</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>사용자의 현재 위치를 기반으로 날씨나 장소정보를 제공하기 위해 필요한 권한입니다. (필수 권한)</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>사용자의 현재 위치를 기반으로 날씨나 장소정보를 제공하기 위해 필요한 권한입니다. (필수 권한)</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>사용자의 현재 위치를 기반으로 날씨나 장소정보를 제공하기 위해 필요한 권한입니다. (필수 권한)</string>
<key>NSMicrophoneUsageDescription</key>
<string>음성명령을 입력하는데 필요한 권한입니다. (필수 권한)</string>
<key>NSSpeechRecognitionUsageDescription</key>
<string>음성명령을 입력하는데 필요한 권한입니다. (필수 권한)</string>

주의
필수 권한을 획득하지 않으면, 카카오 i 음성 인식 서비스를 시작할 수 없습니다.
이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 contact.dkt@kakaocorp.com 으로 제보해주세요.