Difference between revisions of "Creating update information for extensions"

From Apache OpenOffice Wiki
Jump to: navigation, search
 
(4 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
[[Category:Extensions]]
 
[[Category:Extensions]]
  
For publishing information about an available update one needs to provide the "update information". For more specific information please read the specification [http://specs.openoffice.org/appwide/packagemanager/online_update_for_extensions.odt "Online Update for Extensions"] and the Developer's Guide.
+
=OBSOLETE=
  
Some XML elements from the description.xml are also part of the update information (version, identifier, dependencies). To avoid maintaining a update information file, we provide a perl program that creates the file based on the description.xml. The program is contained in solenv/bin/make_ext_update_info.pl. The program can be used from a makefile. To facilitate this, there are these macros:
+
The script make_ext_update_info.pl and the respective makefile macros will not be maintained anymore and may be removed soon.
  
#EXTUPDATEINFO_NAME
+
When uploading an extension to http://extensions.services.openoffice.org then the update information will be automatically created.
#EXTUPDATEINFO_SOURCE
+
#EXTUPDATEINFO_URLS
+
 
+
==Using the Macros==
+
 
+
<pre>
+
EXTUPDATEINFO_NAME=org.openoffice.extensions.testarea.desktop.updateinfo.update.xml
+
EXTUPDATEINFO_SOURCE=description.xml
+
EXTUPDATEINFO_URLS = http://extensions.openoffice.org/testarea/desktop/updateinfocreation/update/updateinfo.oxt
+
 
+
.INCLUDE :  target.mk
+
</pre>
+
 
+
The name provided to EXTUPDATEINFO_NAME will be the name of the update information file. It will be created in the misc directory. The name should be close to the extension identifier, which is contained in the description.xml. Because the identifier can contain arbitrary tokens, not all identifier can be used as file names (for example an identifier containing a '/').
+
 
+
EXTUPDATEINFO_SOURCE is assigned to the description.xml. In the example the description.xml is in the same directory as the makefile. Would it be in a subdirectory then one would provide the relativ path.
+
 
+
EXTUPDATEINFO_URLS receives a list of URLs separated by spaces which are used to create the <update-download> section of the update information file. Each url points to the new version of the extension.
+

Latest revision as of 13:20, 18 September 2007

OOo Extensions project

Please view the wiki usage guidelines
before contributing.

Categories:

Pages:

Extensions on the main site

Extensions in other languages:
ES - FR - IT - JA - NL - OC -

OBSOLETE

The script make_ext_update_info.pl and the respective makefile macros will not be maintained anymore and may be removed soon.

When uploading an extension to http://extensions.services.openoffice.org then the update information will be automatically created.

Personal tools