[Android Studio] 카카오링크 적용하기

 

카카오링크는 2018년 6월 1일부로 정책이 바뀌어 새로운 카카오링크 ver2로 개발을 진행해야 한다.

블로그를 찾아봤지만 카카오링크 ver2에 대해 자세하게 나와있지 않아 처음부터 차근차근 정리해보자!

 

 

 

Step1. 앱 생성

https://developers.kakao.com/docs/android/getting-started#%EC%95%B1-%EC%83%9D%EC%84%B1

Kakao Developers_

해당 사이트에 접속하여서 다음과 같은 순서대로 실행한다.

1. 내 애플리케이션 > 앱 만들기를 통해 앱을 생성합니다.

앱 만들기 결과 완료 화면

 

2. app > resource > value 폴더에 kakao_strings.xml 파일을 생성한다.

해당 파일에 위의 1의 과정을 끝나고 뜨는 완료 화면에서 첫번째 줄인 네이티브 앱키를 kakao_strings.xml 파일에 네이티브 앱키 들어갈 자리에 복사해서 넣는다.

 

kakao_scheme의 경우 앞에 "kakao"글자를 넣고 네이티브 앱키를 붙여넣는다.

kakaoliank_host는 모두 동일하게 kakaolink라고 넣으면 된다.

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name = "kakao_app_key">네이티브 앱키 들어갈 자리</string>
    <string name ="kakao_scheme">kakao네이티브 앱 키 들어갈 자리</string>
    <string name="kakaolink_host">kakaolink</string>
</resources>

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapplication">
 
 
    <uses-permission android:name="android.permission.INTERNET" />
 
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <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>
 
        <meta-data
            android:name="com.kakao.sdk.AppKey"
            android:value="@string/kakao_app_key" />
    </application>
 
</manifest>

 

4. 키해시 등록

카카오 링크 정책이 바뀌어서 키 해쉬값을 필수적으로 입력해주어야한다.

내애플리케이션 > (해당 애플리케이션 선택) > 설정 > 일반 에서 키해시값을 입력해주어야 한다.

출처:  Kakao Develepers

키해시를 알아내는 방법은 여러개가 있지만 제일 간단한 방법을 소개하고자 한다.

헷갈리지 않게 새로운 안드로이드 프로젝트를 아무거나 생성한  Mainactivity.java에 다음 소스코드를 붙혀넣는다.

 

Mainactivity.java

package com.example.myapplication;
 
import androidx.appcompat.app.AppCompatActivity;
 
import android.os.Bundle;
 
import android.content.pm.PackageInfo;
import android.content.pm.PackageManager;
import android.content.pm.Signature;
import android.util.Base64;
import android.util.Log;
 
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
 
public class MainActivity extends AppCompatActivity {
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        getHashKey();
    }
    private void getHashKey(){
        PackageInfo packageInfo = null;
        try {
            packageInfo = getPackageManager().getPackageInfo(getPackageName(), PackageManager.GET_SIGNATURES);
        } catch (PackageManager.NameNotFoundException e) {
            e.printStackTrace();
        }
        if (packageInfo == null)
            Log.e("KeyHash", "KeyHash:null");
 
        for (Signature signature : packageInfo.signatures) {
            try {
                MessageDigest md = MessageDigest.getInstance("SHA");
                md.update(signature.toByteArray());
                Log.d("KeyHash", Base64.encodeToString(md.digest(), Base64.DEFAULT));
            } catch (NoSuchAlgorithmException e) {
                Log.e("KeyHash", "Unable to get MessageDigest. signature=" + signature, e);
            }
        }
    }
}

이후 Android studio의 아래쪽에 logcat 부분에서 ctrl+f 를 누른후 KeyHash를 입력해서 찾으면 KeyHash값을 구할 수 있다.

 

 

Step2. Gradle 수정하기.

1. build.gradle(Project) 수정하기

