Author: Marshall

本文大量参考了IBM Developerworks上的文章使用 Equinox 开发 OSGi 应用程序，之所以重新发表，是因为原文使用的是Eclipse 3.3，现在主流的版本为3.4，其中有些不同的地方。另外有一部分语焉不详，很容易使人卡在半途(主要在下一篇里)。因此我针对3.4做了一些整理，也重新截了图，作为对OSGi入门开发的一个小结。
OSGi中文的大部分资料都和BlueDavy有很大的关系。如果想对OSGi有一个入门性或者较为深入的理解，请参阅BlueDavy编写的OSGi实战和OSGi进阶的OpenDoc。本文假定读者对OSGi有一些了解，所以对OSGi的介绍就不再赘述。
对于Eclipse（3.2+）来说，其上运行的所有插件都是OSGi的Bundle。其核心Equinox就是OSGiR4的参考实现。所以，在Eclipse里，我们通过开发插件的形式，开发符合OSGi规范的Bundle。我们从HelloWorld开始。

1. 建立一个 plug-in 工程，File > New > Project，选择 Plug-in development > Plug-in Project
   

   

2. 在建立工程的第一个向导，填入工程的名称：osgi.test.helloworld，使用缺省的工程路径。由于我们的项目是一个通用的 OSGi bundle，所以选择 equinox。比3.3多出来的Working Set的概念我还没搞清楚，就默认吧。
   

   

   
   
3. 这个步骤主要是填写插件/Bundle一些信息。可以不做修改直接“Next”。其中最后的是关于Activator的设置，相当于一个Java程序的main()入口，控制着整个Bundle的生命周期。与3.3相比，多出了Execution Environment选项。如果只在本机HelloWorld的话，就用默认的环境。
   

   

4. 去掉所有的模板设置，结束新建
5. 完成，切换到插件开发的视角。新建了osgi.test.helloworld.Activator类，用于控制Bundle的生命周期，初始化等等（不过初始化工作不必都放在这里，OSGi提供了完整了Listener的支持）。最重要的配置文件是MANIFEST.MF，Eclipse提供了完整的编辑器支持，有几个标签页。比如在Dependencies里设置导入的包和依赖的Bundle/Plugin，Runtime则配置了导出的包及其他信息。
6. 编辑 Activator.java，找到start()方法，输入 hello world 语句，代码如下：

   package osgi.test.helloworld;
   import org.osgi.framework.BundleActivator;
   import org.osgi.framework.BundleContext;
   public class Activator implements BundleActivator {
   	/*
   	 * (non-Javadoc)
   	 * @see org.osgi.framework.BundleActivator#start(org.osgi.framework.BundleContext)
   	 */
   	public void start(BundleContext context) throws Exception {
   		System.out.println("hello world");
   	}
   	/*
   	 * (non-Javadoc)
   	 * @see org.osgi.framework.BundleActivator#stop(org.osgi.framework.BundleContext)
   	 */
   	public void stop(BundleContext context) throws Exception {
   	}
   }

   每个Activator都实现了BundleActivator这个接口。OSGi就通过这个调用接口的 start()和stop()实现Bundle的启动和停止。
   注意：bundle 的 Activator 必须含有无参数构造函数，这样框架才能使用 Class.newInstance() 方式反射构造 bundle 的 Activator 实例。

7. 运行实例。和普通Java程序直接运行不同的是，运行Bundle需要一些配置。选择Run->Run Configurations…，在 OSGi framework 中右键点击选择 new 一个新的 OSGi 运行环境
   

   

8. 在右边的运行环境对话框中，输入运行环境的名字、start level 和依赖的插件。Start Level越高，启动顺序越靠后。图中默认的Start Level(SL)为4，我们把helloworld的Start Level设置为5，即较后加载的Bundle。由于目前不需要其它的第三方插件，因此只需要勾上系统的 org.eclipse.osgi 插件，如果不选择此插件，hello world 将无法运行。只有当点击了 validate bundles 按钮 ，并且提示无问题之后，才表明运行环境基本 OK 了。
9. 点击“Run”，运行，应该能够在Console看到HelloWorld输出
   

   

OSGi控制台使用命令行控制Bundle的状态查看、加载、卸载和更新。OSGi的好处在于能够在不重启应用的情况下，实现对模块的热插拔。如通过SS命令查看所有Bundle的简单状态（SS=Simple Status）。图中模块的状态为ACTIVE。

下图展示了OSGi Bundle的状态图：
我可以直接修改HelloWorld里Activator的代码，编译后。使用Refresh命令更新helloworld的Bundle，得到更新后的运行输出：
下面列出了主要的控制台命令。也可以在控制台中输入? 获得帮助