Application Extension Bundle description Language (AEBL)

An application extension bundle (AEB) encapsulates all the data required to extend an application. Often referred to as a plug-in or add-on, an AEB is a specific format designed to be application and platform agnostic. An application accepting an AEB is referred to as a target application. A key component of an AEB is descriptive metadata such as the AEB version, requirements, authors, etc. The application extension bundle description language (AEBL) is an RDF vocabulary for the metadata needed by an AEB.

The AEBL vocabulary is based on an RDF vocabulary used by the Mozilla XPInstall addon system, sometimes known as XPI. XPI is a compelling format containing much of the metadata needed for an AEB. However, the XPI format is tightly coupled to the Mozilla project and the description documents often refer to specific XPI engine implementation details. AEB and the AEBL standardize XPI and remove the Mozilla specific details. The original version of AEBL is nearly an exact copy of the XPI format with minor changes and clarifications. AEBL should, however, be considered a fork of XPI and further changes to XPI may not be reflected in AEBL.

Examples presented in this document will be presented in specific serializations of RDF such as rdf+xml and Notation3. The AEBL vocabulary is not restricted to these specific serializaions and any valid RDF serialization format should be considered equally valid for use with AEBL. Specific implementations of AEBL may be restricted to one or more serializations.

All examples assume the following prefixes . @prefix aebl: . ]]>

AEBL elements are defined in the AEBL namespace. The AEBL namespace is urn:2008:03:aebl-syntax-ns. This namespace is subject to change before acceptance of this Internet Draft as an RFC. The primary subject (the analog of an XML root element) is urn:aebl:install-manifest.

A unique identifier for the AEB. A UUID in the form {00000000-0000-0000-0000-000000000000} An Internet email style address as a string. This need not represent an existing email account but uses the same format. Ex. aebname@organization.tld The id shall not change when the version of an AEB changes. Version information is stored in the version verb.

The following regular expression matches an id.

The version verb identifies the version of the AEB. The format of the object shall conform to the specification in the version numbers section.

The type verb indicates the type of extension stored in the AEB. Valid types are listed below. Functionality extensions and general extensions not fitting another category Themes and skins which change the look of a GUI application Locale and language extensions which add additional natural language translations Multiple item AEB Types defined for a specific target application

The name verb indentifies the name of this AEB. This is designed to be presented to a user and shall not be used for comparison or unique identification purposes. The id verb is used to uniquely identify an AEB.

This verb defines a potential target application. There must be at least one targetApplication defined in an AEB and there may be multiple targetApplications defined in an AEB.

aebl:targetApplication [ aebl:id "{00000000-0000-0000-0000-000000000000}" ]. ]]>

This identifies the target application. The format is identical to the main id verb.

This identifies the minimum version of the target application required. The format is the same as the version verb.

This identifies the maximum version of the target application required. The format is the same as the version verb.

This is a short description of the AEB intended for display to the user. This should fit on one short line of text. A specific target application may impose more strict length requirements.

The creator verb identifies the name for the creator or prinicipal developer of the AEB. This is inteded for display to the user.

The developer verb identifies an additional developer of the AEB. The principal developer should be named with the creator verb. Additional developers are named with the developer verb. There must be one and only one creator verb if a developer verb is present. There is no limit to the number of developer verbs allowed but a target application may provide more strict limits. This is intended for display to the user.

The translator verb identifies language translators. There is no limit to the number of translator verbs allowed but a target application may provide more strict limits. This is intended for display to the user.

The contributor verb identifies additional contributor to the AEB. There is no limit to the number of contributor verbs allowed but a target application may provide more strict limits. This is intended for display to the user.

The URL for the AEB's homepage. If present, this must be a valid URL. This is intended for display to the user.

The URL for a 32x32 pixel icon intended for display to the user. This will typically be displayed in a list of AEBs in the target application. The icon should be a common image file format such as PNG, JPG, or ICO. A target application may further restrict the acceptable file types. Target applications must accept the AEB URL scheme and may accept other URL schemes.

