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中的界面了有圖有真相

最後給出源碼