Converter SISX para JAR

Um telefone Symbian requer um instalador .sisx, enquanto um telefone Java ME requer um arquivo MIDlet .jar. A conversão geralmente é solicitada ao substituir um aplicativo Symbian antigo por uma versão Java ME, mas o executável existente não pode ser transformado diretamente.

O que é o formato SISX

SISX é o formato de pacote do Symbian Installation System usado pelo Symbian OS e por dispositivos S60, incluindo muitos smartphones Nokia. Os desenvolvedores usavam ferramentas como makesis para criar pacotes SIS e signsis para aplicar certificados e assinaturas; os distribuidores normalmente forneciam aplicativos assinados com a extensão .sisx.

Um pacote SISX contém executáveis Symbian, recursos, dados de configuração, certificados e instruções de instalação. Ele é um instalador para o runtime Symbian, não um arquivo genérico nem bytecode Java. Proprietários e desenvolvedores de telefones Symbian são os principais usuários desse formato.

O que é o formato JAR

Na categoria Mobile platforms, JAR significa Java Archive, usado para distribuir aplicativos Java ME, também chamados de MIDlets. Um JAR Java ME normalmente contém arquivos de classe Java compilados, imagens, sons, outros recursos e um manifest que identifica o aplicativo.

As instalações Java ME geralmente usam um arquivo Java Application Descriptor correspondente, .jad. O JAD registra metadados como o nome do MIDlet, a versão, o fornecedor, o tamanho do JAR e a URL de download. Um JAR também deve conter uma entrada MIDlet válida e bytecode compatível com os perfis CLDC e MIDP de destino; alterar a extensão ou reempacotar arquivos não relacionados não atende a esses requisitos.

Por que a conversão direta não funciona

Não existe uma conversão executável SISX para JAR confiável. Um pacote Symbian contém binários compilados para APIs Symbian e hardware, enquanto um JAR Java ME contém classes Java compiladas para um runtime CLDC/MIDP. Um conversor de arquivos, utilitário de arquivamento ou alteração da extensão não pode traduzir o código de máquina nativo do Symbian, o código da interface do usuário, as permissões e os serviços do sistema operacional em um MIDlet funcional.

Nenhum conversor online confiável pode realizar essa tradução. Os serviços online que afirmam converter SISX em JAR podem, no máximo, renomear, extrair ou reempacotar dados, e o envio de software comercial assinado ou código proprietário cria riscos de segurança e licenciamento.

Maneiras práticas de obter um JAR

1. Encontre uma versão Java ME existente. Verifique com o desenvolvedor original, um arquivo de software autorizado ou um arquivo de preservação se há um .jar separado e um .jad correspondente. Se o aplicativo foi lançado para Symbian e Java ME, a versão Java é uma compilação separada, não uma conversão.
2. Instale o SISX diretamente. Se o destino for um dispositivo Symbian compatível, transfira o pacote e instale-o usando o gerenciador de arquivos ou o instalador de aplicativos do telefone. O dispositivo poderá rejeitar pacotes com assinaturas inválidas, certificados expirados ou requisitos de plataforma não compatíveis.
3. Faça o port do aplicativo a partir do código-fonte. Obtenha o projeto Java ME original ou reescreva o aplicativo para o perfil Java ME de destino. Substitua APIs Symbian, bibliotecas nativas, componentes de UI, permissões e serviços específicos do dispositivo por código compatível com CLDC/MIDP. Um arquivo SISX, por si só, não fornece o código-fonte necessário para um port automático.

Como inspecionar ou reconstruir arquivos

1. Use SISContents no Windows para inspecionar ou extrair o conteúdo do pacote quando disponível. O 7-Zip pode abrir alguns arquivos SISX, mas não interpreta as instruções de instalação do Symbian e pode não extrair todos os componentes corretamente.
2. Abra o código-fonte Java ME em um SDK Java ME compatível, como o Oracle Java ME SDK 8.3, quando os perfis compatíveis corresponderem ao dispositivo de destino, ou use o antigo Java ME Wireless Toolkit para projetos MIDP legados. Essas ferramentas compilam o código-fonte em classes compatíveis com o dispositivo e executam a preverification necessária.
3. Crie o MIDlet com um manifest contendo entradas como MIDlet-Name, MIDlet-Version, MIDlet-Vendor e pelo menos uma entrada MIDlet-1 que identifique a classe, o ícone e o nome do MIDlet.
4. Empacote a saída compilada e preverified com o SDK. Um comando genérico como jar cfm app.jar manifest.mf -C build/classes . cria um arquivo, mas não compila nem executa a preverification do código Java ME; o processo de empacotamento do SDK é mais seguro para um dispositivo real.
5. Crie o JAD e defina MIDlet-Jar-Size como o tamanho exato, em bytes, do JAR final. Teste a instalação no telefone de destino ou em um emulador correspondente. Assine o JAR e o JAD com certificados Java ME se o aplicativo solicitar APIs protegidas; uma assinatura SISX do Symbian não pode ser reutilizada.

Se os recursos extraídos precisarem ser armazenados em um JAR para fins de arquivamento, um comando como jar cf resources.jar -C extracted-files . criará apenas um arquivo. Ele não criará um aplicativo Java ME instalável.

Limitações de compatibilidade

Um port no nível do código-fonte pode exigir compilações separadas para diferentes versões de CLDC e MIDP, tamanhos de tela, métodos de entrada, recursos gráficos, pilhas de rede e políticas de segurança. Aplicativos Symbian que dependem de hardware nativo, serviços em segundo plano, funções de telefonia ou frameworks de UI específicos do Symbian podem não ter uma implementação Java ME equivalente.

Renomear .sisx para .jar, abrir o conteúdo do SISX com um programa de arquivamento ou colocar binários Symbian dentro de um JAR não altera o formato do executável. Use uma versão Java ME separada, instale o pacote original em hardware Symbian compatível ou reconstrua o aplicativo a partir de código-fonte adequado.