Skip to main content

Android Configuration

info

If you are using Expo, you can skip this document.

Custom URL Scheme Setup​

To let users launch the app from buttons in KakaoTalk messages, you must configure a custom URL scheme in AndroidManifest.xml.

For apps targeting Android 12 (API 31) or higher, the exported element must be declared as true. Refer to the example below.

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" />

        <!-- Set up the app execution scheme in the form "kakao${YOUR_NATIVE_APP_KEY}://kakaolink" -->
        <data android:host="kakaolink"
                android:scheme="kakao${YOUR_NATIVE_APP_KEY}" />
    </intent-filter>
</activity>

Passing Additional Information at App Launch​

For native apps, additional information can be passed at app launch through the custom URL scheme. Use the androidExecutionParams and iosExecutionParams parameters to set the keys and values passed at launch. With these parameters, tapping the app launch button in a KakaoTalk shared message calls the scheme shown below.

kakao${YOUR_NATIVE_APP_KEY}://kakaolink?key1=value1&key2=value2&key3=value3
note

For details, refer to the Official Documentation.