Android

Hive SDK Android 认证配置指南

添加功能¶

您必须将相应的外部库添加到模块级的 build.gradle 文件中。仅添加您将使用的身份验证功能。

以下是将外部库添加到模块级build.gradle文件的示例。

dependencies {
   // Feature-specific settings. Add only the features you are using.
   // AuthV4 Device Management Service
   implementation "com.com2us.android.hive:hive-authv4-device-management"
   // AuthV4 Google In-App Update
   implementation "com.com2us.android.hive:hive-authv4-google-inappupdate"
   // AuthV4 Google reCAPTCHA
   implementation "com.com2us.android.hive:hive-authv4-google-recaptcha"
   // AuthV4 Real Name Verification (China)
   implementation "com.com2us.android.hive:hive-authv4-real-name-verification"
}

添加身份提供者¶

将外部库添加到模块级别的 build.gradle 文件中。仅添加您将使用的 IdP。

以下是将外部库添加到模块级build.gradle文件的示例。您可以在不添加任何库的情况下使用访客登录功能。

dependencies {
    // IdP-specific settings. Add only the IdPs you are using.

    // Apple Login
    implementation "com.com2us.android.hive:hive-authv4-provider-apple-signin"

    // Facebook Login
    implementation "com.com2us.android.hive:hive-authv4-provider-facebook"

    // Google Play Games Login
    // `hive-authv4-provider-google-playgames` includes the `play-service-games-v2` library.
    implementation "com.com2us.android.hive:hive-authv4-provider-google-playgames"

    // Google Login
    // Google Play Games Login and Google Login are different login methods.
    implementation "com.com2us.android.hive:hive-authv4-provider-google-signin"

    // Hive Membership Login
    implementation "com.com2us.android.hive:hive-authv4-provider-hive-membership"

    // Huawei Login
    implementation "com.com2us.android.hive:hive-authv4-provider-huawei"

    // LINE Login
    // To apply the LINE library, minSdkVersion 24 or higher is required.
    implementation "com.com2us.android.hive:hive-authv4-provider-line"

    // QQ Login
    implementation "com.com2us.android.hive:hive-authv4-provider-qq"

        // Steam Login
        implementation "com.com2us.android.hive:hive-authv4-provider-steam"

    // VK library requires targetSdkVersion 32 or higher.
    implementation "com.com2us.android.hive:hive-authv4-provider-vk"

    // WeChat Login
    implementation "com.com2us.android.hive:hive-authv4-provider-wechat"

    // Weverse Login
    implementation "com.com2us.android.hive:hive-authv4-provider-weverse"
}

由 IdP 提供的附加设置¶

根据身份提供者（IdP），需要额外的设置。

Google Play 游戏登录 IdP 设置¶

要使用 Google Play 游戏登录，请按如下方式进行配置。

AndroidManifest.xml 设置¶

这是Google Play服务的配置。这些是Google Play游戏登录设置所需的值。

<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 属性中，将 Facebook AppID 添加到 com.facebook.app.FacebookContentProvider。

示例：当 Facebook AppID 为 123456789

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

添加 Facebook AppId 和客户端令牌设置（Facebook v13 或更高版本所需）。

示例：当 Facebook AppID 为 123456789 时

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

示例：当 Facebook 客户端令牌为 123456789

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

Note

Facebook AppId 和客户端令牌也可以在 string.xml 文件中设置。在这种情况下，设置 android:value 时不需要 fb 前缀。有关更多信息，请参见 here。

QQ/Wechat IdP 设置¶

如果您支持 QQ 或 WeChat IdP，请另外应用以下内容。

在模块级build.gradle文件中设置对libs文件夹的依赖。

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

将外部库 (.aar/.jar) 添加到模块级的 libs 文件夹中，以便与 Hive SDK 发行版本相结合。发行版本中包含的外部库列表如下。

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控制台发出的应用程序ID。

<integer name="com_vk_sdk_AppId">your_app_id</integer>

华为 IdP 设置¶

添加 agconnect-services.json
- 将从华为控制台下载的 agconnect-services.json 文件添加到项目文件夹中。

项目 - build.gradle 文件设置

添加 AppGallery Connect 插件和 Maven 地址。

buildscript {
    repositories {
        google()
        jcenter()
        // 华为 HMS Core SDK。
        maven {url 'https://developer.huawei.com/repo/'}
    }
    dependencies {
        ...
        // 华为 AppGallery Connect 插件
        classpath 'com.huawei.agconnect:agcp:1.9.1.301'
    }
}
allprojects {
    repositories {
        google()
        jcenter()
        /// 华为 HMS Core SDK。
        maven {url 'https://developer.huawei.com/repo/'}
    }
}

应用 - build.gradle 文件设置

添加华为认证库和插件。

dependencies {
    // 华为依赖
    implementation "com.com2us.android.hive:hive-authv4-provider-huawei" // 华为认证
}
apply plugin: 'com.huawei.agconnect'