准备工作

1、客户端SDK接入需要的准备工作

1) 入驻百川，创建应用；

2) 下载客户端SDK，百川SDK下载流程。

注意事项：下载的SDK中，有一张安全图片文件yw_1222.jpg ，在指定路径 res/drawable 下，请勿修改和移动。

2、客户端SDK加入工程

针对不同的开发软件有不同的添加方式，如果都不能正常添加，使用最后的简单粗暴方法。

Eclipse

如果项目IDE为Eclipse，则直接通过属性中的依赖lib工程将客户端SDK依赖进来。

依赖之前导入的SDK

注意：要将AndroidManifest.xml中的内容合并到项目中，可以直接复制，也可以修改project.properties文件的manifestmerger.enabled为true

Android Studio

如果项目IDE为Android Studio并使用Gradle来管理项目，可以在App的build.gradle中依赖SDK，方法如下：

	include ':OneSDK'
	compile project(':AlibabaSDK')	

其次，还需要在客户端SDK的子工程的build.grade中的 sourceSets > main 中加入：

	sourceSets.main {
        jniLibs.srcDir 'libs'
    } 

 

Android Studio直接导入：

1. 打开Android studio，并打开开发的工程

2. 导入Module

File->import module

选择下载好的sdk文件夹，如下图

导入完成后，project目录会增加如下文件夹

3. 添加依赖

选择project，右键，点击open module setting，打开 project structure

选择app，添加 module dependency，如下图

至此，你已经成功完成百川sdk的依赖

 

！如果以上正常方法还没有帮你解决，可以采取最简单粗暴的方法：将客户端SDK中的所有文件拷贝到自己项目工程对应的文件夹中，且AndroidManifest.xml文件内容要合并(主要是application和uses-permission标签下的内容)、项目目录结构要一致。

3、客户端SDK的配置

SDK中的yw_1222.jpg 安全图片需要放置到App工程的res/drawable 目录中，如果没有drawable 目录可以新建一个，且安全图片的文件名称不可修改。 

 

混淆

-keepattributes Signature
-keep class sun.misc.Unsafe { *; }
-keep class com.taobao.** {*;} 
-keep class com.alibaba.** {*;} 
-keep class com.alipay.** {*;} 
-dontwarn com.taobao.**
-dontwarn com.alibaba.**
-dontwarn com.alipay.**
-keep class com.ut.** {*;} 
-dontwarn com.ut.** 
-keep class com.ta.** {*;} 
-dontwarn com.ta.**

示例demo下载

参考：客户端SDK示例demo

使用说明：demo下载后导入IDE中，然后依赖开发者自己下载SDK进行运行(注意demo包含SDK所有功能，所以SDK下载时要选完整功能)

常见问题

初始化不成功开发者经常遇到的情况

1、生成的安全图片和程序的keystore是否一致，这个问题最常见，最好是重新生成apk，新打包SDK试试。

2、SDK包不完整。比如：so文件缺失，AndroidManifest.xml文件不完整，详细检查是相关文件是否都导入到项目中。

3、网络异常。比如：手机没有联网，模拟器网络问题，设置了网络代理等等。

 

 

FAQ

SDK导入很长时间了一直在进行中