Jitsi（SIP communicator）创建自定义UI插件

• 概述

         在进行二次开发，特别是开源项目的二次开发中，有那么几点我觉得是非常重要的，第一是在修改之前要先搞清楚这个开源项目如何进行部署、打包和测试，这些东西一般来说比较烦，容易产生问题，而国外开源软件的文档可能不是那么全面，环境和我们也可能不同（一般是linux环境居多）；第二是在修改之前，先研究一下别人的源码，看看别人是不是给你提供了一些二次开发的接口，一般都会有一些plugins之类的，可以直接拿过来用；第三也是最重要的，如果不是特别需要，尽量不要直接修改别人的代码，也不要破坏别人的类结构（比如在别人的包下面加类），这样做，以后维护起来比较方便，而且我们也可以继续更新使用官方的新版本。

        在Jitsi这个项目的基础上进行二次开发，之前已经研究过它的编译打包，下面我们要研究一下它的架构，首先这个项目是一个基于OSGI的项目，OSGI的结构，简单来说就是一个OSGI加多个Bundle（也可翻译为模块或者插件），因此我们在这个架构上进行二次开发方向比较明确，就是进行OSGI的模块开发；然后我们研究一下源码发现它对于UI开发提供了一些容器和接口，可以方便我们进行GUI开发，并且给出了一个exampleplugin的Bundle，具体大家可以自行查看源码。

• 创建包和类，配置OSGI环境

         在JItsi项目的源码目录下（src）添加包：test.plugin.employeebook包，在这个包下新建一个类：EmployeebookPluginActivator，如下

public class EmployeebookPluginActivator implements BundleActivator{

	@Override
	public void start(BundleContext arg0) throws Exception {
		// TODO Auto-generated method stub
		
	}

	@Override
	public void stop(BundleContext arg0) throws Exception {
		// TODO Auto-generated method stub
		
	}
	
}

         在同样的包下新建一个名为employeebookplugin.manifest.mf的文件，内容如下：

Bundle-Activator: test.plugin.employeebook.EmployeebookPluginActivator
Bundle-Name: EmployeeBook plugin
Bundle-Description: A plugin used to show employee book
Bundle-Vendor: 
Bundle-Version: 0.0.1
Import-Package: org.osgi.framework

          修改项目根目录下的build.xml文件，添加一个ant target如下：

	<target name="bundle-plugin-employeebook" depends="compile">
	    <jar compress="false" destfile="${bundles.dest}/plugin-employeebook.jar"
	            manifest="${src}/test/plugin/employeebook/employeebookplugin.manifest.mf">
	            <zipfileset dir="${dest}/test/plugin/employeebook"
	                prefix="test/plugin/employeebook" />
	    </jar>
	</target>

          然后运行这个target，完成后在项目根目录下的sc-bundles目录下出现plugin-employeebook.jar，然后修改lib目录下的felix.client.run.properties文件，设置felix框架自动加载这个bundle，然后运行整个项目，在选项》插件下找到这个插件，说明插件部署成功了。

• 应用JItsi的UI加载机制

public class EmployeebookPluginActivator implements BundleActivator{
	
	@Override
	public void start(BundleContext arg0) throws Exception {
	    // TODO Auto-generated method stub
	    //在主窗口中加如一个TAB窗口，这个EmployeebookPanel 是一个JPanel 
	    EmployeebookPanel employeePanel = new EmployeebookPanel(Container.CONTAINER_MAIN_TABBED_PANE);
		
	    Hashtable<String, String> containerFilter = new Hashtable<String, String>();
		
	    containerFilter.put(
            Container.CONTAINER_ID,
            Container.CONTAINER_MAIN_TABBED_PANE.getID());
	    arg0.registerService(PluginComponent.class.getName(),employeePanel,containerFilter);
	    //以上应用了Jitsi的插件UI管理机制，其中Container下有许多常量，代表着不同的容器，
            //通过这些容器我们可以方便地把需要的组件添加到菜单栏、状态栏都位置
       }
       @Override
       public void stop(BundleContext arg0) throws Exception { 
            // TODO Auto-generated method stub
       }
}

• 配置OSGI框架自启动我们的插件

        这一步我们按照OSGI的标准来就可以了，我们运行上面的Ant Target，发现项目sc-bundles目录下多出一个plugin-employeebook.jar文件，然后我们修改lib目录下的felix.client.run.properties文件，加入\ reference:file:sc-bundles/plugin-employeebook.jar，重启Jitsi项目，我们会发现插件被自动加载进来了。