build.gradle(Project:My application)에 해당 코드를 추가한다.

subprojects {
    repositories {
        mavenCentral()
        maven { url 'http://devrepo.kakao.com:8088/nexus/content/groups/public' }
    }
}

 

2. build.gradle(Module: app)에 해당 코드를 추가한다.

dependencies {
   implementation group: 'com.kakao.sdk', name: 'kakaolink', version:project.KAKAO_SDK_VERSION
}

 

3. gradle.properties에 해당 코드를 추가한다.

#KAKAO_SDK_VERSION=1.1.28
KAKAO_SDK_VERSION=1.12.0

 

Step3. 카카오링크 버튼 만들기

버튼을 눌렀을때 카카오링크가 전송 될 수 있도록 xml 파일에 버튼을 만들어준다.

원하는 xml파일에 9번라인부터 14번라인까지 붙혀넣으면 된다.

 

원하는xml파일.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
    
    <Button
            android:id="@+id/share_lit"
            android:layout_width="150dp"
            android:layout_height="70dp"
            android:onClick="btnClick"
            android:text="카카오톡 공유하기" />
    
</LinearLayout>

 

Step4. 버튼을 만든 xml에 해당하는 java파일 수정

4.1 import 헤더

카카오 링크 ver1과 카카오링크 ver2의 import가 다르기 때문에 잘 확인해야한다.

 

만약 FeedTemplate이나 LinkObect등에서 빨간줄이 쳐진다면 kakao api에 제대로 연결되지 않은것임으로 앞에 과정에서 오류가 있는 것이다.

package com.example.myapplication;
 
import androidx.appcompat.app.AppCompatActivity;
 
import android.os.Bundle;
import android.view.View;
 
import com.example.myapplication.R;
import com.kakao.kakaolink.v2.KakaoLinkResponse;
import com.kakao.kakaolink.v2.KakaoLinkService;
import com.kakao.message.template.ButtonObject;
import com.kakao.message.template.ContentObject;
import com.kakao.message.template.FeedTemplate;
import com.kakao.message.template.LinkObject;
import com.kakao.network.ErrorResult;
import com.kakao.network.callback.ResponseCallback;
 
import java.util.HashMap;
import java.util.Map;
 
 
public class MainActivity extends AppCompatActivity {
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
 
 
    public void btnClick(View view){
 
        FeedTemplate params = FeedTemplate
                .newBuilder(ContentObject.newBuilder("동행_지하철어플리케이션",
                        "https://image.genie.co.kr/Y/IMAGE/IMG_ALBUM/081/191/791/81191791_1555664874860_1_600x600.JPG",
                        LinkObject.newBuilder().setWebUrl("https://developers.kakao.com")
                                .setMobileWebUrl("https://developers.kakao.com").build())
                        .setDescrption("목적지에 후 도착합니다.")
                        .build())
                .addButton(new ButtonObject("웹에서 보기", LinkObject.newBuilder().setWebUrl("https://developers.kakao.com").setMobileWebUrl("https://developers.kakao.com").build()))
                .addButton(new ButtonObject("앱에서 보기", LinkObject.newBuilder()
                        .setWebUrl("https://developers.kakao.com")
                        .setMobileWebUrl("https://developers.kakao.com")
                        .setAndroidExecutionParams("key1=value1")
                        .setIosExecutionParams("key1=value1")
                        .build()))
                .build();
 
        Map<String, String> serverCallbackArgs = new HashMap<String, String>();
        serverCallbackArgs.put("user_id", "${current_user_id}");
        serverCallbackArgs.put("product_id", "${shared_product_id}");
 
 
        KakaoLinkService.getInstance().sendDefault(this, params, new ResponseCallback <KakaoLinkResponse>() {
            @Override
            public void onFailure(ErrorResult errorResult) {}
 
            @Override
            public void onSuccess(KakaoLinkResponse result) {
            }
        });
 
    }
}