| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
| "http://www.w3.org/TR/html4/loose.dtd"> |
| <html> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| <title>OSGi Framework Launcher</title> |
| <link href="../../book.css" rel="stylesheet" type="text/css"> |
| <style type="text/css"> |
| <!-- |
| .style1 { |
| font-size: 18px; |
| font-weight: bold; |
| } |
| .style2 { |
| font-size: 12pt; |
| font-weight: bold; |
| } |
| --> |
| </style> |
| </head> |
| |
| <body> |
| <p class="style1">OSGi Framework Launcher</p> |
| <p>PDE provides an <em>OSGi Framework</em> launcher, which allows you to launch an OSGi framework and test or debug your OSGi bundle. As with all other launchers in Eclipse (e.g. the <em>Java Application</em> and <em>Java Applet</em> launchers,...), the <em>OSGi Framework</em> launcher can be invoked via a shortcut, and its launch configurations are centrally managed in the <strong>Launch Configuration Dialog</strong>. </p> |
| <p>Note that in Eclipse, the words <em>plug-in </em>and <em>bundle</em> are used interchangeably. <em>A plug-in is a bundle and a bundle is a plug-in</em>. </p> |
| <p> </p> |
| <p class="style2">Launching via a Shortcut</p> |
| <p>A quick way to test a bundle is by launching an <em>OSGi Framework</em> via<strong> Run As > OSGi Framework</strong> from the context menu of a plug-in project. To launch in debug mode, choose <strong>Debug As > OSGi Framework</strong> from the context menu of the plug-in project. </p> |
| <p>When a shortcut is used, PDE searches for existing <em>OSGI Framework</em> launch configurations and creates a new launch configuration only if none were found. If a single launch configuration is found, it is used. If multiple configurations are found, PDE presents a selection dialog containing all existing <em>OSGi Framework</em> launch configurations and prompts the user to choose one. If a new <em>OSGi Framework</em> launch configuration is created, PDE will use the default |
| <a href="../../../reference/extension-points/org_eclipse_pde_ui_osgiFrameworks.html">OSGi Framework</a> which is specified on the |
| <a href="../preference_pages/osgi_frameworks.htm">OSGi Frameworks</a> preference page. |
| </p> |
| <p> </p> |
| <p class="style2">Customizing a Launch Configuration</p> |
| <p>In order to have full control over launching an <em>OSGi Framework</em>, you can create and customize a launch configuration in the <strong>Launch Configuration Dialog</strong>.</p> |
| <p>The <strong>Launch Configuration Dialog</strong> can be invoked via <strong>Run > Run...</strong> or <strong>Debug > Debug...</strong> from the top level menu. A new <em>OSGi Framework</em> launch configuration can be created by double-clicking on the <strong>OSGi Framework</strong> node in the tree viewer to the left. </p> |
| <p>An <em>OSGi Framework</em> launch configuration contains six tabs allowing you to customize all aspects of the test launch. Please refer to the following documents for more details: </p> |
| <ul><li><a href="equinox_plugins.htm">Bundles Tab</a></li> |
| <li><a href="equinox_args.htm">Arguments Tab </a></li> |
| <li><a href="equinox_settings.htm">Settings Tab</a></li> |
| <li><a href="tracing.htm">Tracing Tab</a></li> |
| <li><a href="environment.htm">Environment Tab</a></li> |
| <li><a href="common.htm">Common Tab</a></li> |
| </ul> |
| <p> </p> |
| </body> |
| </html> |