目录

• 一、 环境与开发资料
  • 1、环境需求
  • 2、相关开发资料
• 二、准备工作
  • 1、创建应用
  • 2、快速体验 Demo
  • 3、开发环境搭建
    • 3.1、gradle 集成
    • 3.2、手动集成

一、环境与开发资料

1、环境需求

条目	资源
开发目标	移动/电信支持 Android 4.0 以上，联通支持 Android 5.0 以上
开发环境	Android Studio 2.1.3
SDK 三方依赖	com.cmic.sso.sdk、com.unicom、cn.com.chinatelecom.account.api
包增量	0.83M
网络制式	移动 2G/3G/4G，联通 3G/4G，电信 4G（2G/3G 网络下时延相对较高，成功率相对较低）
网络环境	打开蜂窝数据流量并且给予应用蜂窝数据权限

2、相关开发资料

条目	资源
产品结构流程	系统交互流程
常见问题	常见问题
SDK 资源包	点击下载

二、准备工作

1、创建应用

登录控制台创建应用获取APPID，具体步骤可参照产品使用指南。

2、快速体验 Demo

Android 压缩包附带的 demo 文件夹中是金山云的示例工程，使用 Android Studio 打开示例工程，直接运行起来即可进行快速体验测试。

如果开发者需要将 SDK 集成到自己的项目进行体验，可完成以下配置步骤进行本地测试：

1. 将包名修改成对应的测试包名；
2. 将签名配置改成您的签名配置；
3. 将APPID换成您在金山云管理后台创建生成的信息(需注意APPID和包名/包签名的一致性);
4. 参照服务端接入文档完成服务端接口的对接。如未完成该步骤则仅能体验APP端功能，不能获取真实手机号。

3、开发环境搭建

3.1、手动集成

导入 SDK 到项目工程并配置开发环境

1. 在sdk目录下，将获取的.aar文件拖拽到工程中的 libs 文件夹下。

2. 在拖入.aar到 libs 文件夹后，还要检查.aar是否被添加到Library，要在项目的 build.gradle 下添加如下代码：

repositories {
flatDir {
dirs 'libs'
}
}

3. 手动将aar包添加依赖：

implementation(name: 'ksc_onelogin_android_vx.y.z', ext: 'aar')

4. 混淆配置：

SDK 的 aar 包已做混淆处理，两次混淆会导致不可预期的错误，默认情况下 aar 包内包含当前 SDK 的混淆配置，远端依赖或者本地 aar 依赖都能确保 SDK 不被二次混淆。如有解压 aar 包单独集成 jar 与 资源文件的需求，请务必将解压目录中的proguard.txt文件内容拷贝到应用的混淆配置中，跳过对 SDK 的二次混淆操作。