vb Inno Script Conversor vb Inno Script Conversor Copyright© 2006-2007, Lizaro Soft Lizaro Soft – All rights Reserved 1 vb Inno Script Conversor 2 1 Descrição O vb Inno Scrip Conversor é um conversor de projetos de Visual Basic em script do Inno Setup. O software permite criar script do Inno Setup a partir de um projeto do Visual Basic em poucos instantes, alem de implementar algumas funções. 2 Nota Desta Versão Data: 01/5/2007 Nesta versão foram adicionadas novas funções: ➔ Adicionada a função de inserção de código Pascal, para maior implementação do pacote de instalação; ➔ Inserida a função de compilação do pacote diretamente do programa (ainda em fase Beta); ➔ Implementada a função de atualização do projeto (ainda em fase Beta); ➔ Implementada a ferramenta de gerenciamento de código Pascal; ➔ Implementada a função que inclui o nome do executável na lista de arquivos do programa; ➔ Implementada a função que inclui a referência de ícone do executável na lista de ícones do programa; ➔ Implementadas novas funções no tela de opção; ➔ Substituição do componente do menu cPopMenu por HookMenu, devido a bugs; ➔ Implementada a documentação do programa; ➔ Correção de bugs das versão anterior. 2.1 Histórico Data: 01/5/2007 Lançada versão final do programa. Esta versão está estável. Data: 13/8/2006 Lançado o segundo Beta (v1.0 Beta 2) do programa. Esta versão está ainda mais estável, entretanto incompleta. Data: 1/5/2006 Lançado o primeiro Beta (v0.05 Beta 1) do programa. Por ter sido a primeira versão estável tornou-se o Release Candidate 1 (RC1). Data: 29/4/2006 Estamos no primeiro Beta 1 (RC1), com: » As funções de salvar e ler arquivos já implementadas; » Associação de arquivos com extensão isc ao programa; » Início da implementação da abertura do arquivo isc (Lizaro Inno Script Projeto codinome) através do Windows Explorer. Data: 25/4/2006 Estamos no Pré-Beta 1 do software vb Inno Script Conversor, os detalhes do desenvolvimento da ferramenta podem ser conferidos clicando na figura abaixo. Esperamos em breve estar liberando o download do beta para teste. vb Inno Script Conversor 3 Data: 22/4/2006 Disponibilizada a página do software vb Inno Script Conversor, incluindo as novidade do projeto: O projeto encontra-se na fase pré-beta e estamos avançando bem no desenvolvimento da ferramenta de geração de scripts. 3 Licença de Uso da Biblioteca 3.1 Licença: Este software poderá ser instalado em quantas máquinas o usuário desejar, sem necessidade de licença e/ou registro, entretanto para cada máquina que este software for instalado, há necessidade de requerer nenhuma licença/registro. Distribuído sob a licença Creative Commons License http://creativecommons.org/licenses/by-nc-nd/2.5/br/ 3.2 Advertências e Direitos Autorais: Modificações, descompilação ou outra forma que afetem a integridade autoral do software constitui crime e o infrator será punido no maior rigor da lei. 3.3 Nota Legal: A Lizaro Soft (W.C. Rodrigues), detém todos os direitos sobre este software (vb Inno Script Conversor), portanto a distribuição e/ou venda deste ou de parte deste sem a autorização expressa da Lizaro Soft (W.C. Rodrigues), constitui crime. 4 Pré-Requisitos ➔ ➔ ➔ ➔ ➔ Os pré-requisitos para o funcionamento são: Microsoft Visual Basic® 6.0 (Run-Time) Service Pack 6 – vem junto com Windows ME, XP, Vista. Sistema Operacional: Windows 98, 2000, ME, XP, Vista. Processador: 533 MHz Memória RAM: 64MB Arquivos necessários: MSVBVM60.dll (SP6); MSComctl.ocx e Richtx32.ocx vb Inno Script Conversor 4 5 Tela Principal A tela principal é composta basicamente do menu, barra de ferramenta, painel de tarefas e sub- telas a direita do painel, que são alteradas a medida que as opções do painel são clicadas (Figura Abaixo). Figura 1. Tela principal do programa vb Inno Script Conversor (RC1) 6 Painel de Tarefas ➔ ➔ O painel é composto das seguintes tarefas e suas funções: Dados Gerais – Dá acesso aos dados gerais do projeto Visual Basic®, tais como: nome do projeto; Caminho; título; versão do projeto; nome do executável; Descrição do projeto; Empresa; Descrição do arquivo executável; Direitos autorais; Marcas registradas e nome do produto. Componentes e Referências – Lista todos os componentes e referências do projeto. Vala a pena ressaltar que as DLL's1 devem estar em diretório diferente do diretório 1 DLL = Dynamic Link Library – Biblioteca de Ligação Dinâmica vb Inno Script Conversor ➔ ➔ ➔ ➔ ➔ ➔ 5 do sistema, devido a restrições do compilador do Inno Setup. Arquivos do Programa – São listados os arquivo selecionados como do programa que não possuem referência direta dentro do projeto do Visual Basic. Este arquivos podem ser: arquivos de ajuda, banco de dados, arquivos de configuração, imagens, e outros arquivos a serem utilizados pelo programa. O arquivo executável é listado como padrão ao carregar o projeto do Visual Basic, os demais arquivos devem ser inserido manualmente pelo usuário. Ícones do Programa – São listados os ícones do programa. Como padrão ao acessar um projeto do Visual Basic o programa referencia somente os ícones referentes ao programa e ao desinstalador; Adicionar Código – Essa opção permite a adição de código em Pascal, compatível com o compilador Inno Setup, os códigos podem ser gerenciados através da ferramenta Gerenciar Código; Configurações do Setup – Essa opção permite que o usuário indique as seguintes configurações do script: Arquivo de destino (a ser compilado), Diretório padrão (onde o o programa será instalado), Grupo Padrão (Onde serão criados os ícones no menu iniciar) e os arquivos de mensagem que será exibido no instalador. Nesta opção o usuário poderá acessar o editor de texto interno do programa, facilitando a criação e edição dos textos. Gerar Script do Inno Setup – Gera o script no formato do Inno Setup. Nesta sub-tela é possível salvar o script no formato do do Inno Setup e abrir no próprio Inno Setup ou no IsTool, compilar com o InnoSetup e por fim é possível imprimir o script. As opções para executar e compilar é necessário a configuração do caminho dos aplicativos, nas opções do programa. Gerar e Salvar Script do Inno Setup – Gera o script e abra a caixa de diálogo para salvar o script. 7 Componentes e Referências O s componentes e referências do projeto do Visual Basic, são listado num grade, onde são especificadas as seguintes informações: nome do arquivo do componente, caminho do componente, data de atualização, tipo e a versão. Nesta tarefa é possível incluir ou excluir componente,mas não é permitido editar. 8 Arquivos do Programa O s arquivos do programa são listados nesta sub-tela e como padrão é inserido o nome do executável do projeto Visual Basic. É possível incluir, editar e excluir itens desta tarefa. 9 Ícones do Programa O s icones do programa em parte são gerados pelo programa, são eles o ícone da area de trablaho, do grupo do progra ae de desinstalação. Os demais ícones poderão ser inserido manualmente pelo usuários. É possível incluir, editar e excluir itens desta tarefa. vb Inno Script Conversor 6 10 Adicionar e Gerenciar de Códigos P ara adicionar um código é necessário adiciona-los. O programa já possuem alguns, as outros poderão ser inseridos através da ferramenta de Gerenciamento de Códigos, conforme a figura abaixo. A adição de código poderá ser feita através do painel de tarefas, na opção adicionar código. A ferramenta de Gerenciamento de Códigos permite que o usuário armazene, edite ou exclua códigos em Pascal, compatível com o compilador do Inno Setup. O gerenciador pode ser acessado através do menu Ferramentas. Figura 2. Tela de gerenciamento de código do vb Inno Script Conversor 11 Configuração do Setup N essa opção permite que o usuário indique as seguintes configurações do script: Arquivo de destino (a ser compilado), Diretório padrão (onde o o programa será instalado), Grupo Padrão (Onde serão criados os ícones no menu iniciar) e os arquivos de mensagem que será exibido no instalador. Nesta opção o usuário poderá acessar o editor de texto interno do programa, facilitando a criação e edição dos textos. vb Inno Script Conversor 7 12 Editor de Texto Interno O editor interno de texto possui opções básicas, porém suficiente para a edição de arquivo a serem utilizados como o arquivo Leia me, para exibição antes e depois da instalação. Na página de tarefa de configuração do programa é possível abrir o arquivo diretamente no Editor de Texto interno. Nele é possível ter praticamente as mesmas funções do editor de texto Microsoft WordPad®. Figura 3. Editor Interno de Texto do vb Inno Script Conversor 13 Gerador de Script P ara gerar um script no padrão do Inno Setup é necessário preencher todos os campos, ou seja, a listagem de componentes e referência do programa, os arquivos do programa, ícones do programa, arquivo de licença, etc. Existem duas opções de geração do script no programa, que encontram-se no painel de tarefa, a primeira somente gera o script a segunda além de gerar ainda abra a caixa de diálogo para que o usuário possa salvar o script. Na tela de script é possível ainda salvar e abrir e abrir o arquivo no Inno Setup, salvar e abrir o arquivo no IsTool, desde que os programa estejam instalados na máquina do usuário. vb Inno Script Conversor 8 Nesta tela ainda é possível realizar a compilação direto do programa vb Inno Script Conversor, através do InnoSetup. Para um compilação sem erros consulte o arquivo de ajuda do InnoSetup e veja as informações sobre o Unsafe Files. Os arquivos considerados como Unsafe Files segundo a documentação do InnoSetup são: ADVAPI32.DLL, COMDLG32.DLL, GDI32.DLL, KERNEL32.DLL, RICHED32.DLL, SHELL32.DLL, USER32.DLL, UXTHEME.DLL, COMCAT.DLL, MSVBVM50.DLL, MSVBVM60.DLL, OLEAUT32.DLL, OLEPRO32.DLL, STDOLE2.TLB, SHDOCVW.DLL, SHLWAPI.DLL, URLMON.DLL e WININET.DLL. Portanto esses arquivo não são distribuíveis. Vale a pena ressaltar que as DLL's que constam no diretório de sistema e que são referenciados pelo projeto em Visual Basic, devem possuir uma cópia com mesma versão num diretório a parte (Ex.: C:\VBFiles), evitando assim erro na compilação. Exceto as declaradas como Unsafe Files, que não devem ser referenciadas no projeto de compilação (script). Figura 4. Script gerado a partir de projeto em Visual Basic® do vb Inno Script Conversor 14 Opções do Programa N as opções do programa encontra-se em duas partes. As opções gerais do programa e os Flags do InnoSetup (Veja as Figuras 5 e 6). vb Inno Script Conversor Figura 5. Opção geral do programa vb Inno Script conversor Figura 6. Opção dos Flags do programa InnoSetup 9 vb Inno Script Conversor 10 Na opção geral o usuário poderá configurar o caminho do InnoSetup e do Istool, alé, de poder configurar o estilo do menu da janela principal e do Editor de Texto interno.(Figura 5) Na opção do InnoSetup, o usuário poderá selecionar os Flags padrão a ser inseridos nos componente ao ser gerado o script (Figura 6). Copyright© 2006-2007, Lizaro Soft (W.C. Rodrigues) Esta obra está licenciada sob uma Licença Creative Commons http://creativecommons.org/licenses/by-nc-nd/2.5/br Entomologistas do Brasil – www.ebras.bio.br Lizaro Soft – www.lizarosoft.ebras.bio.br ***** Informações do Documento Atualizado em: 1 de Maio de 2007as 17:02:07 Criado por: William Costa Rodrigues Título: Arquivo de Documentação do softtware vb Inno Script Conversor Arquivo: vbInnoScript.odt Estatísticas: Número de Páginas: 10 Parágrafos: 119 Palavras : 1754 Caracteres: 10950 Revisão nº: 81 Tempo de edição total: 06:19:51 Revisado por: William Costa Rodrigues Figuras: 9