The URL for a file containing license text. This is intended for display to the user. A target application may display this in any way but this will typically be displayed in an "accept/reject" dialog box during AEB installation. A target application must accept plain text files in UTF-8 format and may accept other file formats. A target application must accept the AEB URL scheme and may accept other URL schemes. There is no limit to the number of licenseURL verbs preset. All licenseURL files must be displayed but a target application may use any ordering.

This is a boolean value. If true, the AEB is considered a hidden AEB. A target application should not display this AEB in a list of installed AEBs. A target application may have a way to enable the display of hidden AEBs. This is intended to prevent the user from seeing or removing AEBs which are considered a core piece of a target application. Care should be used when marking an AEB as hidden. A target application may disallow hidden AEBs. The value is case insensitive. Valid positive values are: 1, t, and true. Valid negative values are: 0, f, and false.

This specifies the target platform for this AEB. There is no limit to the number of targetPlatform verbs allowed. This should contain either an operating system target or a complete application binary interface (ABI) target. A target application defines valid target strings. Some examples are WINNT, Linux, i686-pc-linux-gnu, and x86_64-msvc8.

This verb identifies another AEB requirement of this AEB. The format is identical to targetApplication but the target id refers to an AEB id. There is no limit to the number of requires allowed. A target application may install the AEB if a required target is not present but should disable the AEB until the target becomes available. In addition to the id, minVersion, and maxVersion verbs, requires may contain a targetApplication verb.

The format of this verb is identical to the higher level targetApplication verb. It is used to further restrict a requires. If present, it indicates that the requires only applies when the target application meets the specification of targetApplication. This is intended to specify AEB requirements which are different depending on the target application of the AEB.

This verb identifies extensions which are incompatible with this AEB. The format is identical to requires but the identified extension and version must not be present in the target application.

This URL provides an update manifest file with information about AEB updates. This URL should use the https scheme. If a non-secure scheme is specified, an updateKey should be specified. Further information on the format of this URL is presented in updates.

This contains a base64 encoded public key used to verify update signatures. The key is comprised of the encryption algorithm identifier, following by a colon then the base64 encoding. The data contained in the encoding is specific to the encryption algorithm identifier. A target application which does not support the specified encryption algorithm must refuse updates for this AEB. There may be multiple updateKey verbs each providing a key for a different encryption algorith. It is suggested that the updateURL use the https scheme and the updateKey verb not be used. Further information is presented in updates.

An example updateKey aebl:updateKey "x509:MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDK426erD/H3XtsjvaB5+PJqbhj Zc9EDI5OCJS8R3FIObJ9ZHJK1TXeaE7JWqt9WUmBWTEFvwS+FI9vWu8058N9CHhD NyeP6i4LuUYjTURnn7Yw/IgzyIJ2oKsYa32RuxAyteqAWqPT/J63wBixIeCxmysf awB/zH4KaPiY3vnrzQIDAQAB". ]]>

Version numbers are period separated version fields. A target application or AEB defines the specific meaning of various version fields. This document defines the format and comparison rules only. There must be at least one version field and there is no limit to the number of allowed version fields. Each version field is comprised of four parts: abcd. Parts a and c are integers greater than or equal to 0. Parts b and d are ASCII encoded strings. Part a is required. If part b, c or d is present, all parts to the left are required. A part may be an asterisk (*) indicating an infinite value for that part and is greater than all other values allowed for that part except * which is equal. If a part contains a * the parts to the right shall be ignored.

The following regular expression matches a version. Comparison of two versions is performed left to right. The first version field is compared and if equal, the next version field is compared. Missing or empty fields are equivalent to 0. Comparison of fields is performed left to right on each version part. The a and c fields are considered base 10 and are compared numerically. Parts b and d are ASCII encoded strings and are bytewise compared. An existing string part is always less than a nonexistent string part. A target application may interpret strings as case insensitive. A * is always greater than any other value in a part. The following example demostrates comparisons.

