Objectivos: Criar um programa de instalação do projecto desenvolvido

Tarefa Orientada 7 Criação de um programa de instalação Objectivos: Criar um programa de instalação do projecto desenvolvido Nesta tarefa iremos criar um programa de instalação (setup program) para a aplicação desenvolvida nas tarefas orientadas anteriores. Depois, pode-se executar este programa em vários computadores para instalar a aplicação. Note-se que criar um programa de instalação pode ser um processo complexo, que varia de caso para caso. Esta tarefa permite apenas ficar com uma visão geral. Assim, se necessário, deve fazer alguma investigação adicional antes de criar os seus programas de instalação. Para criar um programa de instalação pode utilizar um projecto de instalação (Setup Project). Um programa de instalação é um tipo de aplicação que é utilizado para instalar outras aplicações. 1. Para criar um Setup Project, abra a solução que contém a aplicação que pretende distribuir (desenvolvida nas tarefas orientadas anteriores). Seleccione a opção Add do menu File. Depois, seleccione o comando New Project. Microsoft Visual Studio 2005 1

Vai ser mostrada a caixa de diálogo Add New Project. 2. Na secção Project types da caixa de diálogo Add New Project, expanda o grupo Other Project Types e seleccione a opção Setup and Deployment. 3. Na secção Templates da caixa de diálogo Add New Project, seleccione a opçõ Setup Project. 4. Introduza um nome e uma localização para o projecto de instalação e pressione o botão OK. Quando se cria um setup project, ele é adicionado à solução que contém o projecto para o qual se pretende criar um programa de instalação. Note-se que quando se cria um novo projecto para ser distribuido através de um programa de instalação, deve-se criar uma pasta diferente para a solução que contém o projecto. Desse modo, a pasta do novo projecto e a pasta do setup project vão ficar ambas na pasta da solução. Microsoft Visual Studio 2005 2

Após ter sido criado o setup project, pode utilizar os editores de instalação (setup editors) para customizar o projecto. Quando acaba de criar um setup project, é mostrado o File System Editor no lado esquerdo da janela do Visual Studio. Pode utilizar este editor para, por exemplo, adicionar ficheiros de saída ao projecto de instalação. No lado esquerdo do File System Editor pode visaulizar três pastas que representam a pasta (Application Folder) onde as aplicações são instaladas no sistema do utilizador, a pasta (User s Desktop) que contém os itens que são mostrados no ambiente de trabalho do utilizador, e a pasta (User s Programs Menu) que contém os itens que são mostrados no menu programas do utilizador. Um setup project deve incluir, pelo menos, a saída principal do projecto para o qual pretendemos criar o programa de instalação, que é o seu ficheiro executável (.exe). Na maioria dos casos, este ficheiro é adicionado à pasta Application Folder. Microsoft Visual Studio 2005 3

5. Para adicionar, ao setup project, o ficheiro executável da aplicação que pretende distribuir, pressione, com o botão direito do rato, sobre a pasta Application Folder e seleccione o comando Add. Depois seleccione a opção Project Output. Vai ser mostrada a caixa de diálogo Add Project Output Group. 6. Na caixa de diálogo Add Project Output Group, selecccione a saída que pretende adicionar e pressione o botão OK. Microsoft Visual Studio 2005 4

Como resultado do passo anterior, se seleccionar a pasta Application Folder, vai visualizar o ficheiro no lado direito do File System Editor. 7. Para adicionar, ao setup project, outros ficheiros, tais como ficheiros de configuração da aplicação, ficheiros de bases de dados, ficheiros leiame, ficheiros de imagens, etc., pressione com o botão direito do rato sobre a pasta apropriada do File System Editor. Neste caso, pressione com o botão direito do rato sobre a pasta Application Folder e seleccione o comando Add. Depois seleccione a opção File. Microsoft Visual Studio 2005 5

Vai ser mostrada a caixa de diálogo Add Files. 8. Seleccione os ficheiros BotãoInvestimento.jpg, BotãoDesvalorização.jpg, Pôr do sol.jpg e Diamond.ico e pressione o botão Open. Como resultado do passo anterior, se seleccionar a pasta Application Folder, vai visualizar os ficheiros no lado direito do File System Editor. Microsoft Visual Studio 2005 6

Também é comum incluir num projecto de instalação atalhos (shortcuts) para a aplicação. Por exemplo, quando a aplicação é instalada, pode pretender adicionar um atalho para a aplicação no ambiente de trabalho ou no menu programas do computador do utilizador. 9. Para adicionar um atalho para a aplicação no ambiente de trabalho, ou no menu programas do computador, quando a aplicação for instalada, pressione, com o botão direito do rato, sobre o ficheiro executável da aplicação (adicionado ao setup project no passo 5) e seleccione o comando Create Shortcut to Primary output from Aplicação Financeira. Como resultado do passo anterior, se seleccionar a pasta Application Folder, vai visualizar também o atalho para o ficheiro executável da aplicação no lado direito do File System Editor. Microsoft Visual Studio 2005 7

