equinox quickstart guide.htm

OSGI 开发指南源代码|实例|入门及相关的文档

  to start an Eclipse application. This setting is not critical but without it a 
  scary but otherwise inoccuous message appears in your log. For more 
  information on the set of command-line args and system properties available to 
  set things up, see </P>
  <BLOCKQUOTE>
    <P><A 
    href="http://help.eclipse.org/help32/topic/org.eclipse.platform.doc.isv/reference/misc/index.html">http://help.eclipse.org/help32/topic/org.eclipse.platform.doc.isv/reference/misc/index.html</A><BR><A 
    href="http://help.eclipse.org/help32/topic/org.eclipse.platform.doc.isv/reference/misc/runtime-options.html">http://help.eclipse.org/help32/topic/org.eclipse.platform.doc.isv/reference/misc/runtime-options.html</A> 
    </P></BLOCKQUOTE>
  <P>Now, if you want to make things even easier, you can add in a few Eclipse 
  bundles (i.e., org.eclipse.equinox.common and 
  org.eclipse.update.configurator). This gives you automatic bundle 
  discovery/install. Set up something like</P><PRE>somedir/
  configuration/
    config.ini
  org.eclipse.osgi_3.3.0.jar
  org.eclipse.equinox.common_3.3.0.jar
  org.eclipse.update.configurator_3.2.100.jar
  plugins/
    B1.jar
    B2.jar</PRE>
  <P>Add these bundles on the osgi.bundles list in your config.ini as 
  follows:</P><PRE>  osgi.bundles=org.eclipse.equinox.common@2:start, org.eclipse.update.configurator@3:start</PRE>
  <P>When the Update configurator bundle starts, it automatically discovers and 
  installs all the bundles in the <EM>plugins</EM> directory that is beside the 
  Equinox JAR. Note that the configurator does not automatically start these 
  bundles.</P>
  <P>Finally, if version 3.3 is used, you can add the equinox launcher to your 
  configuration. The equinox launcher comes in 3 pieces: the native executable 
  (eclipse.exe), a shared library (eclipse_1017.dll) and the launcher jar 
  (org.eclipse.equinox.launcher_1.0.0.jar). The executable lives in the root of 
  the eclipse install. The shared library is in a platform specific fragment 
  (i.e. org.eclipse.equinox.launcher.win32.win32.x86). The shared library and 
  the launcher jar live in the <EM>plugins</EM> directory. Set up something 
  like</P><PRE>somedir/
  configuration/
    config.ini
  eclipse.exe
  plugins/
    org.eclipse.equinox.common_3.3.0.jar
    org.eclipse.equinox.launcher.win32.win32.x86_1.0.0/
      eclipse_1017a.dll
      [other launcher fragment content]
    org.eclipse.equinox.launcher_1.0.0.jar
    org.eclipse.osgi_3.3.0.jar
    org.eclipse.update.configurator_3.2.100.jar
    B1.jar
    B2.jar</PRE>
  <P>When the equinox launcher is used all bundles (including the framework 
  org.eclipse.osgi) must be placed in the plugins directory which is beside the 
  native executable (eclipse.exe). The equinox launcher is configured by default 
  to run an eclipse application. If an eclipse application is not found then the 
  OSGi framework is shutdown and equinox will exit. To prevent this another 
  property must be added to the config.ini (osgi.noShutdown=true). The final 
  config.ini will look like this.</P><PRE>  osgi.bundles=org.eclipse.equinox.common@2:start, org.eclipse.update.configurator@3:start
  eclipse.ignoreApp=true
  osgi.noShutdown=true
