1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
|
<?xml version="1.0" encoding="UTF-8"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<?xml-stylesheet type="text/xml" href="../../nbbuild/javadoctools/apichanges.xsl"?>
<!DOCTYPE apichanges PUBLIC "-//NetBeans//DTD API changes list 1.0//EN" "../../nbbuild/javadoctools/apichanges.dtd">
<apichanges>
<!-- First, a list of API names you may use: -->
<apidefs>
<apidef name="general">Autoupdate Services API</apidef>
<!-- etc. -->
</apidefs>
<!-- ACTUAL CHANGES BEGIN HERE: -->
<changes>
<change id="enable-trusted-update-centers">
<api name="general"/>
<summary>KeyStoreProviders can now report which trustlevel they intent to supply</summary>
<version major="1" minor="62"/>
<date day="4" month="11" year="2019"/>
<author login="matthiasblaesing"/>
<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
<description>
<p>
The UpdateUnitProvider can now be declared trusted. If
UpdateItems are provided by a trusted UpdateUnitProvider
and can be linked to it (for example because the provider provides
checksums in the catalog), they are considered trusted by the Autoupdate
mechanism and will not trigger certificate warnings.
</p>
</description>
<class package="org.netbeans.api.autoupdate" name="OperationContainer"/>
</change>
<change id="keystores-for-validation">
<api name="general"/>
<summary>KeyStoreProviders can now report which trustlevel they intent to supply</summary>
<version major="1" minor="61"/>
<date day="4" month="11" year="2019"/>
<author login="matthiasblaesing"/>
<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
<description>
<p>
The validation of signatures of NBMs was done by checking if at least a partial certificate chain was present
and if that chain was valid (i.e. not expired, not revoked). Instead of relying on this partial check this
version bases the verification on a list of trusted certificates, similar to the existing KeyStoreProvider.
</p>
<p>
The existing KeyStoreProviders provide Certificates, that are fully trusted. The new getTrustLevel method
allows a KeyStoreProvider to provide certificate for the new, lower trusted level. In addition to the to
levels TRUST and VALIDATE, two variants: TRUST_CA and VALIDATE_CA are introduced. Certificates provided with
that level are expected to be CA certificates and they are only trusted if a `CertPathValidator` validates
the chain.
</p>
</description>
<class package="org.netbeans.api.autoupdate" name="OperationContainer"/>
</change>
<change id="missing-elements">
<api name="general"/>
<summary>Report parts of a feature which is not installed yet</summary>
<version major="1" minor="57"/>
<date day="30" month="11" year="2018"/>
<author login="sdedic"/>
<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
<description>
A distributed feature may list a module, which is only available on some update center, in NB IDE case because of
licensing issues. This token must be reported so the as part of the UpdateElement and Operation so the caller may
initiate the download operation.
</description>
<class package="org.netbeans.api.autoupdate" name="OperationContainer"/>
</change>
<change id="visible-ancestor">
<api name="general"/>
<summary>Find a visible ancestor of UpdateUnit</summary>
<version major="1" minor="37"/>
<date day="31" month="10" year="2012"/>
<author login="jrechtacek"/>
<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
<description>
<p>
Added a method {@link org.netbeans.api.autoupdate.UpdateUnit#getVisibleAncestor} which returns a visible plugin
which depending upon this unit. Returns a unit if this unit is installed in the system and some of visible
units depending upon this one, otherwise returns null.
</p>
</description>
<class package="org.netbeans.api.autoupdate" name="UpdateUnit"/>
<issue number="190246"/>
</change>
<change id="preffered-update">
<api name="general"/>
<summary>Mark an update as preferred just if needed</summary>
<version major="1" minor="33"/>
<date day="16" month="5" year="2012"/>
<author login="jrechtacek"/>
<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
<description>
<p>
Added a <code>preferredupdate</code> attribute into <code>Update Center Descriptor</code>
to specify if an update has to be installed before other updates or not. This flag is <b>off</b> as default.
</p>
</description>
<class package="org.netbeans.spi.autoupdate" name="UpdateItem"/>
<issue number="211734"/>
</change>
<change id="content-description">
<api name="general"/>
<summary>Added a method to get a descprition of content of Upadate Center</summary>
<version major="1" minor="33"/>
<date day="16" month="5" year="2012"/>
<author login="jrechtacek"/>
<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
<description>
<p>
{@link org.netbeans.api.autoupdate.UpdateUnitProvider#getContentDescription} returns
a description of content staging by this provider. The description might contains HTML tags e.g. HTML Links.
</p>
</description>
<class package="org.netbeans.api.autoupdate" name="UpdateUnitProvider"/>
<issue number="211741"/>
</change>
<change id="get-license-id">
<api name="general"/>
<summary>Added a method to get ID of license agreement</summary>
<version major="1" minor="33"/>
<date day="16" month="5" year="2012"/>
<author login="jrechtacek"/>
<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" semantic="compatible" source="compatible"/>
<description>
<p>
Added a method {@link org.netbeans.api.autoupdate.UpdateElement#getLicenseId}
to get ID of license agreement if the <code>UpdateElement</code> has a copyright.
</p>
<p>
This ID could be stored somewhere once an user approves the license and
will not be asked for approval again the same license ID.
</p>
</description>
<class package="org.netbeans.api.autoupdate" name="UpdateElement"/>
<issue number="211736"/>
</change>
<change id="check-write-permission">
<api name="general"/>
<summary>Check write permissions to installation directory</summary>
<version major="1" minor="33"/>
<date day="16" month="5" year="2012"/>
<author login="jrechtacek"/>
<compatibility addition="yes" binary="compatible" deletion="no"
deprecation="yes" semantic="compatible" source="compatible"
/>
<description>
<p>
<code>InstallSupport</code> find out the right directory where a plugin
should be installed. After that it checks if an user has privilege to write there.
In the case a lack of write permission, throws
{@link org.netbeans.api.autoupdate.OperationException.WRITE_PERMISSION}.
</p>
<p>
Beside this it allows to write into
<code>userdir</code> as a fallback in the case of insufficient privilege.
</p>
</description>
<class package="org.netbeans.api.autoupdate" name="InstallSupport"/>
<class package="org.netbeans.api.autoupdate" name="OperationException"/>
<issue number="211777"/>
</change>
<change id="nbm-external-size">
<api name="general"/>
<summary>Allowing to specify external NBM content size</summary>
<version major="1" minor="32"/>
<date day="14" month="5" year="2012"/>
<author login="jlahoda"/>
<compatibility addition="yes" />
<description>
<p>
You can now specify the size of the external NBM content in the <code>.external</code> file
by using <code>SIZE:</code> property (e.g. <code>SIZE:42</code>). The size will then be incorporated
in the download size of the NBM.
</p>
</description>
<issue number="212068"/>
</change>
<change id="nbm-external">
<api name="general"/>
<summary>External NBM contents</summary>
<version major="1" minor="24"/>
<date day="10" month="2" year="2011"/>
<author login="jtulach"/>
<compatibility addition="yes" />
<description>
<p>
You can now ask that publicly downloadable files be included in an NBM.
Just replace <code>netbeans/file</code> with a text file <code>netbeans/file.external</code>
with lines:
</p>
<ol>
<li><code>CRC:123456789</code> to specify an expected CRC-32 checksum (nonnegative decimal format)</li>
<li><code>URL:http://.../...</code> to specify a download location (may be repeated to offer alternatives)</li>
</ol>
<p>
You can embed system properties in a URL using Ant-like syntax: <samp>http://.../feature-for-${java.specification.version}.nbm</samp>
</p>
<p>
The <code><makenbm></code> Ant task will automatically
avoid packing the actual file if the <code>*.external</code>
variant is also in the input cluster.
</p>
<p>
For convenience, the <code>org.netbeans.modules.maven.embedder</code>
module (if present) can also handle URLs of the forms
<code>m2:/org.grp:art:1.0:jar</code> or <code>m2:/org.grp:art:1.0:jar:javadoc</code>
which can take advantage of the local repository as a cache.
</p>
</description>
<issue number="195041"/>
</change>
<change id="custom-icons">
<api name="general"/>
<summary>Icons for update centers</summary>
<version major="1" minor="23"/>
<date day="10" month="1" year="2011"/>
<author login="jtulach"/>
<compatibility addition="yes" binary="compatible" deletion="no"
deprecation="yes" semantic="compatible" source="compatible"
/>
<description>
<p>
Define icon when specifying an update center using
<code>categoryIconBase</code> attribute.
</p>
</description>
<class package="org.netbeans.api.autoupdate" name="UpdateElement"/>
<class package="org.netbeans.api.autoupdate" name="UpdateUnitProvider"/>
<issue number="183778"/>
</change>
<change id="source-group-modifier">
<api name="general"/>
<summary>Feature enabled only when all its dependencies are enabled</summary>
<version major="1" minor="8"/>
<date day="15" month="4" year="2009"/>
<author login="jtulach"/>
<compatibility semantic="incompatible"/>
<description>
<p>
The behaviour of <code>UpdateItem.createFeature().getInstalled().isEnabled()</code>
has been changed. Now it returns <code>true</code> only if
all dependencies are enabled.
</p>
</description>
<class package="org.netbeans.spi.autoupdate" name="UpdateItem"/>
<issue number="162673"/>
</change>
<change id="new-operation-container">
<api name="general"/>
<summary>New operation type introduced together with method for create appropriate container</summary>
<version major="1" minor="11"/>
<date day="19" month="8" year="2009"/>
<author login="dlipin"/>
<compatibility semantic="compatible"/>
<description>
<p>
New operation type - <code>OperationSupport.OperationType.INTERNAL_UPDATE</code> is introduced.
This operation can be used to find out elements which have updates and
which the particular element has the dependency on.
</p>
</description>
<class package="org.netbeans.api.autoupdate" name="OperationSupport"/>
<class package="org.netbeans.api.autoupdate" name="OperationContainer"/>
<issue number="141714"/>
</change>
</changes>
<!-- Now the surrounding HTML text and document structure: -->
<htmlcontents>
<!--
NO NO NO NO NO!
==============> DO NOT EDIT ME! <==============
AUTOMATICALLY GENERATED FROM APICHANGES.XML, DO NOT EDIT
SEE projects/projectapi/apichanges.xml
-->
<head>
<title>Change History for the Autoupdate Services API</title>
<link rel="stylesheet" href="prose.css" type="text/css"/>
</head>
<body>
<p class="overviewlink"><a href="overview-summary.html">Overview</a></p>
<h1>Introduction</h1>
<p>This document lists changes made to the <a href="@org-netbeans-modules-autoupdate-services@/index.html">Autoupdate Services API</a>.</p>
<!-- The actual lists of changes, as summaries and details: -->
<hr/>
<standard-changelists module-code-name="org.netbeans.modules.autoupdate.services"/>
<hr/><p>@FOOTER@</p>
</body>
</htmlcontents>
</apichanges>
|
