This chapter includes the following sections:
Prior to the deployment of an extension, it has to be created and then packaged in an extension JAR file.
The steps to package and deploy an extension are as follows:
Learn how to package JDeveloper extensions for deployment.
When you create an extension project, an extension deployment profile to create an OSGi bundle is also created. For more information, see "Deployment Profiles" in Developing Applications with Oracle JDeveloper.
You set the OSGi bundle profile parameters from the Project Properties dialog.
To edit the deployment profile:
Once you have edited the deployment profile you can create the OSGi Bundle.
To create the OSGi Bundle:
The OSGi bundle containing your extension is created in the Oracle-home/jdeveloper/jdev/extensions
directory.
You can run and debug the OSGi bundle from this location automatically. For more information, see Testing and Debugging Extensions .
Learn how to deploy JDeveloper extensions.
Extensions can be distributed to a team by making them available on a file system, and having users install the extension using the Check for Updates wizard available from the Help menu. See "Working with Extensions".
Alternatively, you can make an extension available to a wider audience by hosting it on the Web somewhere, or you could have it hosted as an open source project so that other people can help you enhance your extension and further develop it.
Oracle hosts some JDeveloper third party extensions, which are available at http://www.oracle.com/technetwork/developer-tools/jdev/index-099997.html
. If you would like to upload your extension to this site, post a message on the JDeveloper and ADF forum at https://forums.oracle.com/forums/forum.jspa?forumID=83
.
Once you have written and tested an extension for JDeveloper you can make it available in a JDeveloper Update Center, from where users can download it and have it automatically install on top of their JDeveloper installation.
Update centers for JDeveloper extensions are online at http://www.oracle.com/technetwork/developer-tools/jdev/index-099997.html, including the Oracle JDeveloper Third Party Extension Exchange which lists extensions developed by third-party companies and individual developers.
For information about how users install updates using the JDeveloper Update Center, see Working with the Extension Manifest in Developing Extensions for Oracle JDeveloper.
In order for your extension to be installable using JDeveloper’s Check for Updates feature:This describes the bundle.xml
document which you need to deploy and distribute an extension.
bundle.xml
Create a document called bundle.xml similar to the following example.
Note:
The metadata inbundle.xml
must contain the u
namespace, as shown in the example below.<?xml version = '1.0' encoding = 'UTF-8'?> <update-bundle version="1.0" xmlns="http://xmlns.oracle.com/jdeveloper/updatebundle" xmlns:u="http://xmlns.oracle.com/jdeveloper/update"> <u:update id=" organization.dev.extension "> <u:name>Name of Extension</u:name> <u:version>1.0</u:version> <u:author>YourOrganization</u:author> <u:author-url> http://www.organization.com/dev/index.html/</u:author-url> <u:description>Provides support for a feature. </u:description> <u:requirements> <u:requires-extension id="oracle.jdeveloper" minVersion="12.1.2" maxVersion="12.2.1" /> </u:requires-agreement url="META-INF/agreement.html" /> </u:requirements> <u:destination>${oracle.home}</u:destination> </u:update> </update-bundle>
Important Elements and Attributes
oracle.home
, (default) the JDeveloper directory, for example, C:\oracle\middleware\jdeveloper
.oracle.mw.home
, which can be used when you want to install extensions or patches in the middleware home directory above the jdeveloper directory, for example, C:\oracle\middleware
.This describes the update center XML document which you need to distribute an extension from an update center through JDeveloper’s Check for Updates feature.
Update Center XML File
The update center file is similar to bundle.xml
but it has an additional element, bundle-url
, which specifies the location of the extension ZIP file. For more information about bundle-url
, see .
<?xml version = '1.0' encoding = 'UTF-8'?> <update-bundle version="1.0" xmlns="http://xmlns.oracle.com/jdeveloper/updatebundle" xmlns:u="http://xmlns.oracle.com/jdeveloper/update"> <u:update id=" organization.dev.extension "> <u:name>Name of Extension</u:name> <u:version>1.0</u:version> <u:author>YourOrganization</u:author> <u:author-url> http://www.organization.com/dev/index.html/</u:author-url> <u:description> </u:description> <u:requirements> <u:requires-extension id="oracle.jdeveloper" minVersion="12.1.2" maxVersion="12.2.1" /> </u:requires-agreement url="META-INF/agreement.html" /> </u:requirements> <u:destination>${oracle.home}</u:destination> <u:bundle-url> http://www.organization.com/dev/extension.zip/</u:bundle-url> </u:update> </update-bundle>