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를 설치할 수 있습니다.
-
터미널 창을 열고 다음의 명령어를 실행하여 CocoaPods을 설치합니다.
- 이미 CocoaPods이 설치되어 있는 경우에는 2번 작업부터 시작하시기 바랍니다.
sudo gem install cocoapods
-
SDK를 설치하고자 하는 프로젝트 폴더 경로로 이동합니다.
-
터미널 창에 다음의 명령을 실행하여 프로젝트의 Podfile을 생성합니다.
pod init
-
생성된 Podfile을 열어서 아래와 같이 다음 행을 추가하고 저장합니다.
target '[프로젝트명]' do use_frameworks! pod 'KakaoISDK' // KakaoISDK Pod를 추가합니다. end
-
터미널 창에서 다음의 명령을 실행하여 SDK를 설치합니다.
pod install
안내
Kakao i Agent SDK는 외부 라이브러리에 대한 의존성을 갖지 않으며 독립적으로 실행됩니다. 따라서 함께 설치되는 별도의 외부 라이브러리는 존재하지 않습니다.
Info.plist 권한 설정
iOS 버전의 Kakao i Agent SDK를 이용하기 위해서는 권한 설정이 필요합니다. 다음의 권한(Runtime Permission)을 Info.plist에 추가하여, 사용자가 런타임에 각 권한을 승인하도록 요청합니다.
이 설정은 사용자 정보 보호를 위한 OS 정책에 따라 필요한 것으로, 자세한 설명은 Apple Developers 사이트의 앱의 정보 속성 목록 관리 문서를 참고하시기 바랍니다.
권한 | 필수 여부 | 설명 |
---|---|---|
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 음성 인식 서비스를 시작할 수 없습니다.