사이드 메뉴
Getting started
Kakao Developers
Login
Communication
Advertisement
- Concepts
- Ad creation: Ad account
- Ad creation: Campaign
- Ad creation: Ad group
- Targeting for ad group
- Custom audience targeting for ad group
- Ad creation: Creative common
- Ad creation: Display creative
- Ad creation: Message creative
- Ad creation: Personalized message creative
- Bizboard landing settings
- Report
- Message management
- Personalized message management
- Message ad management
- Message ad operation
- Ad View management
- Business Form+ management
- Business Form linkage management
- Pixel & SDK linkage management
- Audience management
- Engagement targeting management
- Customer file management
- Friend group management
- Ad account management
- Reference
- Type information
- Error code
Android
Migrate v1 to v2
This document guides information to upgrade Kakao SDK for Android("Android SDK") from v1(lower version of 2.0.0) to v2(version 2.0.0 or higher).
The latest Android SDK has a simpler module structure compared to the Legacy Android SDK. The latest Android SDK provides the common module that contains the common and utility features and the Kakao Login function. In addition, each module provides APIs that are grouped by service under Client, and object and structure information is located in Model to make the Android SDK more efficient and convenient.
The token-based APIs refer to the APIs that require an access token through the Kakao Login. To use the token-based APIs in the latest Android SDK, implement Kakao Login that the user module provides.
- Legacy SDK:
- Set an app key in AndroidManifest.xml.
- Call a function that initializes SDK through
KakaoSDK. - Call a function that gets a key hash through
Utilityin thecom.kakao.utilpackage.
- Latest SDK:
- Call a function that initializes SDK by passing a 네이티브 앱 키 through
KakaoSDK. - Call a function that gets a key hash through
Utility.
- Call a function that initializes SDK by passing a 네이티브 앱 키 through
| Name | Legacy SDK | SDK |
|---|---|---|
| Initializing Kakao SDK | init() | init() |
| Getting a key hash | getKeyHash() | getKeyHash() |
- Legacy SDK:
- Call the Login API through
LoginActivity. - Call the Retrieve token information API through
AuthService. - Call the Logout, Unlink, Retrieve user information, and Store user information APIs through
Session. - Call the Retrieve shipping address and the Retrieve consent details for service terms APIs through
UserManagement. - Call the Get consent to desired service terms API through
LoginActivity.
- Call the Login API through
- Latest SDK:
- Call the Kakao Login APIs through
UserApiClientin thev2-usermodule, except for the Check token presence API. - Call the Check token presence API through
AuthApiClient.
- Call the Kakao Login APIs through
| Name | Legacy SDK | SDK |
|---|---|---|
| Checking if Kakao Talk is installed | - | isKakaoTalkLoginAvailable() |
| Login with Kakao Talk | - | loginWithKakaoTalk(context) |
| Login with Kakao Account | - | loginWithKakaoAccount(context) |
| Check token presence | isOpened() | hasToken() |
| Logout | requestLogout() | logout() |
| Unlink | requestUnlink() | unlink() |
| Retrieve token information | requestAccessTokenInfo() | accessTokenInfo() |
| Retrieve user information | me() | me() |
| Retrieve shipping address | shippingAddresses() | shippingAddresses() |
| Store user information | requestUpdateProfile(properties) | updateProfile() |
| Request additional consent | updateScopes(scopes) | loginWithNewScopes(context, scopes) |
| Retrieve consent details for service terms | serviceTerms() | serviceTerms() |
| Get consent to desired service terms | - | loginWithKakaoTalk(context, serviceTerms) loginWithKakaoAccount(context, serviceTerms) |
- Legacy SDK: Call the Kakao Talk Social APIs through
KOSessionTask. - Latest SDK: Call the Kakao Talk Social APIs through
TalkApiClientin thev2-talkmodule.
| Name | Legacy SDK | SDK |
|---|---|---|
| Retrieve Kakao Talk profile | requestProfile() | profile() |
| Retrieve list of friends | requestAppFriends() | friends() |
- Legacy SDK:
- Call the Kakao Talk Share APIs through
KakaoLinkService. - If Kakao Talk is not installed on a user's device, a message is internally sent through a WebView.
- Call the Kakao Talk Share APIs through
- Latest SDK:
- Call the Kakao Talk Share APIs through
ShareClientin thev2-sharemodule. - Pass
contextfor the Send message API. - If Kakao Talk is not installed on a user's device, implement a process to share URI through a WebView or a default browser.
- Call the Kakao Talk Share APIs through
Note
In Android SDK 2.11.0, the names of the module, classes, and methods related to Kakao Talk Share have been changed due to the change of its service name.
To see more detailed changes, see Version history.
| Name | Legacy SDK | SDK |
|---|---|---|
| Checking if Kakao Talk is installed | - | isKakaoTalkSharingAvailable() |
| Sending with default template | sendDefault(template) | shareDefault(context, defaultFeed) |
| Sending with custom template | sendCustomWithTemplateId(templateId) | shareCustom(context, templateId) |
| Sending a scrap message | sendScrapWithURL(url) | shareScrap(context, url) |
| Uploading an image | uploadImage(imageFile) | uploadImage(file) |
| Scraping an image | scrapWithImageURL:imageURL: | scrapImage(url) |
- Legacy SDK: Call the Kakao Talk APIs through
KakaoTalkService. - Latest SDK: Call the Kakao Talk APIs through
TalkApiClientin thev2-talkmodule.
| Name | Legacy SDK | SDK |
|---|---|---|
| Sending me with default template | requestSendMemo(template) | sendDefaultMemo(template) |
| Sending me with custom template | requestSendMemo() | sendCustomMemo(templateId) |
| Sending me a scrap message | requestSendMemo(url) | sendScrapMemo(url) |
| Sending friends with default template | sendMessageToFriends(template, uuids) | sendDefaultMessage(template, receiverUuids) |
| Sending friends with custom template | sendMessageToFriends(templateId, uuids) | sendCustomMessage(templateId, receiverUuids) |
| Sending friends a scrap message | sendMessageToFriend(url, uuids) | sendScrapMessage(url, receiverUuids) |
- Legacy SDK:
- Call the Add Kakao Talk Channel and Kakao Talk Channel chat APIs through
PlusFriendService. - Call the Check Kakao Talk Channel relationship API through
KakaoTalkService.
- Call the Add Kakao Talk Channel and Kakao Talk Channel chat APIs through
- Latest SDK:
- Call the Add Kakao Talk Channel and Kakao Talk Channel chat APIs through
TalkApiClientin thev2-talkmodule. - Call the Check Kakao Talk Channel relationship API after implementing Kakao Login.
- Call the Add Kakao Talk Channel and Kakao Talk Channel chat APIs through
| Name | Legacy SDK | SDK |
|---|---|---|
| Add Kakao Talk Channel | addFriend(plusFriendId) | addChannelUrl(channelPublicId) |
| Starting Kakao Talk Channel chat | chat(plusFriendId) | channelChatUrl(channelPublicId) |
| Check Kakao Talk Channel relationship | requestPlusFriends() | channels() |
- Legacy SDK:
- Call the Navi APIs through
KakaoNaviService. - Call
newBuilder()of each class andsetNaviOptions()to set parameters.
- Call the Navi APIs through
- Latest SDK:
- Call the Navi APIs through
NaviClientin thev2-navimodule. - Define the constructor for each class to set parameters.
- Call the Navi APIs through
| Name | Legacy SDK | SDK |
|---|---|---|
| Navigation | navigate(destination) | navigateIntent(location, naviOption) |
| Getting URL for navigation | - | Deprecated navigateWebUrl(location, naviOption) |
| Sharing location | shareDestination(destination) | shareDestinationIntent(location, naviOption) |
| Setting conditions for navigation | newBuilder() setNaviOptions(options) | NaviOption() |
| Setting conditions for destination information | newBuilder() setNaviOptions(options) | Location() |
- Latest SDK: Not support Push Notification API. Push notifications is available with REST API.
| Name | Legacy SDK | SDK |
|---|---|---|
| Register push token | registerPushToken(pushToken, deviceId) | - |
| Retrieve push token | getPushTokens() | - |
| Delete push token | deregisterPushToken(deviceId) | - |