이 문서는 기존에 멀티 앱 기능을 사용 중이며, 앱 설정을 유지해야만 하는 경우를 위한 참고용 안내입니다.

멀티 앱은 하나의 네이티브 앱 키에 여러 개의 네이티브 앱 정보를 추가 등록하여, 하나의 카카오디벨로퍼스 앱 정보와 네이티브 앱 키로 Kakao SDK를 연동할 수 있게 해주는 기능입니다. 아래와 같은 경우에 사용합니다.

이 문서는 이해를 돕기 위하여 아래와 같은 용어를 사용합니다.

앱 관리 페이지의 [앱] > [플랫폼 키] > [네이티브 앱 키]에서 각 네이티브 앱 정보를 추가 설정하여 멀티 앱을 사용할 수 있습니다. 아래 플랫폼별 가이드를 참고하여 멀티 패키지 및 멀티 번들 ID를 설정합니다.

• Android
• iOS

멀티 앱 사용 권한을 받으면 앱 관리 페이지의 [앱] > [플랫폼 키] > [네이티브 앱 키]에서 [멀티 패키지명]과 [멀티 스토어 URL]을 설정할 수 있습니다. 아래를 참고하여 각 항목을 설정합니다.

Android 멀티 앱 설정 화면

[A] 패키지명: 메인 앱의 패키지명 입력
[B] 멀티 패키지명: 각 서브 앱의 패키지명 입력, 줄넘김으로 구분하여 여러 개 입력 가능
[C] 스토어 URL: 메인 앱을 다운로드할 수 있는 스토어 URL 입력
[D] 멀티 스토어 URL: 각 서브 앱을 다운로드할 수 있는 스토어 URL 입력, [추가] 버튼을 눌러 스토어 URL 추가 입력 가능
[E] 키 해시: 줄넘김으로 구분하여 여러 개 입력 가능, 키 해시 등록 참고

멀티 앱 사용 권한을 받으면 앱 관리 페이지의 [앱] > [플랫폼 키] > [네이티브 앱 키]에서 [멀티 번들 ID]와 [멀티 스토어 URL]을 설정할 수 있습니다. 아래를 참고하여 각 항목을 설정합니다.

iOS 멀티 앱 설정 화면

[A] 번들 ID: 메인 앱의 번들 ID 입력
[B] 멀티 번들 ID: 각 서브 앱의 번들 ID 입력, 줄넘김으로 구분하여 여러 개 입력 가능
[C] iOS 앱, iPad 앱: 메인 앱을 다운로드할 수 있는 스토어 URL 입력
[D] 멀티 스토어 URL: 각 서브 앱을 다운로드할 수 있는 스토어 URL 입력, [추가] 버튼을 눌러 스토어 URL 추가 입력 가능

Kakao SDK로 카카오 로그인 사용 시, 커스텀 URL 스킴을 설정해야 합니다. 커스텀 URL 스킴은 사용자가 카카오톡으로 로그인한 후 서비스의 각 네이티브 앱으로 돌아가거나, 메시지의 앱 링크로 네이티브 앱을 실행할 때 사용됩니다.

멀티 앱 설정으로 멀티 패키지명 및 멀티 번들 ID를 등록한 후, 각 네이티브 앱에 설정해야 할 커스텀 URL 스킴 값을 확인할 수 있습니다. 아래 플랫폼별 가이드에 따라 각 네이티브 앱에 커스텀 URL 스킴을 설정합니다.

• Android
• iOS

앱 관리 페이지의 [앱] > [플랫폼 키] > [네이티브 앱 키]의 [스킴] 목록에서 각 네이티브 앱의 패키지명에 해당하는 커스텀 URL 스킴을 찾아 [복사] 버튼을 눌러 복사합니다.

복사한 커스텀 URL 스킴 값을 각 네이티브 앱의 AndroidManifest.xml에 추가합니다. 아래 예제를 참고하여 카카오 로그인, 카카오톡 공유 중 사용하는 기능의 커스텀 URL 스킴을 각각 추가해야 합니다.

