• Android SDK 新版
  • Android SDK 旧版

1、点击下载最新SDK(当前版本3.0.3),并解压fraudmetrix-xxx.zip文件。解压后文件目录为:

  • fm-core-xxx
  • libs
    • fm-sdk-xxx.jar
    • armeabi
  • 注:同盾Android SDK支持Android 2.2(API Level 8)及以上系统。
  • 同盾Android SDK默认只提供armeabi架构的so,如果您的应用需要支持其他的cpu架构,
    或者已经存在其他架构的第三方so,则需要将对应的架构也引入工程中,否则将可能引起设备指纹获取异常、crash等未知问题。

点击下载fraudmetrix-cpuabi-xxx.zip,该文件包含:

  • armeabi-v7a
  • arm64-v8a
  • x86
  • x86_64
  • mips

2、导入设备指纹SDK。
     Eclipse环境下:
     

  • libs目录中的fm-sdk-xxx.jar拷贝到libs目录下;
  • armeabi文件夹拷贝到libs目录下(如果您需要支持其他cpu架构,请一并拷贝)
  • fm-core-xxx拷贝到本地工程assets目录下
  • 在Eclipse中右键工程根目录,选择Properties -> Java Build Path -> Libraries,然后点击Add JARs...选择指向jar的路径,并且在Order and Export中勾选fm-sdk-xxx.jar,最后点击OK,即导入成功。(最新的ADT工具会自动导入libs目录下的jar包,故该步骤可以省略)

Android Studio/IDEA环境下:
     方式1:默认jni目录
     

  • libs目录中的fm-sdk-xxx.jar拷贝到本地工程/app/libs子目录下;
  • armeabi拷贝到/app/src/main/jniLibs/目录下(如果您需要支持其他cpu架构,请一并拷贝)
  • fm-core-xxx拷贝到本地工程/app/src/main/assets/目录下

方式2:定义jni目录
     

  • libs目录中的fm-sdk-xxx.jar拷贝到本地工程/app/libs子目录下;
  • armeabi文件夹拷贝到/app/libs目录下(如果您需要支持其他cpu架构,请一并拷贝)
  • 将目录中的fm-core-xxx拷贝到本地工程/app/src/main/assets/目录下
  • 修改module下的build.gradle,添加以下部分代码:
复制代码

 
 
 
 
 
1
apply plugin: 'com.android.application'
2
3
android {
4
    //******* 其他配置 ********//
5
    //配置SO文件
6
    sourceSets {
7
        main {
8
            jniLibs.srcDirs = ['libs']
9
        }
10
    }
11
}
12
13
dependencies {
14
    //导入sdk
15
    compile fileTree(include: ['*.jar'], dir: 'libs')
16
    testCompile 'junit:junit:4.12'
17
    compile 'com.android.support:appcompat-v7:23.2.0'
18
}
 
 

3、配置AndroidManifest.xml文件
     manifest的配置主要包括添加权限,声明合作方标识(PARTNER_CODE)两部分,代码示例如下:

复制代码

 
 
 
 
 
1
<manifest>
2
    <uses-sdk android:minSdkVersion="8"/>
3
    <!-- 必选权限 -->
4
    <uses-permission android:name="android.permission.INTERNET" />
5
    <uses-permission android:name="android.permission.BATTERY_STATS" />
6
    <uses-permission android:name="android.permission.BLUETOOTH" />
7
    <uses-permission android:name="android.permission.WRITE_SETTINGS"/>
8
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
9
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
10
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
11
    <!-- 可选权限,不声明此部分权限将放弃部分设备信息的采集,对数据分析及设备指纹的精准度有一定影响 -->
12
    <uses-permission android:name="android.permission.GET_TASKS" />
13
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
14
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
15
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
16
    <uses-permission android:name="android.permission.ACCESS_COARSE_UPDATES"/>
17
    <application>
18
        <!-- 您的合作方标识 -->
19
        <meta-data android:name="PARTNER_CODE" android:value="xxx" />
20
        <!-- !!!注意!!! 如果您从同盾SDK 1.x 版本升级到 2.x,请将 1.x 中的FMUDID_service声明删除 !!!注意!!! -->
21
        <!-- !!!注意!!! 否则会在某些特殊情况下导致应用崩溃,如果没有该service声明,请忽略此注释 !!!注意!!! -->
22
    </application>