10. Para definir um nome apropriado para o atalho adicionado no passo 9, selecione-o, com o botão direito do rato, e escolha o comando Rename. Por exemplo, pode estabelecer o nome Aplicação Financeira para o atalho. Depois de nomear devidamente o atalho, pode movê-lo para as pastas User s Desktop e/ou User s Programs Menu do File System Editor. 11. Mova o atalho para a pasta User s Desktop. Depois, seleccione essa pasta. Microsoft Visual Studio 2005 8

12. Também pode adicionar um icone ao atalho que acabou de incluir na pasta User s Desktop do File System Editor. Para tal, seleccione o atalho com o botão direito do rato e escolha o comando Properties Window. 13. Seleccione o atalho. Na janela de propriedades, seleccione a opção Browse da propriedade Icon. Vai ser mostrada a caixa de diálogo Icon. 14. Pressione o botão Browse. Microsoft Visual Studio 2005 9

Vai ser mostrada a caixa de diálogo Select Item in Project. 15. Na caixa de combinação Look in da caixa de diálogo Select Item in Project, seleccione Aplication Folder. 16. Seleccione o ficheiro Diamond.ico e pressione o botão OK. Microsoft Visual Studio 2005 10

Vai ser novamente mostrada a caixa de diálogo Icon. 17. Pressione o botão OK. 18. Suponha agora que, quando se instala a aplicação, pretende também criar um atalho no menu Aplicação Financeira do menu programas. Para tal, seleccione, com o botão direito do rato, a pasta User s Programs Menu do File System Editor. Depois, seleccione a opção Folder do comando Add para criar uma sub pasta da pasta User s Programs Menu. Finalmente, defina o nome Aplicação Financeira para a sub pasta criada. Microsoft Visual Studio 2005 11

Depois, de modo análogo ao utilizado nos passos 9 a 11, adicione o atalho, defina o seu nome apropriadamente e mova-o para a sub pasta Aplicação Financeira da pasta User s Programs Menu do File System Editor. 19. Para adicionar o atalho, selecione, com o botão direito do rato, a pasta User s Programs Menu e escolha o comando Create Shortcut to User s Programs Menu. A figura seguinte mostra o resultado da adição do atalho à pasta User s Programs Menu do File System Editor. Microsoft Visual Studio 2005 12

20. Seleccione o atalho, com o botão direito do rato, e escolha a opção Rename. 21. Defina o nome Aplicação Financeira para o atalho. Depois, mova o atalho para a sub pasta Aplicação Financeira da pasta User s Programs Menu do File System Editor. Microsoft Visual Studio 2005 13

22. Seleccione a pasta User s Programs Menu do File System Editor e defina a sua propriedade AlwaysCreate com o valor True. 23. De modo análogo ao utilizado nos passos 12 a 17, associe o icone ao atalho que acabou de adiconar à sub pasta Aplicação Financeira da pasta User s Programs Menu do File System Editor. Microsoft Visual Studio 2005 14

Adicioanalmente ao File System Editor, o Visual Studio providencia mais cinco editores que permitem costumizar o projecto de instalação. Para aceder a esses editores, selecione o projecto de instalação no solution explorer e utilize os botões que aparecem no topo do solution explorer. Como sabe, o File System Editor permite especificar o executável da aplicação, os ficheiros e outros itens que pretende incluir no projecto de instalação e permite ainda especificar o local onde vão ser instalados no computador onde vai ser realizada a instalação da aplicação. O Registry Editor permite especificar as chaves (regestry keys) e os valores que irão ser adicionados ao regito (registry) do computador onde vai ser realizada a instalação da aplicação. O File Types Editor permite especificar os tipos de ficheiros e as extensões que irão ser associadas com a aplicação qaundo for instalada. O User Interface Editor permite costumizar as caixas de diálogo que são apresentadas ao longo da execução do programa de instalação. O Custom Actions Editor permite especificar as acções adicionais que irão ser realizadas após a instalação da aplicação. O Launch Conditions Editor permite especificar as condições que têm que se verificar antes da aplicação ser instalada. Isto é, permite especificar os prerequisitos da instalação. Microsoft Visual Studio 2005 15

