Cada arquivo PackageContents.xml deve conter um elemento ApplicationPackage. O elemento ApplicationPackage, na forma dos atributos XML, contém informações gerais sobre o plug-in. Ele também encapsula outros tipos de elementos que ajudam a definir os conteúdos do plug-in.
Um elemento ApplicationPackage pode ter qualquer um dos seguintes atributos associados:
|
Atributo |
Descrição |
|---|---|
|
SchemaVersion |
Número de versão do formato PackageContents.xml. O valor deve ser sempre 1.0 até que uma versão mais recente do esquema seja introduzida. |
|
AppVersion |
Número de versão do aplicativo. Os produtos baseados em AutoCAD utilizam este valor para determinar se a versão instalada é a versão mais recente. Se uma versão atualizada estiver disponível, o usuário será informado e poderá baixar e instalar a versão atualizada. É recomendável usar uma versão do aplicativo que inclua valores maiores e menores, tais como “ 1.0.0.0 ”. |
|
Author |
Nome do criador do plug-in. |
|
Name |
Nome do plug-in. Um nome de plug-in localizado pode ser especificado usando a combinação de Nome com um código de localidade. Consulte a Referência de códigos de localidade suportados para obter uma lista completa de códigos de localidade suportados. |
|
Description |
Breve descrição do plug-in. As descrições localizadas podem ser especificadas usando a combinação de Descrição com um código de localidade. Consulte a Referência de códigos de localidade suportados para obter uma lista completa de códigos de localidade suportados. |
|
Icon |
Ícone para o plug-in; usado no instalador e no site da Autodesk App Store. O ícone deve ter 32x32 pixels de tamanho e suportar profundidade de cor de 32 bits (Truecolor). Recomenda-se usar um arquivo no formato BMP ou ICO. Nota: Todos os especificadores de caminho são '/' e não '\' e os caminhos estão relacionados à pasta .bundle da raiz.
|
|
HelpFile |
Arquivo de ajuda que explica como usar o plug-in e fornece informações adicionais sobre o plug-in. Recomenda-se criar uma seção "Como" que explique como usar o plug-in. O arquivo pode ser um arquivo de texto ASCII, um documento HTML ou um arquivo PDF que contenha toda a documentação para o plug-in ou que contenha um conjunto de redirecionamentos de onde o conteúdo pode ser localizado on-line. Os arquivos de ajuda localizados podem ser especificados usando a combinação do arquivo de ajuda com um código de localidade. Consulte a Referência de códigos de localidade suportados para obter uma lista completa de códigos de localidade suportados. Nota: Todos os especificadores de caminho são '/' e não '\' e os caminhos estão relacionados à pasta .bundle da raiz.
|
|
ProductCode |
GUID exclusivo para o plug-in. Um GUID deve ser gerado exclusivamente para cada plug-in e é utilizado para as primeiras notificações de execução e como o ID de instalador para Adicionar/Remover Programas no Windows quando instalado a partir do site da Autodesk App Store. ProductCode deve ser atualizado se AppVersion for alterado. Dessa forma, a instalação da atualização funciona corretamente e exibe uma notificação para atualização ao carregar um produto baseado em AutoCAD. No Windows, você pode usar o ProductCode do instalador MSI ou gerar um GUID usando um aplicativo como o GuidGen.exe. Também existem sites que permitem gerar um GUID. |
|
UpgradeCode |
O GUID único do plug-in nunca deve ser alterado. O GUID é utilizado pelo site da Autodesk App Store para permitir a atualização de uma versão anterior para uma versão mais recente de um plug-in sem a necessidade de primeiro desinstalar o plug-in. Nota: É preciso incrementar AppVersion para permitir a atualização correta do plug-in.
|
Um elemento do ApplicationPackage pode conter ou encapsular os seguintes elementos: