【仅供内部供应商使用,不提供对外解答和培训】

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

准备 

...

开发工具

        提供两种方式的集成工程下载, 一种AndroidStudio  一种 IDEA.    (详情下载地址)

Android Studio 工程配置方法  

         在android studio中,有两种方式引入外部lib  一种是jar包,一种是带资源文件的aar包, jar: 只包含了class文件与清单文件 ,不包含资源文件,如图片等所有res中的文件。aar: 包含jar包和资源文件,如图片等所有res中的文件

因为jar包引入和IDEA工程类似, 这里将着重介绍如何使用本地的aar包进行工程配置

第一步骤: 在工程中引入fr对应的aar包, 一般是放在lib目录下. Android Studio支持两种方式引入,

          第一种是直接在设置界面进行操作.

              1. File——New——New Module——Import .JAR/.AAR Package(jar包也可以这样导入)

              2.选择aar包所在的路径,一般还是放置在libs目录下。Finish完成即可.  

              3.Sync Now同步一下工程与Gradle,或重新编译工程。

              4.添加到app的依赖中去。Project Structure——app——Dependencies中添加Module dependency,把module添加进去

          第二种是用gradle进行配置

             1. 把aar复制到工程应用app下的libs目录中

             2. 在app的build.gradle中添加一个本地仓库,并把libs作为仓库地址

                 Image Removed

             3. 修改dependencies。添加一行:compile(name:’fr_xxx’, ext:’aar’)。name就是fr_xxx.aar的文件名,ext就是fr_xxx.aar扩展名

             4. 重新编译,编译成功后,在build\intermediates\exploded-aar目录下能看到fr_xxx.aar包的内容了。jars下是class文件,res下是资源文件.

IDEA 工程配置方法

第一步:在工程app/libs目录下放入FRSDK相关fr_xxx.jar包和so文件, 详细列表见 相关JAR包说明.

Image Removed

 

第二步: 在IDEA Project structure中配置Libraries, 引入工程中的libs

Image Removed

 

第三步: 在Modules中 加入新加的libs

Image Removed

第四步: 将FRSDK中的assets,  res资源拷贝至app工程对应的assets, res文件中.

 

如上: 工程配置完毕,  可以直接引用FR相关API, 进行集成开发.


        本工程配置适用于IDEA和Android Studio两种Android集成开发环境,本文建议使用google官方的Android Studio作为你的开发工具

SDK下载

        您可以从下载地址获取相关SDK

导入SDK

       Android Studio 和  IDEA 配置方法相同,本文将以Android Studio为例,说明如何将FR SDK导入到您的项目中。

       1. 下载libs文件夹

       在SDK下载地址点击下载lib获取libs压缩包,并解压

       2. 将解压后的libs文件夹中的完整内容复制到模块libs目录下

       3. 打开该模块的build.gradle文件,并添加如下内容

Code Block
languagegroovy
title设置该模块maven仓库地址
linenumberstrue
repositories {
    maven {
        url uri("libs")    // 配置该模块的maven仓库地址
    }
}
Code Block
languagegroovy
title添加模块依赖
linenumberstrue
    compile fileTree(include: ['*.jar'], dir: 'libs')  // 依赖部分jar包文件

    compile ('com.fr.android:bi-sdk:+', {// BI功能对应模块.

        //  可能的冲突版本 需要排除
//        exclude group: 'com.google.zxing',  module: 'core'
//        exclude group: 'com.jiechic.library',  module: 'xUtils'
//        exclude group: 'com.android.support',  module: 'appcompat-v7'
//        exclude group: 'com.android.support',  module: 'recyclerview-v7'

    })
    compile('com.fr.android:report-sdk:+', {// 报表对应模块.

        //  可能的冲突版本 需要排除
//        exclude group: 'com.google.zxing',  module: 'core'
//        exclude group: 'com.jiechic.library',  module: 'xUtils'
//        exclude group: 'com.android.support',  module: 'appcompat-v7'
//        exclude group: 'com.android.support',  module: 'recyclerview-v7'
    })
	// 根据需要加载对应的插件模块
    compile 'com.fr.android:location:+'     // 定位插件,获取经纬度
    compile 'com.fr.android:vpn:+'          // VPN插件,登录Sangfor VPN 服务器
    compile 'com.fr.android:gis:+'          // GIS插件,显示GIS地图图表
    compile 'com.fr.android:push-xg:+'      // 推送插件, 集成信鸽推送服务

添加后,build.gradle如下所示

4. 在该模块清单文件的application标签中添加属性

Code Block
languagexml
title可能的标签冲突
linenumberstrue
tools:replace="android:allowBackup, android:label, android:icon, android:theme"   // 替换SDK清单文件中allowBackup, label, icon, theme等属性的值



如上,工程配置完毕,FR SDK已经成功添加到您的项目中,之后可以直接引用FR相关的API,进行集成开发。您也可以参考OEM_demo和SDK_demo中的项目结构和build.gradle文件,进行工程配置。各插件模块的使用,请参考相关插件文档。