[AOS] Android KakaoLink 카카오톡 공유하기 2 - Kakao Link 설정

 

 

🐱

개발환경 준비되었으면 개발 들어가볼까요?

네! (카카오톡 문서만 있으면 어디든 두렵지않아...)

🐶

 

 

 

 

 

카카오 링크 구현 이전, 초기 설정이 필요하다.

 

초기 설정

[AOS] Android KakaoLink 카카오톡 공유하기 1 - 초기 설정

 

 

카카오 링크 구현 관련 개발 문서는 다음과 같다.

 

카카오 링크 개발 문서

Kakao Developers

 

 

 

1. kakao link 키 및 스킴 정의

strings.xml에 다음과 같이 카카오 키와 스킴을 정의한다.

스킴의 경우 카카오 앱 키 앞에 "kakao" 글자를 추가한 형태이다.

<resources>
    <!-- kakao link setting -->
    <string name="kakao_app_key">카카오 앱 키를 넣으세요</string>
    <string name="kakao_scheme">kakao카카오 앱 키를 넣으세요</string>
    <string name="kakaolink_host">kakaolink</string>
</resources>

 

키의 경우 Kakao Developers에 등록한 앱의 네이티브 앱 키를 이용하면 된다.

 

2. AndroidManifest.xml에 kakao 스킴 정의

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.nezhitsya.example">

    <!-- 인터넷 사용 권한 설정-->
    <uses-permission android:name="android.permission.INTERNET" />

    <application
        ...>
        <activity
            android:name=".view.MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            
            <!-- 카카오 스킴 설정-->
            <intent-filter>
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />

                <data android:scheme="@string/kakao_scheme"
                    android:host="@string/kakaolink_host" />
            </intent-filter>
        </activity>
    </application>

</manifest>

 

 

3. 초기화

가장 먼저 실행되는 Activity나 Application을 상속한 클래스의 onCreate() 함수에 아래와 같이 초기화한다.

override fun onCreate() {
    super.onCreate()

    Log.d("debug hash key", Utility.getKeyHash(this))

    // 카카오 링크 초기화
    KakaoSdk.init(this, resources.getString(R.string.kakao_app_key))
}

 

 

4. 메시지 템플릿 선택하기

 

 

 

5. 기존 메시지 템플릿을 이용해 구현하기

val defaultFeed = FeedTemplate(
    content = Content(
        title = "타이틀",
        description = "설명~~~~~~~~",
        imageUrl = "https://mud-kage.kakao.com/dn/Q2iNx/btqgeRgV54P/VLdBs9cvyn8BJXB3o7N8UK/kakaolink40_original.png",
        link = Link(
            webUrl = "https://developers.kakao.com",
            mobileWebUrl = "https://developers.kakao.com"
        )
    ),
    buttons = listOf(
        Button(
            "웹으로 보기",
            Link(
                webUrl = "https://developers.kakao.com",
                mobileWebUrl = "https://developers.kakao.com"
            )
        ),
        Button(
            "앱으로 보기",
            Link(
                androidExecutionParams = mapOf("key1" to "value1", "key2" to "value2"),
                iosExecutionParams = mapOf("key1" to "value1", "key2" to "value2")
            )
        )
    )
)

 

FeedTemplate를 이용한 구현.

공식 문서에 나와있는 예시에서 itemContent와 social은 필수 구현 항목이 아니므로 content와 button만으로 구성해 간단하고 심플한 template 구현이 가능하다.

 

 

6. 공유 버튼 눌렀을 때 kakaolink 실행 구현하기

btn.setOnClickListener {
    // 카카오톡 설치여부 확인
    if (ShareClient.instance.isKakaoTalkSharingAvailable(context)) {    
        // 카카오톡으로 카카오톡 공유 가능
        ShareClient.instance.shareDefault(context, defaultFeed) { sharingResult, error ->
            if (error != null) {
                Log.e(TAG, "카카오톡 공유 실패", error)
            }
            else if (sharingResult != null) {
                Log.d(TAG, "카카오톡 공유 성공 ${sharingResult.intent}")
                startActivity(sharingResult.intent)

                // 카카오톡 공유에 성공했지만 아래 경고 메시지가 존재할 경우 일부 컨텐츠가 정상 동작하지 않을 수 있습니다.
                Log.w(TAG, "Warning Msg: ${sharingResult.warningMsg}")
                Log.w(TAG, "Argument Msg: ${sharingResult.argumentMsg}")
            }
        }
    } else {
        // 카카오톡 미설치: 웹 공유 사용 권장
        // 웹 공유 예시 코드
        val sharerUrl = WebSharerClient.instance.makeDefaultUrl(defaultFeed)

        // CustomTabs으로 웹 브라우저 열기

        // 1. CustomTabsServiceConnection 지원 브라우저 열기
        // ex) Chrome, 삼성 인터넷, FireFox, 웨일 등
        try {
            KakaoCustomTabsClient.openWithDefault(context, sharerUrl)
        } catch(e: UnsupportedOperationException) {
            // CustomTabsServiceConnection 지원 브라우저가 없을 때 예외처리
        }

        // 2. CustomTabsServiceConnection 미지원 브라우저 열기
        // ex) 다음, 네이버 등
        try {
            KakaoCustomTabsClient.open(context, sharerUrl)
        } catch (e: ActivityNotFoundException) {
            // 디바이스에 설치된 인터넷 브라우저가 없을 때 예외처리
        }
    }
}

 

 

 

위의 설정한 template를 이용해 공유된 모습