24. No solution explorer seleccione o botão do User Interface Editor. Como resultado, abre-se a seguinte janela. O User Interface Editor pode ser utilizado para especificar e definir as propriedades para as caixas de diálogo predefinidas que são mostradas durante a instalação da aplicação. O User Interface Editor é um controlo que contém duas secções: Install e Administrative Install. A secção Install contém as caixas de diálogo que irão ser mostradas quando o utilizador executar o programa de instalação. A secção Administrative Install contém as caixas de diálogo que irão ser mostradas quando o administrador do sistema faz o upload do programa de instalação para um posto da rede. Como pode observar no lado esquerdo da figura anterior, o User Interface Editor disponibiliza um conjunto predefinido de caixas de diálogo. Pode reorganizar ou eliminar estas caixas de diálogo. Para tal, basta selecionar, com o botão direito do rato, a caixa de diálogo que pretende reorganizar ou eliminar, e escolher a opção apropriada no menu de contexto. Microsoft Visual Studio 2005 16

Note que este conjunto predefinido de caixas de diálogo varia de acordo com o tipo de projecto de distibuição. O conjunto predefinido de caixas de diálogo está dividido em três categorias: Start dialog box, Progress dialog box e End dialog box. As caixas de diálogo da categoria Start são mostradas antes da instalação começar. Utilizações comuns destas caixas de diálogo passam, por exemplo, por recolher informação dos utilizadores ou por permitir ao utilizador alterar a pasta de instalação. As caixas de diálogo da categoria Progress são mostradas para fornecer informação sobre o progresso da instalação. As caixas de diálogo da categoria End são mostradas quando a instalação termina com sucesso. Utilizações comuns destas caixas de diálogo passam, por exemplo, por notificar o utilizador que a instalação está completa ou por permitir ao utilizador executar a aplicação instalada. Microsoft Visual Studio 2005 17

25. Para mostrar uma imagem na caixa de diálogo de boas vindas do programa de instalação, seleccione, na secção Install do User Interface Editor, a caixa de diálogo Welcome da categoria Start. Note que, no caso de uma instalação profissional, faria todo o sentido colocar aqui o logótipo da empresa ou da própria aplicação. 26. Depois, na janela de propriedades da caixa de diálogo seleccionada no passo anterior, seleccione a propriedade BannerBitMap e escolha a opção Browse. Microsoft Visual Studio 2005 18

Vai ser mostrada a caixa de diálogo Select Item in Project. 27. Na caixa de combinação Look in da caixa de diálogo Select Item in Project, seleccione Aplication Folder. 28. Seleccione o ficheiro Pôr do sol.jpg e pressione o botão OK. Microsoft Visual Studio 2005 19

29. Explore as (poucas) propriedades das caixas de diálogo de cada uma das categorias da secção Install do User Interface Editor, de modo a definir uma imagem e o texto apropriado a apresentar em cada uma das caixas mostradas durante o processo de instalação da aplicação. Além da utilização dos editores que o Visual Studio providencia, pode ainda definir as propriedades do setup project para costumizar o projecto de instalação. 30. No solution Explorer, selecione o projecto de instalãção da aplicação desenvolvida. A seguir apresentam-se algumas das principais propriedades de um projecto de instalação. A propriedade Manufacturer permite definir o nome da empresa que desenvolveu a aplicação. Note que esta propriedade é utlizada como parte do caminho de instalação predefinido. A propriedade ProductName permite especificar o nome da aplicação. Note que esta propriedade é utilizada nas caixas de diálogo ao longo da execução do programa de instalação e como parte do caminho de instalação predefinido. Microsoft Visual Studio 2005 20

Note que os valores definidos para as propriedades Manufacturer e ProductName também são mostrados na caixa de diálogo Suport Info que é apresentada na janela Add or Remove Programs do painel de controlo (control panel) do Windows. As propriedades Author, Description, ManufacturerUrl, SupportUrl e SupportPhone também providenciam informação na caixa de diálogo Suport Info. A propriedade ProductCode permite definir um identificador único que deve variar para cada versão da aplicação. A propriedade Version permite especificar o número da versão do programa de instalação. Se alterar o valor desta propriedade também deve alterar o valor da propriedade ProductCode. A propriedade RemovePreviousVersions permite determinar se as versões anteriores da aplicação são removidas antes de a versão actual ser instalada. 31. Defina as propriedades que enteder serem pertinentes para costumizar o seu projecto de instalação. Microsoft Visual Studio 2005 21

