Informações sobre o Descritor de Aplicativos (JAD)
Dados do artigo
Artigo
Contents |
Introdução
Cada arquivo JAR pode ser acompanhado por uma descrição do aplicativo (JAD - Java Application Descriptor). O arquivo JAD é usado em conjunto com o JAR manifesto pelo software de gerenciamento de aplicativos para gerenciar a(s) MIDlet(s) e é usado pelo MIDlet para configuração de alguns atributos específicos. O descritor permite que o software de gerenciamento de aplicativos no dispositivo verifique se a MIDlet é adequada para o dispositivo antes de carregar o arquivo JAR completo do Suite de MIDlets. Ele também permite a configuração de atributos específicos (parâmetros) a serem fornecidos para o(s) MIDlet(s) sem modificar o arquivo JAR.
Para permitir que os dispositivos disponibilizem o arquivo JAD para o software de gerenciamento de aplicações MIDP, uma extensão de arquivo e o tipo de MIME são registrados com a IANA:
- A extensão de arquivo de um arquivo descritor de aplicação é. Jad
- O tipo MIME de um arquivo descritor de aplicação é
text/vnd.sun.j2me.app-descriptor.
Um conjunto predefinido de atributos é especificado para permitir que o software de gerenciamento de aplicativos possa identificar, recuperar e instalar o(s) MIDlet (s). Todos os atributos que aparecem no arquivo descritor são disponibilizados para o(s) MIDlet (s). O desenvolvedor pode usar os atributos que não iniciam com MIDlet ou MicroEdition para necessidades específicas do aplicativo. Os nomes de atributos são maiúsculos e minúsculos e devem corresponder. Um atributo não deve aparecer mais de uma vez no manifesto. Se um atributo é repetido, o efeito é desconhecido. A MIDlet pode recuperar os atributos pelo nome, chamando o método MIDlet.getAppProperty().
Atributos obrigatórios
O arquivo JAD deve conter os seguintes atributos:
- MIDlet-Name: O nome da midlet/midlet suite
- MIDlet-Version: A versão da MIDlet
- MIDlet-Vendor: O fabricante da MIDlet
- MIDlet-Jar-URL: A URL no qual o arquivo .jar está disponível para download
- MIDlet-Jar-Size: O tamanho do arquivo .jar
Atributos opcionais
Os atributos listados abaixo são opcionais:
- MIDlet-<n> para cada MIDlet: O nome, ícone, e classe da MIDlet n no arquivo JAR separados por vírgulas. O valor mais baixo de <n> deve ser 1 e números ordenados consecutivos devem ser utilizados. A primeira entrada em falta termina a lista. Quaisquer entradas adicionais são ignoradas. Espaços a direita ou esquerda do nome, ícone ou classes são ignorados.
- MicroEdition-Profile: A versão da MIDP que está sendo utilizada. Ex. MIDP1.0
- MicroEdition-Configuration: A configuração que está sendo utilizada. Ex. CLDC1.0
- MIDlet-Description: Normalmente uma descrição breve sobre a MIDlet
- MIDlet-Icon: O nome do arquivo PNG que o arquivo JAR utiliza para representar a MIDlet Suite. É o ícone que o gerenciador de aplicativos (Application Management Software) mostra
- MIDlet-Info-URL: A URL para a descrição de informações da MIDlet Suite
- MIDlet-Data-Size: O tamanho de dados armazenados que pode ser utilizado. Ex. 1024
- MIDlet-Permissions: Zero ou mais permissões que são críticas para o funcionamento da MIDlet Suite.
- MIDlet-Permissions-Opt: Zero ou mais permissões que não são críticas para o Zero o funcionamento da MIDlet Suite.
- MIDlet-Push-<n>: Registra uma MIDlet para obter conexões de entrada
- MIDlet-Install-Notify: Uma URL para ser notificado após a instalação da MIDlet
- MIDlet-Delete-Notify: Uma URL para ser notificado após a remoção da MIDlet
- MIDlet-Delete-Confirm: Mensagem de confirmação no momento da remoção da MIDlet
- Quaisquer atributos específicos da aplicação que não iniciam com o prefixo MIDlet- ou MicroEdition- que podem ser lidos no nível de código-fonte.
(no comments yet)