Android第三方SDK组件开发文档

APKPLUG第三方SDK组件开发原理说明文档
目录
一，概要说明 (2)
二，基本原理 (2)
三，使用步骤 (4)
1. 主应用中导入相关库文件并初始化 (4)
2，配置相关权限 (4)
3，调用组件 (4)
四，如何自定义组件 (5)
1. 组件源码工程 (5)
2. 修改组件源码并上传托管服务 (6)
3. 修改ApkplugPlugXXX.jar中的appid (6)
五，总结 (6)
六，组件征集 (7)
一，概要说明
使用APKPLUG 组件的目的主要是为了能快速的接入目前市场上存在的第三方SDK 和开发库,并且也组件的方式动态加载。

使用APKPLUG 组件开发应用有以下几点好处:
1. 可以快速接入,我们通过对第三方SDK 进行预处理,使开发者不必了解SDK 具体接
口的情况下快速接入。

2.
可极大减小应用体积,APKPLUG 组件在发布时不必打包到应用中而是在需要是动态从服务器下载。

3. 方便后期维护，APKPLUG 组件与主应用工程是分离的,开发者不必将SDK 的资源
打包到主应用中,以免引起不必要的干扰。

二，基本原理 APKPLUG 组件由三部分组成
1. 组件工程
第三方SDK 具体实现插件,开发者可以直接使用也可以根据不同的需求定制插件。

具体定制方法见下文 2. 主应用 即开发者的实际项目
3. 对接Jar 包ApkplugXXX.jar
该包一般在10K 大小左右,主要提供一下几个功能:
1. 组件检测,如组件不存在便从服务器上下载
2. 组件更新下载 【使用APKPLUG 插件托管云服务SDK 】
3. 主应用与组件调用接口服务封装
每一类组件可能有不同的服务接口,例如ShareSDK 评论组件
public View getQuickCommentBar(…)
public View getTopicTitle (…)
4. APKPLUG 组件工作结构图:
APKPLUG 框架 组件
ApkplugXXX.jar 主应用 托管云 1 2 3
5.APKPLUG工作流程图
三，使用步骤
正常情况下APKPLUG组件使用只需要一下三步
1.主应用中导入相关库文件并初始化
1.导入APKPLUG框架即Bundle.jar 【200K】
2.导入插件托管服务ApkplugCloudService.jar 【400k】
3.导入组件调用库ApkplugPlugXXX.jar 【10k】
初始化代码:
1.apkplug框架初始化
frame=FrameworkFactory.getInstance().start(null, this); 【application.oncreate()】
2.插件托管服务初始化
ApkplugCloudAgent.getInstance(context).init(); 【application.oncreate()】2，配置相关权限
根据Apkplug组件情况可能需要在宿主AndroidManifest.xml中配置部分信息
3，调用组件
以上步骤配置完成以后即可使用该组件了,使用方式非常简单，以环信IM为例IMSdkAgent imsdkagent=new IMSdkAgent(this,frame.getSystemBundleContext()); imsdkagent.StatIMSDK(
new CheckInitCallBack(){
@Override
public void onSuccess(PlugIMSDK service) {
Log.e("", "PlugIMSDK");
//这里就会启动环信界面了
service.StartIM("");
}
@Override
public void onFailure(int errorNo, String strMsg) {
Log.e("onFailure", strMsg);
}
});
四，如何自定义组件
正常情况下我们可以直接使用APKPLUG官方提供的组件,但有时我们任然需要对SDK做一些扩展,以满足我们的项目需求。

APKPLUG组件基本都提供源码,我们可以修改组件源码达到自定义的目的。

下面我们以环信组件为例介绍如何自定义组件
1.组件源码工程
如上图,当我们调用【主应用执行】imsdkagent.StatIMSDK(…)函数时会执行一下步骤
1.检测组件是否已安装【主应用执行】
2.安装并启动组件【主应用执行】
3.组件启动并执行动作【组件执行】
组件的SimpleBundle.java中注册ImpPlugIMSDK为PlugIMSDK服务
4.主应用查询PlugIMSDK服务【主应用执行】
成功后会通过CheckInitCallBack.onSuccess(PlugIMSDK service)回调实例
5.调用PlugIMSDK.StartIM("")【主应用执行】
具体执行的是ImpPlugIMSDK中StartIM(String arg0)的具体实现【组件执行】
2.修改组件源码并上传托管服务
我们可以修改组件源码生成我们所需要的组件APK文件，但如何才能让主应用正确的该APK呢？
答案是通过appid。

当我们使用apk托管服务时，系统要求每一个apk都需要申请一个appid,通过这个id区分不同的组件apk。

默认情况下APKPLUG组件都是使用的APKPLUG 官方开发的apk，因此要使用自定义的APK组件只需要将appid配置为自己申请的
1.如何申请appid
您可以到apkplug官网后台申请appid /cloud/user/login
2.将申请的appid配置到组件项目的Manifest.xml中的<application>标签之下
3.重新编译组件工程,将生成的apk上传托管服务后台。

3.修改ApkplugPlugXXX.jar中的appid
通常情况下我们除了提供APKPLUG组件工程源码之外还提供一个调用该组件的主应用DEMO，而在这个DEMO中我们定义了ApkplugPlugXXX.jar。

而appid一般在XXXSDKAgent.java中定义。

因此你只需要找到对应地方修改appid即可。

五，总结
以上我们详细介绍了APKPLUG组件的基本原理,使用方法以及如何自定义组件。

通读下来内容比较多，但实际上只要你完整的操作一遍以后便可以很方便的使用APKPLUG提供的各种第三组件了。

可谓是一劳永逸哦！
如果您在使用过程中有遇到任何问题可以通过邮箱或技术支持联系我们获取帮助。

技术支持:https:///home/
六，组件征集
如果您有好的组件希望分享给大家使用请与我们联系,我们将非常感激。

联系方式:
邮箱:partner@
官方网址:。