Każdy plik PackageContents.xml musi zawierać element ApplicationPackage. Element ApplicationPackage zawiera ogólne informacje dotyczące wtyczki w postaci atrybutów XML. Zawiera on również inne typy elementów, które ułatwiają zdefiniowanie zawartości wtyczki.
Do elementu ApplicationPackage może być dołączony dowolny z następujących atrybutów:
|
Atrybut |
Opis |
|---|---|
|
SchemaVersion |
Numer wersji formatu pliku PackageContents.xml. Należy zawsze używać wartości 1.0 do czasu wprowadzenia nowszej wersji schematu. |
|
AppVersion |
Numer wersji aplikacji. Produkty oparte na programie AutoCAD na podstawie tej wartości określają, czy zainstalowana wersja jest najnowszą wersją. Jeśli będzie dostępna zaktualizowana wersja, użytkownik zostanie o tym poinformowany i będzie mógł pobrać oraz zainstalować najnowszą wersję. Zaleca się używanie wersji aplikacji, która zawiera wartości główne i podrzędne, na przykład „1.0.0.0”. |
|
Author |
Nazwa autora wtyczki. |
|
Name |
Nazwa wtyczki. Aby wprowadzić zlokalizowaną nazwę wtyczki, można dołączyć do atrybutu Name kod regionalny. Zobacz sekcję Obsługiwane kody regionalne, aby uzyskać pełną listę obsługiwanych kodów regionalnych. |
|
Description |
Krótki opis wtyczki. Aby wprowadzić zlokalizowany opis, można dołączyć do atrybutu Description kod regionalny. Zobacz sekcję Obsługiwane kody regionalne, aby uzyskać pełną listę obsługiwanych kodów regionalnych. |
|
Icon |
Ikona wtyczki używana w instalatorze i witrynie Autodesk App Store. Ikona powinna mieć rozmiar 32x32 piksele i powinna obsługiwać 32-bitową głębię kolorów (Truecolor). Zaleca się używanie formatu pliku BMP lub ICO. Uwaga: Wszystkie ścieżki są określane przy użyciu znaków „/” (a nie znaków „\”) i są względne w stosunku do głównego folderu .bundle.
|
|
HelpFile |
Plik Pomocy, w którym wyjaśniono, w jaki sposób używać wtyczki, oraz przedstawiono dodatkowe informacje na temat wtyczki. Zaleca się umieszczenie w nim sekcji z instrukcjami dotyczącymi używania wtyczki. Plik może mieć postać pliku tekstowego ASCII, dokumentu HTML lub pliku PDF zawierającego całą dokumentację rozszerzenia lub odnośniki do lokalizacji online, w których mogą się znajdować odpowiednie informacje. Aby wprowadzić zlokalizowany plik Pomocy, należy dołączyć do atrybutu Helpfile kod regionalny. Zobacz sekcję Obsługiwane kody regionalne, aby uzyskać pełną listę obsługiwanych kodów regionalnych. Uwaga: Wszystkie ścieżki są określane przy użyciu znaków „/” (a nie znaków „\”) i są względne w stosunku do głównego folderu .bundle.
|
|
ProductCode |
Unikatowy identyfikator GUID wtyczki. Dla każdej unikatowej wtyczki musi zostać wygenerowany identyfikator GUID, który jest używany na potrzeby powiadomień przy pierwszym uruchomieniu oraz jako identyfikator instalatora w aplecie Dodaj/Usuń programy w systemie Windows po zainstalowaniu wtyczki z witryny Autodesk App Store. Atrybut ProductCode należy zaktualizować wraz ze zmianą atrybutu AppVersion. Pozwala to zapewnić poprawne działanie zainstalowanych aktualizacji oraz powoduje wyświetlenie powiadomienia dotyczącego aktualizacji przy wczytywaniu do produktu opartego na programie AutoCAD. W systemie Windows można użyć atrybutu ProductCode instalatora MSI lub wygenerować identyfikator GUID za pomocą aplikacji, takiej jak GuidGen.exe. Istnieją również strony WWW, które umożliwiają wygenerowanie identyfikatora GUID. |
|
UpgradeCode |
Unikatowy identyfikator GUID wtyczki, którego nie należy nigdy zmieniać. Identyfikator GUID jest używany w witrynie Autodesk App Store w celu umożliwienia aktualizacji starszej wersji wtyczki do nowszej bez konieczności odinstalowywania. Uwaga: Aby umożliwić poprawne uaktualnianie wtyczki, należy zwiększyć wartość atrybutu AppVersion.
|
Element ApplicationPackage może zawierać następujące elementy: