Každý soubor PackageContents.xml musí obsahovat prvek ApplicationPackage. Prvek ApplicationPackage obsahuje obecné informace o modulu plug-in ve formě atributů XML. Také zahrnuje ostatní typy prvků, které pomáhají definovat obsah modulu plug-in.
K prvku ApplicationPackage mohou být připojeny kterékoli z následujících atributů:
|
Atribut |
Popis |
|---|---|
|
SchemaVersion |
Číslo verze formátu souboru PackageContents.xml. Hodnota by vždy měla být 1.0, dokud nebude zavedena novější verze schématu. |
|
AppVersion |
Číslo verze aplikace. Produkty založené na aplikaci AutoCAD a aplikace AutoCAD LT určují pomocí této hodnoty, zda je nainstalovaná verze nejnovější verzí. Pokud je k dispozici aktualizovaná verze, je o tom uživatel informován a může si nejnovější verzi stáhnout a nainstalovat. Verzi aplikace se doporučuje uvádět s použitím hlavních a vedlejších hodnot, například „1.0.0.0“. |
|
Author |
Jméno autora modulu plug-in. |
|
Name |
Název modulu plug-in. Název lokalizovaného modulu plug-in je možné určit kombinací položky Název a kódu národního prostředí. Úplný seznam kódů podporovaných národních prostředí najdete v části Kódy podporovaných národních prostředí – referenční seznam. |
|
Description |
Krátký popis modulu plug-in. Lokalizované popisy je možné určit kombinací položky Popis a kódu národního prostředí. Úplný seznam kódů podporovaných národních prostředí najdete v části Kódy podporovaných národních prostředí – referenční seznam. |
|
Icon |
Ikona pro modul plug-in, která se používá v aplikaci App Manager, v instalačním programu a na webu Autodesk App Store. Ikona by měla mít velikost 32 x 32 pixelů a podporovat 32bitovou hloubku barev (Truecolor). Doporučujeme použít formát souboru BMP nebo ICO. Poznámka: Všechny specifikátory cesty obsahují „/“, nikoli „\“, a cesty jsou relativní ke kořenové složce .bundle.
|
|
HelpFile |
Soubor nápovědy, která vysvětluje, jak se modul plug-in používá, a poskytuje další informace o modulu. Doporučuje se vytvořit část Jak postupovat s vysvětlením, jak se modul plug-in používá. Může se jednat o textový soubor ASCII, dokument HTML nebo soubor PDF, který obsahuje úplnou dokumentaci modulu plug-in nebo sadu odkazů na místa, kde je možné tento obsah najít online. Lokalizované soubory nápovědy je možné určit kombinací položky HelpFile a kódu národního prostředí. Úplný seznam kódů podporovaných národních prostředí najdete v části Kódy podporovaných národních prostředí – referenční seznam. Poznámka: Všechny specifikátory cesty obsahují „/“, nikoli „\“, a cesty jsou relativní ke kořenové složce .bundle.
|
|
ProductCode |
Jedinečný identifikátor GUID pro modul plug-in. Identifikátor GUID (který je nutné generovat pro každý jedinečný modul plug-in) se používá u upozornění při prvním spuštění a jako ID instalačního programu pro nástroj Přidat nebo odebrat programy v systému Windows při instalaci z webu Autodesk App Store. Atribut ProductCode by měl být aktualizován, pokud se změní atribut VerzeAplikace. Je to z toho důvodu, aby správně fungovaly instalace upgradů a zobrazilo se upozornění na upgrade při načtení do produktu založeného na aplikaci AutoCAD nebo do aplikace AutoCAD LT. V systému Windows můžete použít atribut ProductCode instalačního programu MSI nebo generovat identifikátor GUID pomocí aplikace, například GuidGen.exe. K dispozici jsou také webové stránky, které umožňují generovat identifikátor GUID. |
|
UpgradeCode |
Jedinečný identifikátor GUID pro modul plug-in, který se nesmí nikdy změnit. Web Autodesk App Store používá identifikátor GUID k umožnění upgradu ze starší verze modulu plug-in na novější bez nutnosti nejdříve odinstalovat modul plug-in. Poznámka: Aby bylo možné modul plug-in správně upgradovat, je třeba navýšit atribut VerzeAplikace.
|
Prvek ApplicationPackage může obsahovat nebo zahrnovat následující prvky: