Converter JAD para JAR

Um telefone ou emulador Java ME pode exigir um JAR, enquanto um download ou backup contém apenas seu descritor JAD. A tarefa usual é localizar o JAR correspondente, não converter o JAD, pois o descritor não contém o aplicativo propriamente dito.

O que é o formato JAD

JAD significa Java Application Descriptor. É um pequeno arquivo de texto simples usado por aplicativos Java ME para armazenar metadados como o nome do aplicativo, a versão, o fornecedor, a configuração necessária, a localização do JAR e o tamanho do JAR.

Telefones antigos da Nokia, Sony Ericsson, Samsung e outros telefones compatíveis com Java usam arquivos JAD durante a instalação; emuladores Java ME e aplicativos móveis arquivados também podem incluí-los. Abra um JAD em um editor de texto e procure entradas como MIDlet-Jar-URL: game.jar e MIDlet-Jar-Size: 123456. MIDlet-Jar-URL pode conter um nome de arquivo local, uma URL relativa ou uma URL absoluta de download.

O que é o formato JAR

JAR significa Java Archive. É um pacote baseado em ZIP que pode conter classes Java compiladas, imagens, recursos do aplicativo, um manifesto em META-INF/MANIFEST.MF e outros metadados. Para software Java ME, o JAR contém a parte executável; o JAD é um descritor de instalação opcional ou obrigatório, dependendo do dispositivo ou emulador.

Um JAR pode ser inspecionado com o 7-Zip ou com o utilitário jar do JDK. Abri-lo como ZIP não converte um JAD nem recria arquivos ausentes do aplicativo.

Como obter o JAR correspondente

1. Abra o JAD em um editor de texto e copie o valor completo de MIDlet-Jar-URL.
2. Se o valor for uma URL, baixe esse recurso do site ou repositório original. Se for um nome de arquivo, procure no mesmo download, na pasta extraída, no backup do dispositivo ou na distribuição original.
3. Verifique o arquivo baixado comparando-o com MIDlet-Jar-Size, que especifica o tamanho esperado em bytes. No Windows, clique com o botão direito do mouse no JAR, selecione Properties e compare a contagem de bytes.
4. Use o 7-Zip ou jar tf application.jar para confirmar que o arquivo contém arquivos do aplicativo, como arquivos .class e META-INF/MANIFEST.MF.
5. Copie o JAR para o telefone ou emulador. Mantenha o JAD quando o instalador exigir; não renomeie o JAR, a menos que o valor de MIDlet-Jar-URL seja alterado para corresponder.

Um JAR com o mesmo nome, mas com uma versão diferente do aplicativo ou um tamanho diferente em bytes, pode ser incompatível. Quando o JAR original estiver ausente, procure pelo nome de arquivo, versão e fornecedor exatos. Repositórios online e arquivos da web podem ajudar a localizar a distribuição original, mas não convertem um descritor em um aplicativo.

Como criar um novo JAR a partir dos arquivos do aplicativo

Se você tiver as classes compiladas e os recursos, instale um Java Development Kit e coloque esses arquivos na estrutura de diretórios de pacotes pretendida. No diretório que contém a saída da compilação, execute:

jar cf application.jar -C build/classes .

Para fornecer um manifesto, crie manifest.mf e execute:

jar cfm application.jar manifest.mf -C build/classes .

Isso cria um arquivo; não reproduz a compilação Java ME original. Aplicativos Java ME podem exigir pré-processamento, ofuscação, um manifesto específico, assinatura, processamento de recursos ou uma ferramenta de compilação específica do fornecedor. Um JAD que liste nomes de classes ou outros metadados não pode substituir código-fonte, classes compiladas, recursos ou chaves de assinatura ausentes.

Limites da conversão e ferramentas online

Um JAD geralmente não pode ser convertido em um JAR funcional. Ele contém metadados, não o conteúdo do aplicativo. Nenhum conversor online confiável pode recuperar classes e recursos ausentes do JAD, portanto, não é necessário enviar o descritor a um serviço de conversão, e isso pode expor metadados do aplicativo.

Se você possui apenas arquivos-fonte, use o ambiente de desenvolvimento Java ME original ou um processo de compilação compatível baseado no JDK, em vez de um conversor online. Se você possui um JAR existente, use o 7-Zip ou o comando jar do JDK para inspeção e reempacotamento; o reempacotamento pode invalidar assinaturas e alterar o comportamento da instalação.

Alguns telefones exigem ambos os arquivos e verificam se os valores do JAD, os dados do manifesto, o tamanho do JAR, a versão e as informações de assinatura estão de acordo. Quando a instalação informar um erro de tamanho, versão ou segurança, obtenha o par JAD/JAR original em vez de editar os metadados de forma indiscriminada.