
MXI tag summary
7
About careful XML coding
XML files have fairly strict syntax requirements. When you’re creating or editing an extension
installation file, make sure that you use correct XML syntax:
•
Every attribute value must be enclosed in a single pair of double quotation marks. For example,
version = 1.0.0 and version = ""1.0.0""
are both incorrect syntax; instead, use
version = "1.0.0"
.
•
A tag defined as an empty tag (a tag with no contents) must end with
/>
. Do not include any
spaces between the slash and the closing angle bracket.
•
Each attribute name must be preceded by a space (or other form of white space). In particular,
if you use more than one attribute in a tag, you must put a space between each attribute’s value
and the next attribute’s name.
•
XML does not support special characters such as ampersands (&). To include an ampersand
within a tag, you must use the code
&
(for instance, to use ampersands in menu items or
other UI elements).
Encoding characters
If Extension Manager 5.0 can't get the explicit encoding information from the MXI file,
Extension Manager assumes that the MXI is encoded with the operating system default code
page. To avoid confusion, it is recommended to encode MXI with UTF-8 and explicitly declare
the encoding of MXI as UTF-8.
To declare that the MXI is encoded with UTF-8, do the following:
•
(Windows) Put the UTF-8 representation of the BOM at the head of the MXI file. The easiest
way to make sure of the presence of the BOM is to open the MXI file with Windows built-in
program Notepad and select File > Save As, then set Encoding as UTF-8. Note that it is not
enough to just specify <?xml version="1.0" encoding="UTF-8"?>
•
(Mac OS) Put the UTF-8 encoding declaration at the head of the MXI file. It is <?xml
version="1.0" encoding="UTF-8"?>.
MXI tag summary
The following table lists the primary tags available in the MXI file, briefly describes each tag, and
specifies whether the tag contains child tags. Use this table to get an overview of what tags are
available and what functions they perform.
Tag
Description
Contains Child Tags?
macromedia-extension
Main tag for extension installation file.
Yes
defaultLanguage
Default for multilingual extensions (version 2.1 and
later).
No
author
Name of the extension’s author.
No
description
Describes what the extension does.
No
update
Specifies extension update information (version 5.0
only).
No