<activity android:name="com.kakao.sdk.auth.AuthCodeHandlerActivity">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <!-- 카카오 로그인 리다이렉트 URI: "${COPIED_CUSTOM_SCHEME}://oauth" -->
        <data android:host="oauth" android:scheme="${COPIED_CUSTOM_SCHEME}" />
        <!-- 카카오톡 공유: "${COPIED_CUSTOM_SCHEME}://kakaolink -->
        <data android:host="kakaolink" android:scheme="${COPIED_CUSTOM_SCHEME}" />
        <!-- 카카오톡 채널 간편 추가: "${COPIED_CUSTOM_SCHEME}://channel" -->
        <data android:host="channel" android:scheme="${COPIED_CUSTOM_SCHEME}" />
        <!-- 배송지 피커: "${COPIED_CUSTOM_SCHEME}://address" -->
        <data android:host="address" android:scheme="${COPIED_CUSTOM_SCHEME}" />
    </intent-filter>
</activity>

iOS의 경우, 두 가지 설정이 필요합니다.

• URL Schemes
• 앱 실행 허용 목록

앱 관리 페이지의 [앱] > [플랫폼 키] > [네이티브 앱 키]의 [스킴] 목록에서 각 네이티브 앱의 번들 ID에 해당하는 커스텀 URL 스킴을 찾아 [복사] 버튼을 눌러 복사합니다.

각 네이티브 앱의 [Target] > [Info] > [URL Types] > [URL Schemes]에 복사한 커스텀 URL 스킴을 추가합니다.

iOS URL Schemes 설정 화면

각 네이티브 앱에서 카카오 로그인 및 카카오톡 공유를 사용하기 위해 앱 실행 허용 목록(Allowlist)을 등록해야 합니다. 설정을 참고해 카카오 로그인과 카카오톡 공유 중 사용하는 기능의 LSApplicationQueriesSchemes 설정을 추가합니다.

Flutter의 경우, Android와 iOS 설정이 모두 필요합니다.

• Android
• iOS

멀티 앱 사용 시, 각 네이티브 앱에서 Kakao SDK를 초기화할 때 추가 파라미터로 커스텀 URL 스킴 설정에서 설정했던 커스텀 URL 스킴 값을 customScheme 파라미터로 전달해야 합니다.

KakaoSdk.init(
    context,
    appKey = "${NATIVE_APP_KEY}",
    customScheme = "${COPIED_CUSTOM_SCHEME}"
)

멀티 앱을 사용하면 메인 앱과 서브 앱 모두 메시지의 앱 링크에 설정할 수 있습니다. 메시지에 설정 가능한 앱 링크의 종류는 아래와 같습니다.

• 메시지 콘텐츠의 이미지, 텍스트, 버튼 등 구성 요소별 앱 링크
• 출처 앱 정보의 앱 링크

[도구] > [메시지 템플릿]에서 앱의 사용자 정의 템플릿을 등록할 수 있습니다. 멀티 앱을 사용할 경우, 해당 메뉴에서 멀티 앱의 커스텀 URL 스킴 및 스토어 URL을 메시지의 앱 링크에 원하는 대로 설정할 수 있습니다.

예를 들어, 서비스의 멀티 앱 중 '가' 네이티브 앱에서 보내는 메시지에는 '가' 네이티브 앱의 링크를 설정하고, '나' 네이티브 앱에서 보내는 메시지에는 '나' 네이티브 앱의 링크를 설정할 수 있습니다. 메시지 템플릿의 일부 구성 요소에만 다른 네이티브 앱의 링크를 설정할 수도 있습니다.

자세한 내용은 메시지 템플릿 도구를 참고합니다.

멀티 앱은 사용 권한이 주어진 앱에서만 사용할 수 있습니다. 실제 서비스에서 기능을 사용하려면 앱 관리 페이지의 [앱] > [추가 기능 신청]에서 사용 권한을 신청해야 합니다.

사용 권한 신청 시, 앱이 아래 조건을 만족해야 합니다.

• 카카오 로그인 또는 카카오싱크 사용
• 두 개 이상의 네이티브 앱을 운영 중이거나, 운영할 예정
• 서비스 중인 웹, 앱이 통합회원 사용