23
</manifest>
 
 
  • 将 <meta-data android:name="PARTNER_CODE" android:value="partner_code " />中 partner_code替换为同盾运营所给的合作方标识。

4、初始化SDK

    • 1. 在应用启动的时候(比如在启动应用的activityonCreate方法中,或者在自定义的applicationonCreate方法中,越早调用越好)调用以下方法:
    • 复制代码

       
       
       
       
       
      1
      FMAgent.init(context, FMAgent.ENV_SANDBOX);
       
       
    • FMAgent.ENV_SANDBOX表示测试环境,FMAgent.ENV_PRODUCTION表示生产环境
  • 2. 初始化成功会在logcat中打印以下log:
  •  
     
     
     
     
    1
    TD_JAVA: tongdun sdk load success
    2
    TD_JAVA: tongdun sdk init success
     
     

5、获取设备指纹黑盒数据,并提交到业务服务器
     在业务关键请求,如客户登录请求的onClick中,获取设备的信息,并发送到应用服务端。示例代码如下:

复制代码

 
 
 
 
 
1
loginBtn.setOnClickListener(new View.OnClickListener() {
2
    @Override
3
    public void onClick(View v) {
4
        //调用接口获取blackBox字段,请确保在onCreate时已经进行init,切勿在onEvent的时候才init
5
        String blackBox = FMAgent.onEvent(MainActivity.this);
6
        //将blackBox的值随业务请求发送到你的服务端, 服务端在调用同盾风险决策服务时需要用到这个参数;
7
    }
8
});
 
 

6、混淆打包
     如果开发者需要使用proguard进行混淆打包,请在proguard配置文件添加如下代码:

复制代码

 
 
 
 
 
1
#TONGDUN
2
-dontwarn android.os.**
3
-dontwarn com.android.internal.**
4
-keep class cn.tongdun.android.**{*;}
 
 

7、FAQ

    • Q: 为什么事件中心显示SDK未成功初始化?
    • A: 请在FMAgent.init()前调用 FMAgent.openLog()过滤TD_JAVA。并排查是否有以下情况:
      • so文件导入失败:第一条显示 Couldn't load so:...。1.混用上面两种方式导入so;2.没有导入对应架构的so。
      • fm-core-xxx文件未导入assets文件夹:第一行显示 get fm-core-xxx failed:...。需要注意在Android Studio 项目中assets文件夹在/app/src/main/assets路径。
      • 如果确认没有以上情况请联系运营同学。
    • Q: 为什么获取的 black_box字段比较长?
    • A: 正常情况下black_box长度为200-250字节,但是由于网络情况较差或者函数 FMAgent.init()和 FMAgent.onEvent()调用间隔时间较短时,black_box会附带一些设备信息长度将增大到1500-3000字节。
    • Q: 为什么事件中心部分信息为空?
    • A: 可能由于从SDK初始化到获取设备数据间隔时间过短,造成设备信息获取失败。切勿初始化之后立即获取设备信息。
    • Q: 为什么调用FMAgent.onEvent()会有卡顿?
    • A: SDK初始化获取数据需要一定的时间,如果初始化后直接调用 FMAgent.onEvent()会造成卡顿感。切勿初始化之后立即获取设备信息。
  • Q: 为何部分事件的真实IP是空的?
  • A: 当SDK上传设备信息失败(超时或者网络被屏蔽)时,将自动转为离线模式,此种情况下同盾无法获取真实IP。
  • Tips: 1.so库要加全,不然碰巧使用的机器要崩溃 2.跟后台约定好使用的是什么环境,直接跳过测试环境也是可以的

