>

资源与概述

GeeGaurd Android SDK 提供给集成 Android 原生客户端开发的开发者使用。

环境要求

条目 资源
开发目标 Android 4.4+
开发环境 Android Studio 4.1
编译工具 gradle (ant 编译请解压提取 jar 和资源文件
系统依赖
SDK 三方依赖

集成

获取 SDK

请联系您的对接人。

导入 SDK

zip 包中的 .aar 文件(包括 geetest_geeguard_android_vx.y.z_date.aar拖拽到工程中的 libs 文件夹下,在拖入 .aarlibs 文件夹后,还要检查.aar是否被添加到Library,要在项目的 build.gradle 下添加如下代码:

repositories {
flatDir {
dirs 'libs'
}
}
`

并且要手动将aar 包添加依赖 (AAR 默认不传递第三方依赖,需要您手动添加):

implementation(name: 'geetest_geeguard_android_vx.y.z_date', ext: 'aar')

添加权限声明

<!--必选-默认申请-->
<uses-permission android:name="android.permission.INTERNET" />
<!--可选-6.0或以上需动态申请(存储日志方便分析报错,日志路径 /sdcard/Android/data/Your PackageName/files/Geetest/captcha_log.txt)-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

配置混淆规则

极验 SDK 已做混淆处理,集成时请带上混淆规则,勿再次混淆 SDK

-dontwarn com.geetest.geeguard.**
-keep class com.geetest.geeguard.**{*;}

调用逻辑

  1. 在后台注册 AppID
  2. 使用 AppID 获取 GeeGuardReceipt

集成代码参考下方的代码示例

代码示例

调用接口

// 您申请的 AppID
private val appId = "123456789012345678901234567890ab"
private lateinit var mCallBackHandler: GeeGuard.CallbackHandler

/**
* 获取 GeeGuardReceipt
*/
fun testFetchGeeGuardReceipt() {
thread {
kotlin.run {
val receipt = GeeGuard.fetchReceipt(context, appId, "业务流水号数据或凭证,用于业务关联")
Log.e("GeeGuard", "GeeToken: ${receipt.geeToken}")
Log.e("GeeGuard", "GeeID: ${receipt.geeID}")
}
}
}

获取结果

将 GeeToken 和业务数据一起提交到业务的服务端, 服务端再向极验设备指纹服务查询结果,请参考服务端API接入文档。