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官方提供的文档基本上是模块化的东西

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类启动框架了如下代码

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 一下是我写的两个文件代码

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 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()方法中给出框架启动是需要启动的插件文本文件路径(也就是我们刚才编译得到的插件)

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服务

这里给出模版代码

/**
* 获取系统提供的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中的界面了有图有真相



最后给出源码