Quando o projecto de instação estiver concluido, pode ser compilado, de modo a gerar os ficheiros que irão ser utilizados para instalar a aplicação desenvolvida. Como resultado da compilação do projecto de instalação são gerados dois ficheiros. O ficheiro Windows Instaler, Setup.msi, que contém a aplicação, os ficheiros dependentes, informação acerca da aplicação e as instruções de instalação. O ficheiro Setup.exe, que pode ser utilizado para executar o programa de instalação. 32. Para compilar o projecto de instalação (setup project), seleccione-no, no Solution Explorer e, no menu Build escolha o comando Build Instalação Aplicação Financeira (Instalação Aplicação Financeira foi o nome dado ao projecto de instalação no passo 4). Microsoft Visual Studio 2005 22

Por defeito, o ficheiro Setup.msi e o ficheiro Setup.exe são armazenados na pasta Debug da pasta do projecto de instalação (setup project). Todavia, se desejar, pode armazenar esses ficheiros em qualquer outra pasta. Para tal, seleccione, com o botão direito do rato, o projecto de instalação no Solution Explorer. Microsoft Visual Studio 2005 23

Vai ser mostrada a caixa de diálogo das propriedades do projecto de instalação, Instalação Aplicação Financeira Property Pages. Se pretender alterar o local onde os ficheiros Setup.msi e Setup.exe são armazenados, indique o novo caminho na opção Output file name. Neste momento, está em condições de copiar a pasta que contém os ficheiros Setup.msi e Setup.exe para servidor de rede ou para um CD/DVD. Depois, os utilizadores podem instalar a aplicação executando o ficheiro Setup.exe no seu computador. 33. Instale a aplicação no seu computador. Para tal, abra a pasta Debug do projecto de instalação que acabou de criar nos passos anteriores e execute o ficheiro Setup.exe. Microsoft Visual Studio 2005 24

Vai ser mostrada a caixa de diálogo de boas vindas (Welcome) do programa de instalação. 34. Pressione o botão Next. Vai ser mostrada a caixa de diálogo Instalation Folder do programa de instalação. Note que os valores definidos para as propriedades Manufacturer e ProductName do projecto de instalação foram utilizados na construção do caminho de instalação predefinido (ver figura da página 21). 35. Pressione o botão Next. Microsoft Visual Studio 2005 25

Vai ser mostrada a caixa de diálogo Confirm Instalation do programa de instalação. 36. Pressione o botão Next. Vai ser mostrada a caixa de diálogo Progress do programa de instalação. 37. Pressione o botão Next quando estiver disponível. Microsoft Visual Studio 2005 26

Vai ser mostrada a caixa de diálogo Finished do programa de instalação. 38. Pressione o botão Close para concluir a instalação da aplicação desenvolvida nas tarefas orientadas anteriores. Note que o texto que é apresentado nas caixas de combinação do programa de instalação podia ter sido devidamente alterado no projecto de instalação. Pode agora executar a aplicação, por exemplo, através do atalho criado, pelo programa de instalação, no seu ambiente de trabalho. Microsoft Visual Studio 2005 27

39. Para desinstalar a aplicação, seleccione o menu iniciar (start) e escolha a opção painel de controlo. Vai ser mostrada a janela do painel de controlo (control panel). 40. Seleccione a opção Adicionar Remover Programas. Microsoft Visual Studio 2005 28

Vai aparecer a caixa de diálogo Adicionar ou remover programas. 41. Seleccione a aplicação Instalação Aplicação Financeira e pressione o botão Remover. Vai aparecer a caixa de diálogo de confirmação Adicionar ou remover programas. 42. Pressione o botão Sim. Neste momento, acabou de desinstalar a aplicação. Microsoft Visual Studio 2005 29

Além deste método utilizado para distribuir uma aplicação em vários computadores, existem outros com algumas vantagens e também com algumas desvantagens. Por exemplo, a forma mais fácil de distribuir uma aplicação é copiar os ficheiros necessários para os computadores onde se pretende executar essa aplicação. Este método é comummente conhecido por XCopy, pois pode-se utilizar o comando do DOS XCopy para copiar os ficheiros. Porém, pode utilizar-se, alternativamente, o explorador do Windows para copiar os ficheiros. Também pode utilizar para a distribuição de aplicações o método comummente designado por ClickOnce. Este tipo de distribuição é uma das novidades do Visual Studio 2005 e permite que o utilizador instale a aplicação através de uma ligação (link) de uma página web. Este método, tal como o método de criação de um programa de instalação utilizado nesta tarefa orientada, também permite criar um atalho para a aplicação no menu iniciar do computador onde vai ser instalada a aplicação e utilizar a opção Adicionar ou Remover Programas do painel de controlo para desinstalar a aplicação. Adicionalmente, o método ClickOnce permite actualizar automaticamente a aplicação, sempre que estiver disponível uma nova versão. Microsoft Visual Studio 2005 30