Android 설정

정보

Expo를 사용한다면 이 문서는 건너뛰어야 합니다.

커스텀 URL 스킴 설정

사용자가 카카오톡 메시지의 버튼을 통해 앱을 실행할 수 있도록 하려면 AndroidManifest.xml 파일에 커스텀 URL 스킴(Custom URL Scheme) 설정을 해야 합니다.

Android 12(API 31) 이상을 타깃으로 하는 앱은 exported 요소를 반드시 true로 선언해야 합니다. 다음 예제를 참고합니다.

AndroidManifest.xml

<activity
    android:name=".${YOUR_ACTIVITY_NAME}"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <!-- "kakao${YOUR_NATIVE_APP_KEY}://kakaolink" 형식의 앱 실행 스킴을 설정하는데 사용 -->
        <data android:host="kakaolink"
                android:scheme="kakao${YOUR_NATIVE_APP_KEY}" />
    </intent-filter>
</activity>

앱 실행 시 추가 정보 전달

네이티브 앱에서는 커스텀 URL 스킴으로 앱을 실행할 때 서비스에 필요한 추가 정보를 전달할 수 있습니다. androidExecutionParams, iosExecutionParams 파라미터로 앱 실행 시 전달할 키와 값을 설정할 수 있습니다. 이 파라미터를 사용하면 카카오톡 공유 메시지에서 앱 실행 버튼을 눌렀을 때 아래 스킴이 호출됩니다.

kakao${YOUR_NATIVE_APP_KEY}://kakaolink?${androidExecutionParams}
kakao${YOUR_NATIVE_APP_KEY}://kakaolink?${iosExecutionParams}
// 예시
kakao${YOUR_NATIVE_APP_KEY}://kakaolink?key1=value1&key2=value2&key3=value3

노트

더 자세한 내용은 공식 문서를 참고하세요.