콘텐츠로 이동

Android

Hive SDK Android에서 인증 기능을 사용하기 위한 설정을 안내합니다.

기능 추가

모듈 수준 build.gradle 파일에 해당하는 외부 라이브러리를 추가해야 합니다. 사용할 인증 기능만 추가합니다.

아래는 모듈 수준 build.gradle 파일에 외부 라이브러리를 추가한 예시입니다.

dependencies {
   // 기능별 설정. 사용하는 기능만 추가합니다.
   // AuthV4 기기 관리 서비스
   implementation "com.com2us.android.hive:hive-authv4-device-management"
   // AuthV4 구글 앱 내 업데이트
   implementation "com.com2us.android.hive:hive-authv4-google-inappupdate"
   // AuthV4 구글 reCAPTCHA
   implementation "com.com2us.android.hive:hive-authv4-google-recaptcha"
   // AuthV4 중국 실명 인증
   implementation "com.com2us.android.hive:hive-authv4-real-name-verification"
}

IdP 추가

모듈 수준 build.gradle 파일에 외부 라이브러리를 추가합니다. 사용할 IdP만 추가합니다.

아래는 모듈 수준 build.gradle 파일에 외부 라이브러리를 추가한 예시입니다. 게스트 로그인 기능은 라이브러리를 추가하지 않아도 사용할 수 있습니다.

dependencies {
    // IdP별 설정. 사용하는 IdP만 추가합니다.

    // Apple 로그인
    implementation "com.com2us.android.hive:hive-authv4-provider-apple-signin"

    // Facebook 로그인
    implementation "com.com2us.android.hive:hive-authv4-provider-facebook"

    // Google Play Games 로그인
    // `hive-authv4-provider-google-playgames`는 `play-service-games-v2` 라이브러리를 포함합니다.
    implementation "com.com2us.android.hive:hive-authv4-provider-google-playgames"

    // Google 로그인
    // Google Play Games 로그인과 Google 로그인은 서로 다른 로그인 수단입니다.
    implementation "com.com2us.android.hive:hive-authv4-provider-google-signin"

    // Hive 멤버십 로그인
    implementation "com.com2us.android.hive:hive-authv4-provider-hive-membership"

    // Huawei 로그인
    implementation "com.com2us.android.hive:hive-authv4-provider-huawei"

    // LINE 로그인
    // LINE 라이브러리를 적용하기 위해서는 minSdkVersion 24 이상 버전이 필요합니다.
    implementation "com.com2us.android.hive:hive-authv4-provider-line"

    // QQ 로그인
    implementation "com.com2us.android.hive:hive-authv4-provider-qq"

    // Steam 로그인
    implementation "com.com2us.android.hive:hive-authv4-provider-steam"

    // VK 라이브러리를 적용하기 위해서는 targetSdkVersion 32 이상 버전이 필요합니다.
    implementation "com.com2us.android.hive:hive-authv4-provider-vk"

    // WeChat 로그인
    implementation "com.com2us.android.hive:hive-authv4-provider-wechat"

    // Weverse 로그인
    implementation "com.com2us.android.hive:hive-authv4-provider-weverse"

    // X 로그인
    implementation "com.com2us.android.hive:hive-authv4-provider-x"
}

IdP별 추가 설정

IdP에 따라 추가 설정이 필요합니다.

Google Play Games Sign-in IdP 설정

Google Play Games 로그인을 사용하려면 다음과 같이 설정합니다.

AndroidManifest.xml 설정

Google Play Services를 위한 설정입니다. Google Play Games 로그인 설정에 필요한 값 입니다.

<manifest>
    <application>
    <meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/game_services_project_id"/>
    </application>
</manifest>

hive_config.xml 설정

hive_config.xml에서 <providers> 태그 내에 있는 <google> 태그에서 playAppId와 serverClientId를 설정합니다.

Facebook IdP 설정

Facebook 로그인을 사용하려면 AndroidManifest.xml에 필요한 설정을 합니다.

먼저, 앱에서 링크, 이미지 또는 동영상 공유를 위해 FacebookContentProvider 설정을 합니다. android:authorities 속성 값으로 com.facebook.app.FacebookContentProvider에 Facebook AppID를 붙여서 입력하세요.

예시: FacebookAppID가 123456789일 때

<provider android:authorities="com.facebook.app.FacebookContentProvider123456789" />

Facebook AppId 및 클라이언트 토큰 설정(Facebook v13 이상 필수)을 위해 설정을 추가합니다.

예시: FacebookAppID가 123456789일 때

<meta-data
    android:name="com.facebook.sdk.ApplicationId"
    android:value="fb123456789"/>

예시: Facebook Client Token이 123456789일 때

<meta-data
    android:name="com.facebook.sdk.ClientToken"
    android:value="fb123456789"/>
Note

Facebook AppId 및 클라이언트 토큰은 string.xml 파일로도 설정할 수 있습니다. 이 때, android:value 설정 시 fb 접두사는 필요하지 않습니다. 자세한 내용은 여기에서 확인하세요.

QQ/WeChat IdP 설정

만약 QQ 또는 WeChat IdP를 지원한다면 아래 내용을 추가로 적용합니다.


모듈 수준의 build.gradle 파일에 libs 폴더에 대한 의존성을 설정합니다.

dependencies {
   implementation fileTree(include: ['*.jar'], dir: 'libs')
   implementation fileTree(include: ['*.aar'], dir: 'libs')
}

모듈 수준의 libs 폴더에 Hive SDK 배포 버전에 있는 외부 라이브러리(.aar/.jar)를 추가합니다. 배포 버전에 포함된 외부 라이브러리 목록은 다음과 같습니다.

  • mid-sdk-2.10.jar (QQ IdP 로그인 지원 시 이 파일 추가)
  • mta-sdk-2.0.0.jar (QQ 또는 Wechat IdP 로그인 지원 시 이 파일 추가)
  • open_sdk_3.5.4.11_r3f56456_lite.jar (QQ IdP 로그인 지원 시 이 파일 추가)

VK IdP 설정

  • /res/values/strings.xml 파일에 VK 콘솔에서 발급받은 app id를 설정해주세요.
<integer name="com_vk_sdk_AppId">your_app_id</integer>

Huawei IdP 설정

  1. agconnect-services.json 추가
    • Project 폴더에 Huawei 콘솔에서 다운로드한 agconnect-services.json 파일을 추가해주세요.
  2. Project - build.gradle 파일 설정
    • AppGallery Connect 플러그인과 Maven 주소를 추가해주세요. 
      buildscript {
    repositories {
        google()
        jcenter()
        // Huawei HMS Core SDK.
        maven {url 'https://developer.huawei.com/repo/'}
    }
    dependencies {
        ...
        // Huawei AppGallery Connect plugin
        classpath 'com.huawei.agconnect:agcp:1.9.1.301'
    }
}
allprojects {
    repositories {
        google()
        jcenter()
        /// Huawei HMS Core SDK.
        maven {url 'https://developer.huawei.com/repo/'}
    }
}
  3. App - build.gradle 파일 설정
    • Huawei 인증 라이브러리와 플러그인을 추가해주세요. 
      dependencies {
    // Huawei Dependency
    implementation "com.com2us.android.hive:hive-authv4-provider-huawei" // Huawei 인증
}
apply plugin: 'com.huawei.agconnect'