</PRE>
  <P>Once this is set up you can start equinox with the console using the 
  following command line: </P><PRE>  eclipse -console</PRE>
  <P>The steps above should get you running with a reasonably flexible 
  configuration of Equinox and a collection of bundles. Eclipse and Equinox 
  offer a significant set of extensibilty and configuration options that are 
  beyond the scope of a getting started document (e.g., extension registry, 
  application model, shared installs, ...). To use the full power of Eclipse, 
  look at how the Eclipse IDE and RCP applications are structures and check out 
  the Help system links above as well as</P>
  <BLOCKQUOTE>
    <P><A 
    href="http://help.eclipse.org/help32/topic/org.eclipse.platform.doc.isv/reference/misc/multi_user_installs.html">http://help.eclipse.org/help32/topic/org.eclipse.platform.doc.isv/reference/misc/multi_user_installs.html</A> 
    </P></BLOCKQUOTE>
  <P>For those who are interested in some of the Eclipse extensions to OSGi, 
  see</P>
  <BLOCKQUOTE>
    <P><A 
    href="http://help.eclipse.org/help32/topic/org.eclipse.platform.doc.isv/reference/misc/bundle_manifest.html">http://help.eclipse.org/help32/topic/org.eclipse.platform.doc.isv/reference/misc/bundle_manifest.html</A></P></BLOCKQUOTE>
  <P>Most of these facilities are experimental. Some general and have been 
  proposed for inclusion in the OSGi R4.1 or R5 specifications while others are 
  Eclipse-specific. All were put in place to solve real problems that we (or our 
  consumers) were having. You may be having related problems.</P>
  <P class=bar>Other Information</P>
  <UL>
    <LI>The Eclipse SDK includes some very sophisticated tooling for defining, 
    developing, debugging, building and deploying bundles. To use this tooling 
    run the SDK and mentally replace the word "Plugin" with "Bundle" in all the 
    menu/wizard entries. For example, File &gt; New &gt; Plugin Project creates 
    a project suitable for coding OSGi bundles. The "Plugin Editor" is really a 
    bundle editor with some extra support for Eclipse constructs such as the 
    Extension registry. 
    <LI>Log bug reports in the <A 
    href="https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Equinox&amp;version=3.3&amp;component=Framework&amp;priority=P3&amp;bug_severity=normal&amp;bug_status=NEW&amp;assigned_to=&amp;cc=&amp;bug_file_loc=&amp;short_desc=&amp;comment=&amp;form_name=enter_bug">Equinox/Framework 
    component</A> 
    <LI>Questions and comments should go in the <A 
    href="news://news.eclipse.org/eclipse.technology.equinox">equinox</A> 
    newsgroup. 
    <LI>Development questions can go to <A 
    href="mailto:[e-mail]">[e-mail]</A>. </LI></UL>
  <P>&nbsp;</P></LI></UL></DIV>
<DIV id=rightcolumn>
<DIV class=sideitem>
<H6>Equinox links</H6>
<UL>
  <LI><A href="http://www.eclipse.org/equinox">home</A> 
  <LI><A href="http://www.eclipse.org/equinox/framework">framework</A> 
  <LI><A href="http://www.eclipse.org/equinox/bundles">bundles</A> 
  <LI><A href="http://www.eclipse.org/equinox/incubator">incubator</A> 
  <LI><A href="http://www.eclipse.org/equinox/server">server</A> 
  <LI><A href="http://www.eclipse.org/equinox/incubator/provisioning">p2</A> 
  <LI><A href="http://www.eclipse.org/equinox/security">security</A> 
  <LI><A href="http://wiki.eclipse.org/Equinox">wiki</A> 
  <LI><A href="http://www.eclipse.org/equinox/documents">documents</A> 
  <LI><A href="http://download.eclipse.org/equinox/">downloads</A> 
  <LI><A href="http://www.eclipse.org/equinox/resources.php">resources</A> 
  <LI><A href="http://wiki.eclipse.org/Equinox/Plan">planning</A> 
  <LI><A href="http://www.eclipse.org/equinox/faq.php">faq</A> 
</LI></UL></DIV></DIV>
<DIV id=rightcolumn>
<DIV class=sideitem>
<H6>Hot docs</H6>
<UL>
  <LI><A 
  href="http://www.eclipse.org/equinox/documents/quickstart.php">quickstart</A> 
  <LI><A href="http://www.eclipse.org/equinox/server/http_quickstart.php">server 
  quickstart</A> 
  <LI><A href="http://www.eclipse.org/equinox/documents/coding.php">coding</A> 
  </LI></UL></DIV></DIV>
<SCRIPT type=text/javascript>
		var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
		document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
		</SCRIPT>

<SCRIPT type=text/javascript>
		var pageTracker = _gat._getTracker("UA-910670-2");
		pageTracker._initData();
		pageTracker._trackPageview();
		</SCRIPT>
<BR style="CLEAR: both; HEIGHT: 1em">&nbsp; </DIV>
<DIV id=clearFooter></DIV>
<DIV id=footer>
<UL id=footernav>
  <LI><A href="http://www.eclipse.org/">Home</A> 
  <LI><A href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</A> 
  <LI><A href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</A> 
  <LI><A href="http://www.eclipse.org/legal/">Legal</A> 
  <LI><A href="http://www.eclipse.org/org/foundation/contact.php">Contact Us</A> 
  </LI></UL><SPAN id=copyright>Copyright © 2009 The Eclipse Foundation. All Rights 
Reserved.</SPAN> </DIV></DIV></BODY></HTML>