OraclePluginProcess

Contents

Plugins Owned by Oracle Employees

This page describes the recommended process for releasing/publishing plugins owned by Oracle employees, who may or may not be members of the NetBeans team.

Motivation

It is useful to track all NetBeans plugins contributed by Oracle, and have some process that assures reasonable quality of the plugins, their timely availability to the end users, and continuity across several NetBeans releases.

There are two choices for publishing Oracle-developed plugins: either the Certified Update Center, or the Plugin Portal (and potentially the Plugin Portal Update Center).

Certified Update Center

Suitable for plugins that are tested by QA, and which are critical for the user experience of using NetBeans with Oracle technologies and products. The source code of plugins on the Certified UC should be hosted in the main NetBeans repository. The list of plugins for the Certified UC is tracked here: NB73StableModulesUC

It is the responsibility of the Release Boss to define and track the list of plugins on the Certified UC. The steps to add/remove a plugin from the Certified UC are:

  1. Negotiate this change with the Release Boss
  2. Add the plugin to the stableuc build configuration in cluster.properties
  3. Upload the plugin to the Plugin Portal, but do not request verification of this plugin
  4. Release boss will add/remove the plugin to/from the wiki page.
  5. Release engineering will take care of publishing the plugins at the time of the release (FCS, Beta, RC)

Plugin Portal Update Center

Plugin portal should list all NetBeans plugins, regardless of whether they are available on the UC and which one, and regardless of whether they are developed by an Oracle employee or not, and regardless of where the sources are hosted. There is an Update Center associated with the plugin portal, which hosts a subset of the plugins at the PP. Only plugins of decent quality are eligible for the Plugin Portal Update Center - any plugin submitted for the PP UC has to undergo a manual verification process.

The list of plugins on he Plugin Portal UC is tracked here: PluginPortalUC. Especially plugins developed by Oracle employees should be listed here, to make it easier to track their availability across multiple releases.

The process for publishing plugins to the PP UC differs between plugins hosted in the netbeans.org Mercurial repository (main or contrib) and plugins hosted elsewhere.

Publishing a plugin hosted in the NetBeans hg repository (main or contrib)
  1. Add the plugin to the build job that builds plugins by editing nbbuild/cluster.config#nb.cluster.betauc in the release branch (should be disjoint with nb.cluster.stableuc and nb.cluster.experimental).
  2. Trigger a new build of this job using the Build Now link, so the plugin is built (this job does not run automatically/periodically)
  3. Download the build artifacts produced by this job
  4. Submit these artifacts to the plugin portal
  5. Request verification for this plugin
  6. Add an entry to/update the wiki page
Publishing a plugin hosted outside of the NetBeans hg repository
  1. Build the plugin (everyone is responsible for building and signing their plugin)
  2. Submit the plugin to the plugin portal
  3. Request verification for this plugin
  4. Add an entry to/update the wiki page

If your plugin verification request is not completed in two weeks, please escalate by writing to the pluginreview@netbeans.org mailing list.

Note about plugins consisting of multiple nbm files

In the situation when the plugin consists of multiple nbm files, but it is desirable to only expose it as a single plugin to the user, please observe these rules:

  • Only one entry on the plugin portal should be created for all the nbms collectively
  • Metadata of all the individual nbms must correctly specify AutoUpdate-Show-In-Client property and module dependencies make sure there is exactly one user-visible item that installs all the others through dependencies
  • To submit the nbms to the plugin portal, pack them in a zip file and upload this zip file
Not logged in. Log in, Register

By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2012, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo