Skip to main content

Android Configuration

info

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

Custom URL Scheme Setup​

To allow users to launch the app via buttons in KakaoTalk messages, you need to configure a Custom URL Scheme in the AndroidManifest.xml file.

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. You can set keys and values to be passed at the app launch using the androidExecutionParams and iosExecutionParams parameters. When using these parameters, clicking the button in a KakaoTalk shared message will trigger the scheme as shown below.

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

For more detailed information, refer to the Official Documentation.