同盾安卓 Android应用 集成步骤:的更多相关文章

  1. Android App集成支付宝

    原地址:http://blog.csdn.net/wenbingoon/article/details/7933078 手机的在线支付,被认为是2012年最看好的功能,我个人认为这也是移动互联网较传统 ...

  2. Android 系统移植与驱动开发--第二章搭建Android环境核心步骤及心得

    第二章 搭建Android 开发环境 虽然在这一章中讲的是Android底层开发环境,但是相应伴随的还有Android NDK程序来测试Linux驱动,HAL程序库.底层开发不仅需要交叉编译环境,还要 ...

  3. Android中集成第三方库的方法和问题

    Android中集成第三方库的方法和问题 声明: 1. 本文參考了网上同学们的现有成果,在此表示感谢,參考资料在文后有链接. 2. 本文的重点在第三部分,是在开发中遇到的问题及解决的方法.第一,第二部 ...

  4. Android持续集成之Jenkins 部署

    Android持续集成之Jenkins 部署 [TOC] 0x00安装 准备工作如下: Tomcat8.5下载地址 Jenkins下载链接 1 将下载的jenkins.war包放至tomcat下的we ...

  5. Android Studio集成Genymotion

    Android Studio集成Genymotion比在Eclipse中集成简单多了.主要以下几个步骤: 1.官网先下载Genymotion:http://www.genymotion.com/,下载 ...

  6. Kotlin与Android SDK 集成(KAD 05)

    作者:Antonio Leiva 时间:Dec 19, 2016 原文链接:https://antonioleiva.com/kotlin-integrations-android-sdk/ 使用Ko ...

  7. 1、Android Studio集成极光推送(Jpush) 报错 java.lang.UnsatisfiedLinkError: cn.jpush.android.service.PushProtoco

    Android studio 集成极光推送(Jpush) (华为手机)报错, E/JPush: [JPushGlobal] Get sdk version fail![获取sdk版本失败!] W/Sy ...

  8. 【笔记】android sdk集成的eclipse中导入项目

    android sdk集成的eclipse中导入项目 想要把旧的ADT项目,一模一样的导入进来,需要: 1.把项目放到,非当前ADT的workspace目录下: 2.从Project中Import,选 ...

  9. 安卓Android面试题大全

    56个问题都是经常用到的,可以深入研究下,也是必须掌握的开发必备知识. 安卓Android面试题汇总 搜集了一些Android面试题目,供将要面试或者正在面试的朋友参考. 1, 谈谈你对Activit ...

随机推荐

  1. IOS开发之—— 在AFN基础上进行的网络请求的封装

    网络请求的思路:如果请求成功的话AFN的responseObject就是解析好的. 1发送网络请求:get/post/或者别的 带上URL,需要传的参数 2判断后台网络状态码有没有请求成功: 3 请求 ...

  2. 改变bootstrap-wysiwyg样式(如hide()show()等),上传图片失效

    最近在试验bootstrap-wysiwyg鱼easyui的整合,两者的兼容性,可以说是基本不兼容... 但是由于需求摆在那里,再大的困难也得克服. 比如像是将bootstrap-wysiwyg放入e ...

  3. 用html5的视频元素所遇到的第一个坑

    html5 有一个video标签,这个是被大家所熟知的事情.按照w3c的规范,我认真的写出如下代码: <video preload="auto" controls=" ...

  4. UIButtonTypeSystem backBarButtonItem

    当UIButton是UIButtonTypeSystem类型时,改变UIButton的frame,系统会有一个动画改变效果,不想要这个效果,将类型改为UIButtonTypeCustom. backB ...

  5. js实现上下滑动侧边栏

    给一个原先的电子商务网站做修改,客户说想将原先上下滑动侧边栏改的更加人性化,希望将原先匀速滑动的侧边栏改成变速运动的侧边栏,在到达目的地之前速度越变越慢. 原先一开始的时候,,这个图片是硬生生地到达可 ...

  6. paip.中文 分词 -- 同义词大全整理

    paip.中文 分词 -- 同义词大全整理 同义词的处理方法: 作者Attilax  艾龙,  EMAIL:1466519819@qq.com  来源:attilax的专栏 地址:http://blo ...

  7. 转: sql server2008 字段类型详解

    bit 整型 bit数据类型是整型,其值只能是0.1或空值.这种数据类型用于存储只有两种可能值的数据,如Yes 或No.True 或False .On 或Off. 注意:很省空间的一种数据类型,如果能 ...

  8. Code Hunters: Hello, world!

    大家好!我们是来自MSRA联合培养班的Code Hunters小组,在未来三个月时间里我们将与殷秋丰老师一起学习高级软件工程这门课. 我们小组共有五名分别来自享誉海内外的中国科学技术大学和北京航空航天 ...

  9. C++中map的一点疑惑...

    int CRuntimePara::getInt(const string& strKey,int iDefault){ map<string,string>::const_ite ...

  10. Find The Multiple 分类: 搜索 POJ 2015-08-09 15:19 3人阅读 评论(0) 收藏

    Find The Multiple Time Limit: 1000MS Memory Limit: 10000K Total Submissions: 21851 Accepted: 8984 Sp ...