Introduction

This document lists changes made to the Autoupdate Services API.


Index of APIs

Incompatible changes by date

Fuller descriptions of all changes can be found below (follow links).

Not all deprecations are listed here, assuming that the deprecated APIs continue to essentially work. For a full deprecation list, please consult the Javadoc.

All changes by date

Changes by version

These API specification versions may be used to indicate that a module requires a certain API feature in order to function. For example, if you see here a feature you need which is labelled 1.20, your manifest should contain in its main attributes the line:

OpenIDE-Module-Module-Dependencies: org.netbeans.modules.autoupdate.services > 1.20

Changes by affected class

org.netbeans.api.autoupdate.OperationContainer

org.netbeans.api.autoupdate.OperationSupport

org.netbeans.api.autoupdate.UpdateElement

org.netbeans.spi.autoupdate.UpdateItem

org.netbeans.api.autoupdate.UpdateUnitProvider


Details of all changes by API and date


Autoupdate Services API

External NBM contents

Feb 10 '11; API spec. version: 1.24; made by: jtulach; issues: #195041

You can now ask that publicly downloadable files be included in an NBM. Just replace netbeans/file with a text file netbeans/file.external with lines:

  1. CRC:123456789 to specify an expected CRC-32 checksum (nonnegative decimal format)
  2. URL:http://.../... to specify a download location (may be repeated to offer alternatives)

You can embed system properties in a URL using Ant-like syntax: http://.../feature-for-${java.specification.version}.nbm

The <makenbm> Ant task will automatically avoid packing the actual file if the *.external variant is also in the input cluster.

For convenience, the org.netbeans.modules.maven.embedder module (if present) can also handle URLs of the forms m2:/org.grp:art:1.0:jar or m2:/org.grp:art:1.0:jar:javadoc which can take advantage of the local repository as a cache.

Icons for update centers

Jan 10 '11; API spec. version: 1.23; affected top-level classes: UpdateElement UpdateUnitProvider; made by: jtulach; issues: #183778

Define icon when specifying an update center using categoryIconBase attribute.

New operation type introduced together with method for create appropriate container

Aug 19 '09; API spec. version: 1.11; affected top-level classes: OperationSupport OperationContainer; made by: dlipin; issues: #141714

New operation type - OperationSupport.OperationType.INTERNAL_UPDATE is introduced. This operation can be used to find out elements which have updates and which the particular element has the dependency on.

Feature enabled only when all its dependencies are enabled

Apr 15 '09; API spec. version: 1.8; affected top-level classes: UpdateItem; made by: jtulach; issues: #162673

The behaviour of UpdateItem.createFeature().getInstalled().isEnabled() has been changed. Now it returns true only if all dependencies are enabled.


Built on June 23 2014.  |  Portions Copyright 1997-2014 Sun Microsystems, Inc. All rights reserved.