android模块化app开发笔记-1环境搭建

由于项目做的越来越大，业务上就产生了要将app模块化的需求，所谓模块化就是将一个app分成不同功能的小模块（插件）,当安装程序的时候并不需要将所有模块一次全部安装，用户可以在需要的时候视情况从服务器上更新添加小插件。

android上模块化一直都有人在摸索也出现了不少框架各有优特点，我学习apkplug这个插件化框架。这个框架的特点是

1)插件就是普通apk文件，开发插件跟普通app没有太大区别省去了学习固定api的功夫了。

2)插件apk不用在本地安装,网上比较经典的插件化框架都是通过android:sharedUserId="xxx"的形式将插件与app进行关联，而apkplug不用安装在app进程中运行也算是它的一大特点

3)通过标准OSGI服务实现插件间通讯，我们开发应用时就可以定义自己的通讯接口了，而不必拘泥于固定的接口。

一 环境搭建

从apkplug官网下载其最新的sdk解压出来的文件目录结构为如图1



新建一个主应用工程我取名为myapkplughelloworld，将armeabi,Bundle1.4.0.jar两个文件放入工程的libs文件夹中如图2



配置应用权限到工程的AndroidManifest.xml中

<!-- 插件平台需要的权限! -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
<uses-permission android:name="android.permission.INTERNET"/>

另外将以下代码加入到<application></application>节点中

<!-- 插件平台需要的配置! -->
<activity
android:name="org.apkplug.app.apkplugActivity"
android:configChanges="orientation|keyboardHidden"
/>

下一步便是调用SDK启动插件了。

这里需要写一个PropertyInstance接口它是apkplug定义的目的是为了插件框架启动时传人一些启动参数，我够出来这个接口的定义如下，具体详细使用可以看apkplug官方提供的文档基本上是模块化的东西

[java] view plaincopy

public interface PropertyInstance {

/**

* 框架配置信息获取接口

* 框架将通过该接口从系统获取必要信息

* 可以通过该接口实现框架信息的本地保存

* @param key

* @return

*/

public String getProperty(String key);

/**

* 框架配置信息设置接口

* 框架通过该接口设置其产生的配置信息

* 可以通过该接口实现框架信息的本地保存

* @param key

* @param v

*/

public void setProperty(String key,String v);

/**

* 框架启动时将自动安装该该函数提供的文件

* @return 本地插件绝对路径

*/

public String[] AutoInstall();

/**

* 框架启动时将自动安装并启动该该函数提供的文件

* @return 本地插件绝对路径

*/

public String[] AutoStart();

}

PropertyInstance写好以后便可以调用FrameworkInstance类启动框架了如下代码

[java] view plaincopy

try

{

FrameworkInstance frame=FrameworkFactory.getInstance().start(null,Launcher.this,

MyProperty.getInstance(this.getApplicationContext()));

}catch (Exception ex){

System.err.println("Could not create : " + ex);

//ex.printStackTrace();

StringBuffer buf=new StringBuffer();

buf.append("插件平台启动失败：\n");

buf.append(ex.getMessage());

this.setTitle(buf.toString());

Toast.makeText(this, "插件平台启动失败",

Toast.LENGTH_SHORT).show();

}

如果不出意外插件框架便启动完毕了，通过启动完成后的FrameworkInstance类可以获得框架的第一个内置插件SystemBundle。这个插件很重要它是我们进入框架的一个入口，我们可以通过它调用或启动其他框架的类与activity，下面将列出调用activity的代码

二 编写插件

首先新建一个工程myBundle将SDK包中的OSGI.jar引入到工程(注意这里osgi.jar包不能直接放入libs文件夹中，我们仅引入但不编译否则框架加载插件时会报错，因为包冲突)中如下图



接下来还需要写两个文件,一个是org.osgi.framework.BundleActivator接口，框架启动时将调用我们写的这一个类。另外一个是plugin.xml文档它用于配置插件的启动参数，比如启动的BundleActivator路径，启动的Activity,需要引出的包等。详细可以看官网plugin.xml配置说明http://www.apkplug.com/guide/#39 一下是我写的两个文件代码

[java] view plaincopy

public class SimpleBundle implements BundleActivator

{

private BundleContext mcontext = null;

public void start(BundleContext context) throws Exception

{

System.err.println("你号我是插件,我已经启动了 我的BundleId为："+context.getBundle().getBundleId());

this.mcontext = context;

}

public void stop(BundleContext context)

{

System.err.println("你号我是插件,我被停止了 我的BundleId为："+context.getBundle().getBundleId());

}

}

[xml] view plaincopy

<?xml version="1.0" encoding="UTF-8"?>

<plugin-features

Bundle-Name="myBundle"

Bundle-SymbolicName="com.example.mybundle"

Bundle-Version="1.0.0"

date="2013.10.223"

provider-name="插件开发商的名称"

provider-url=""

Bundle-Activator="com.example.mybundle.SimpleBundle"

Bundle-Activity="com.example.mybundle.MainActivity"

Export-Package="com.example.mybundle"

>

</plugin-features>

记得插件中的Activity都需要继承框架的BundleActivity。最后编译插件将得到的apk文件复制到主应用的assets文件夹中(如果要实现网络更新可以使用apkplug提供的远程插件托管服务)

下一步在主应用我们写的PropertyInstance接口的public String[] AutoStart()方法中给出框架启动是需要启动的插件文本文件路径(也就是我们刚才编译得到的插件)

[java] view plaincopy

public String[] AutoStart() {

File f0=null;

try {

InputStream in=context.getAssets().open("myBundle.apk");

f0=new File(context.getFilesDir(),"myBundle.apk");

if(!f0.exists())

copy(in, f0);

} catch (IOException e) {

// TODO Auto-generated catch block

e.printStackTrace();

}

return new String[]{"file:"+f0.getAbsolutePath()};

}

这样当插件启动时便会同时启动我们的插件了。

这还没有完我们还需要通过SystemBundle来启动插件的Actvitiy

启动插件的Actvitiy需要调用框架提供的一个OSGI服务

这里给出模版代码

[java] view plaincopy

/**

* 获取系统提供的StartActivity服务来启动一个插件中的Activity

* 前提时插件中已在plugin.xml设置了Export-Package中添加了该

* Activity完整包路径 否则会找不到该Activity

* @param name

* @throws Exception

*/

public void startActivity(String ActivityClass) throws Exception{

System.out.println(ActivityClass);

BundleContext mcontext=frame.getSystemBundleContext();

ServiceReference reference=mcontext.getServiceReference(StartActivity.class.getName());

if(null!=reference){

StartActivity service=(StartActivity) mcontext.getService(reference);

if(service!=null){

Intent i=new Intent();

i.setClassName(this, ActivityClass);

i.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

service.StartActivity(mcontext, i);

}

mcontext.ungetService(reference);

}

}

最后运行主应用便可以看到插件apk中的界面了有图有真相



最后给出源码