Setup Applications

Este mais um artigo que submeto ao Linha de Cdigo, dando sequncia a uma srie de material, resultado obtido atravs de pesquisas e laboratrios com meus alunos da UTFPR, campus Medianeira. Reforo o empenho e dedicao destes alunos, que foi extremamente comprometido com a pesquisa e aprendizado durante os semestres que mantivemos contato prximo nas disciplinas que a eles eu ministrava. Isso me motivou muito e fazer com que o resultado dos trabalhos deles aparecesse para o mundo e, nada melhor do que o Linha de Cdigo para isso.
Neste artigo apresento o Marcos Roberto Bertuol, que pode ser contactado pelo email gjzero@gmail.com O Marcos foi meu aluno em algumas disciplinas de sua graduao e tem uma grande experincia no desenvolvimento de aplicaes WEB com PHP. Desta forma, estejam a vontade em solicitar o curriculum dele.

Este artigo o resultado de uma pesquisa do Marcos sobre a criao de instalador de aplicaes Windows Forms, para .NET, atravs do Visual Studio. O artigo traz um passo-a-passo para a criao de seu instalador.

Introduo
Quando se desenvolve aplicaes Windows Forms interessante a criao de um instalador para sua aplicao. possvel encontrar alguns aplicativos prontos que fazem tudo automaticamente, porm, o prprio Visual Studio oferece ferramentas para que o desenvolvimento fique todo centralizado nele. Usar o Setup Project do Visual Studio pode ser uma boa soluo para uma aplicao Windows, visto que o instalador ir descobrir quais as dependncias da aplicao e as incluir automaticamente.

Criando o Projeto
Aps a criao de um Setup Project, o resultado um arquivo *.msi, o qual instalar o(s) arquivo(s) da aplicao, e adicionar um atalho rea de Trabalho e outro ao menu de

Programas. A opo Setup Project se encontra em Other Project Types Setup and Deployment e a janela exibida semelhante apresentada pela Figura 1.

Figura 1 New Project

Criado o projeto, importante alterar o nome do Produto ao qual se est pretendendo criar o instalador. Isso pode ser feito atravs da propriedade Product Name. Selecione a aplicao criada no Solution Explorer e acesse a Properties Window para obter acesso a esta propriedade, que pode ser verificada na Figura 2.

Figura 2 Alterando o Product Name

Mais tarde poderemos ver o efeito desta mudana. Agora clique na pasta Application Folder com o boto direito do mouse e acesse em Add/File. Aqui adicionaremos os arquivos da aplicao para a qual se est criando o instalador. Sempre que alterarmos os arquivos adicionados ser preciso compilar novamente o projeto instalador. Ainda nesta pasta, tem-se a propriedade DefaultLocation (relativa ao local padro da instalao) que estar em: [ProgramFilesFolder][Manufacturer]\[ProductName]. Se for de preferncia, possvel mudar isto. A opo que vem por padro uma sugesto interessante, visto que as propriedades [Manufacturer] e [ProductName] podem ser alteradas conforme desejar. Logo, a aplicao ser instalada na pasta Arquivos de Programas (Program Files). Para o exemplo aqui trabalhado, criada uma aplicao simples no Visual Studio atravs de Windows Forms, e, quando adicionado o executvel ao Setup Project, repare no Solution Explorer que ele j reconhece a dependncia do Microsoft .NET Framework para executar a aplicao. No se assuste, se trata apenas de um pacote que inclui tudo que necessrio para executar aplicaes desenvolvidas utilizando o framework .NET. importante citar que o instalador no conseguir instalar a aplicao .NET sem o Framework. Agora vamos configurar para que o instalador crie automaticamente um atalho para a aplicao rea de Trabalho. Primeiro, clique na pasta User s Desktop e ento, dentro da

pasta, clique com o boto direito e selecione a opo Create New Shortcut, como mostra a Figura 3.

Figura 3 New Shortcut

Poder ser notada uma caixa de dilogo para selecionar a aplicao que se quer adicionar o atalho, como mostra a Figura 4. V at a pasta Application Folder e selecione o arquivo que foi adicionado anteriormente.

Figura 4 Arquivo do atalho