The aeb URL scheme (for example aeb:///icons/small.png) is used to reference files stored in an AEB. The root of an aeb URL refers to the root of the AEB archive as defined in .

An AEB may specify an updateURL which will return an update manifest. If the URL scheme supports MIME types (such as http and https) the MIME type of the update manifest must be a valid RDF MIME type such as text/rdf+xml. A target application may limit which RDF MIME types are accepted. The updateURL may contain the following values which will be substituted before requesting the manifest. Substitutions will be encoded as valid URLs. The request format version. Currently this is 1 The id of this AEB The version of the AEB The maxVersion specified in the AEB of the targetApplication requesting the update manifest A comma separated list of the status of installed AEBs. Each field is the id of the AEB, an equals (=) and a status string. A target application defines the status strings. If the corresponding status is supported by a target application, it should use the following strings. The AEB is enabled and functional. The user has disabled the AEB. The AEB is installed but is disabled because it is not compatible with either the target application version or one or more AEB versions. If the AEB target of the update manifest request is disabled due to incompatibility of another AEB version, this AEB is cause. Multiple AEBs may have this status. The AEB is installed but is disabled because it is missing one or more AEB dependencies. The id of the target application requesting the update manifest The version of the target application requesting the update manifest The OS and ABI platform of the target application requesting the update manifest. The specific format is defined by the target application. The locale of the target application requesting the update manifest The update manifest is an RDF file simlar to an install manifest. The namespace is the same as an install manifest and the primary subject is urn:aebl:update-manifest:aebid where aebid is the id of the AEB.

This contains the base64 encoded signature of the update manifest. This has the same format as updateKey. There may be multiple signature verbs which correspond to multiple updateKey verbs in the install manifest. The algorithm for generating and verifying a signature is determined by the cryptographic algorithm. The portion of the update that should be signed is the updates group.

This contains an RDF list with one list element per AEB version defined in the update manifest.

This declares the version of the AEB for this list element.

This declares the target application for this list element. There may be multiple targetApplication tags. The format is the same as with the addition of the following verbs.

This is the URL for the AEB corresponding to this version and targetApplication combination.

This is a URL for an informational page about this updated AEB. This is intended for display to the user.

This is the signature of the data obtained from . This is not needed if the URL scheme is secure (such as https) and follows the same rules and suggestions as signature.

An example update manifest 2.2 {ec8030f7-c20a-464f-9b0e-13a3a9e97384} 1.5 2.0.0.* https://www.mysite.com/foobar2.2.aeb http://www.mysite.com/updateinfo2.2.xhtml 2.5 {ec8030f7-c20a-464f-9b0e-13a3a9e97384} 1.5 2.0.0.* http://www.mysite.com/foobar2.5.aeb sha1:78fc1d2887eda35b4ad2e3a0b60120ca271ce6e6 x509:MIGTMA0GCSqGSIb3DQEBBQUAA4GBAMO1O2gwSCCth1GwYMgscfaNakpN40PJfOWt ub2HVdg8+OXMciF8d/9eVWm8eH/IxuxyZlmRZTs3O5tv9eWAY5uBCtqDf1WgTsGk jrgZow1fITkZI7w0//C8eKdMLAtGueGfNs2IlTd5P/0KH/hf1rPc1wUqEqKCd4+L BcVq13ad ]]>

. @prefix aebl: . aebl:id "{00000000-0000-0000-0000-000000000000}" ; aebl:name "Test AEB" ; aebl:version "1.2.3b" ; aebl:type "2" ; aebl:description "This is a test" ; aebl:creator "Trevor Clarke" ; aebl:updateURL "https://www.foo.bar/ack" ; aebl:iconURL "aeb:///icons/small.png" ; aebl:licenseURL "aeb:///licenses/lgpl.txt" ; aebl:licenseURL "aeb:///licenses/creativecommons.txt" ; aebl:targetApplication [ aebl:id "{12345678-0000-0000-0000-000000000000}" ; aebl:minVersion "1.2" ; aebl:maxVersion "1.*" ] ; aebl:targetPlatform "WINNT-x86_64-msvc8" . ]]>