Ao clicar na pasta User s Desktop possvel notar algumas propriedades interessantes na janela Properties. interessante neste momento adicionar uma condio que verifica se o atalho j existe. Este um exemplo do que se pode fazer com um pequeno cdigo no projeto instalador. Mude a propriedade Always Create para true (ele ir criar o cone sempre que a condio for verdadeira). Aps isso, preciso adicionar uma condio para que o instalador no multiplique os atalhos a cada nova verso da aplicao. preciso ento configurar a propriedade Transitive para true e adicionar na propriedade Condition o seguinte trecho de cdigo: FILEEXISTS1<>"Shortcut to WFASetupApplication.exe", onde o que est dentro das aspas precisar ser exatamente o mesmo nome do atalho [1] . A expresso FILEEXISTS1<> nome vai verificar se j no existe um cone com o mesmo nome. Verifique a Figura 5.

Figura 5 Condio

Para adicionar o cone da sua aplicao ao atalho criado preciso adicionar o cone na pasta Application Folder atravs da opo Add/Item. Feito isso, v at o atalho na pasta User s Desktop e selecione-o. Na janela Properties veremos a propriedade Icon, clique na seta e selecione opo Browse. Na caixa de dilogo que ir abrir, clique novamente em browse, v at a pasta Application Folder e selecione o cone que acabou de adicionar. Para atalhos no menu Programas, v at a pasta User s Program Menu, clique com o boto direito e selecione a opo Add/Folder. Renomeie-a com o nome que quiser (lembrando que este o nome da pasta que aparecer no menu Programas), como apresentado pela Figura 6.

Ento, clique na nova pasta adicionada e adicione o atalho do mesmo modo como foi apresentado no passo anterior.

Figura 6 Program Menu

Quando for preciso criar um novo instalador para a prxima verso da sua aplicao, basta ir at as propriedades do Setup Project e mudar a propriedade Version antes de recompilar o projeto instalador, como pode ser visto na Figura 7.

Figura 7 - Version

Uma vez alterada a propriedade Version, quando sair dela receber uma mensagem prompt que lhe recomenda a alterao da propriedade ProductCode. Se no clicar em Yes, ter que fazer isso manualmente para que o instalador remova a aplicao antiga e instale a nova. Cuidado para no alterar a propriedade UpgradeCode. Se voc o fizer, o usurio da aplicao ter que remover o programa antigo manualmente antes que a nova verso seja instalada. Outra coisa interessante sobre o Setup Project do Visual Studio que ele adiciona automaticamente a sua aplicao Windows para o Adicionar/Remover Programas. Ento, uma vez instalado, voc pode ir at o Adicionar e Remover Programas e remover a aplicao, e ele limpar todos os arquivos e pastas que foram criados.

Testando o Projeto
Abaixo seguem alguns screens com o resultado final do nosso instalador:

Figura 8 - Principal

Repare, na figura 8, que o ttulo da aplicao o resultado da propriedade Product Name do nosso projeto.

Figura 9 Opes para instalao

Na Figura 9 tem-se opes interessantes, como a oportunidade de selecionar se quer instalar a aplicao apenas para o usurio ativo ou para todos que usam o computador. No passo seguinte ele apenas ir confirmar se deseja mesmo instalar a aplicao. Ao clicar em Next, ir iniciar a instalao e uma barra de progresso ser exibida. Aps o trmino, ir ver uma confirmao de que a aplicao foi instalada com sucesso. Se verificar em seu Desktop, ele agora possui o atalho criado com o cone que selecionou. O mesmo para o menu Programas, como mostrado na Figura 10.

Figura 10 Menu Programas

Concluso

Utilizar um Setup Project do VS pode ser uma boa opo para quem precisa de um instalador para sua aplicao, visto a facilidade e quantidade de opes que este tipo de projeto fornece ao desenvolvedor. Muito til e fcil, pode ser uma das melhores solues para quem quer uma instalao prtica e eficiente para seu programa.

Referncias
Artigos Tcnicos, MAS. http://www.mas.com.br/Artigos/ProjSetup.htm

[1] Trecho traduzido de: Visual Studio Windows Application Setup Project, CodeProject. http://www.codeproject.com/KB/dotnet/Win_App_Setup_Project.aspx?msg=3011803