Passo a passo: Implantar um aplicativo Microsoft C++ usando um projeto de instalação

Nesta explicação passo a passo, você criará um aplicativo de exemplo no Visual Studio e, em seguida, criará um projeto de instalação para implantar seu aplicativo em outro computador.

As instruções para criar um novo projeto variam dependendo de qual versão do Visual Studio você instalou. Para ver a documentação da sua versão preferida do Visual Studio, use o controlador de seleção Versão . Encontra-se na parte superior do índice desta página.

Pré-requisitos

Você precisa dos seguintes componentes para concluir este passo a passo:

• Um computador com o Visual Studio 2022 instalado. A instalação deve incluir a carga de trabalho Desenvolvimento Desktop com C++, e o componente opcional C++ MFC para as ferramentas de compilação mais recentes v143 (x86 & x64).

• A extensão Microsoft Visual Studio Installer Projects. A extensão é gratuita para desenvolvedores do Visual Studio e adiciona a funcionalidade dos modelos de projeto de instalação e implantação ao Visual Studio.

• Para testar sua implantação, outro computador que não tenha as bibliotecas do Microsoft C++ instaladas.

Para instalar C++ e MFC no Visual Studio 2022

Se você tiver o Visual Studio instalado, mas não tiver os componentes C++ ou MFC instalados, poderá adicioná-los agora.

1. Inicie o programa Visual Studio Installer no menu Iniciar do Windows.

2. No Visual Studio Installer, escolha o botão Modificar ao lado da versão instalada do Visual Studio.

3. Na caixa de diálogo Modificando , na guia Cargas de trabalho , role para baixo até o bloco Desenvolvimento de área de trabalho com C++ . Se a caixa de seleção do bloco não estiver assinalada, assinale-a.

4. Na lateral de Detalhes da instalação, expanda o nó Desenvolvimento de aplicações de desktop com C++ e depois expanda o nó Opcional. Se ainda não estiver marcado, adicione uma verificação ao MFC C++ para obter o componente mais recente das ferramentas de compilação v143 (x86 & x64).

5. Escolha o botão Modificar para modificar sua instalação do Visual Studio. Quando a instalação for concluída, saia do instalador do Visual Studio.

Para instalar a extensão Installer Projects

1. No Visual Studio, selecione o item de menu Extensões>Gerenciar Extensões .

2. Na caixa de diálogo Gerenciar Extensões, expanda Ferramentas Online>do Visual Studio Marketplace> e selecione Configuração & Implantação.

   

3. Na lista de extensões, selecione Microsoft Visual Studio Installer Projects 2022. Escolha o botão Download .

4. Uma notificação aparece na parte inferior da caixa de diálogo informando que a modificação começará quando todas as janelas do Microsoft Visual Studio forem fechadas. Feche a caixa de diálogo.

5. Feche o Visual Studio. O processo de download e instalação é iniciado. Talvez seja necessário aceitar um prompt de elevação do Controle de Conta de Usuário para permitir que o instalador altere o Visual Studio.

6. Na caixa de diálogo VSIX Installer, escolha Modificar para instalar a extensão. Quando as modificações forem concluídas, escolha Fechar para descartar a caixa de diálogo.

Criar o projeto de aplicativo de exemplo

Para criar uma configuração de aplicativo implantável, primeiro você criará um aplicativo de exemplo para implantar.

Para criar o projeto de aplicativo no Visual Studio 2022

1. Inicie o Visual Studio. Por padrão, ele abre a caixa de diálogo Criar um novo projeto . Se o Visual Studio já estiver aberto, na barra de menus, escolha Arquivo>Novo>Projeto para abrir a caixa de diálogo Criar um Novo Projeto .

   

2. Na parte superior da caixa de diálogo, digite MFC na caixa de pesquisa e escolha MFC App na lista de resultados. (Se o modelo Aplicativo MFC estiver ausente, consulte Para instalar C++ e MFC no Visual Studio 2022.) Escolha o botão Avançar para continuar.

3. Na página Configurar seu novo projeto , insira um nome para o projeto, como MyMFCApp. Escolha o botão Criar.

4. Na caixa de diálogo MFC Application Wizard , escolha Concluir para criar o projeto de aplicativo MFC padrão. O assistente cria seu aplicativo MFC e abre o projeto no Visual Studio.

5. No Visual Studio, altere a configuração da solução ativa para Release e a plataforma de solução ativa para x86. No menu Compilar, selecione Gestor de Configuração. Na caixa de diálogo Configuration Manager, selecione Release na caixa suspensa de Configuração Ativa da Solução. Escolha Fechar para salvar as alterações.

6. Selecione o item de menu Build>Build Solution para criar a solução. O projeto de instalação usa a saída deste projeto de aplicativo MFC.

Criar o projeto de configuração do aplicativo

Agora que você criou um aplicativo de exemplo para implantar, em seguida, você criará um projeto de instalação para criar o pacote de implantação para seu aplicativo.

Para criar o projeto de instalação no Visual Studio 2022

1. No Visual Studio, com sua solução de aplicativo de exemplo carregada, escolha Arquivo>Novo>Projeto para abrir a caixa de diálogo Criar um Novo Projeto .

2. Na caixa de pesquisa acima da lista de modelos, digite Configuração. Na lista de modelos resultante, escolha Setup Project. (Se o modelo de projeto de instalação estiver ausente, consulte Para instalar a extensão Projetos do instalador.)

3. Digite um nome para o projeto de instalação na caixa Nome , como MyMFCAppSetup. Na lista pendente Solução, selecione Adicionar à solução. Escolha o botão OK para criar o projeto de configuração. Uma guia Sistema de arquivos (MyMFCAppSetup) é aberta na janela do editor.

Adicionar itens ao projeto de instalação

O projeto de instalação permite especificar onde os componentes do seu aplicativo são instalados quando implantados em uma máquina de destino.

Para adicionar componentes do aplicativo ao projeto de instalação

1. Na janela do editor do Sistema de Arquivos (MyMFCAppSetup), selecione o nó Sistema de Arquivos ou Máquina de Destino>Pasta de Aplicação.

2. Na barra de menus, selecione Project>Add>Project Output para abrir a caixa de diálogo Add Project Output Group .

3. Na caixa de diálogo, selecione Saída primária e escolha OK. Um novo item chamado Primary Output from ProjectName (Ative) aparece na janela File System.

4. Clique com o botão direito do mouse no nó Pasta do Aplicação e selecione Adicionar>Assemblagem para abrir a caixa de diálogo Selecionar componente. Selecione e adicione todas as DLLs necessárias para o programa. Para obter mais informações sobre como identificar as bibliotecas necessárias, consulte Determinando quais DLLs redistribuir.

5. Na lista de itens na Pasta do Aplicativo, clique com o botão direito do mouse em Saída Primária de ProjectName (Ativo) e escolha Criar Atalho para Saída Primária de ProjectName (Ativo). Um novo item chamado Atalho para Saída Primária de ProjectName (Ativo) aparece. Você pode renomear o item de atalho e, em seguida, arrastar e soltar o item no nó Menu Programas do Usuário no lado esquerdo da janela. Este item faz com que a configuração crie um atalho para o aplicativo no menu Iniciar.

6. Na barra de menus, escolha Criar>Configuration Manager para abrir a caixa de diálogo Configuration Manager.

7. Na caixa de diálogo Gerenciador de Configurações, na tabela Projeto na coluna Compilar , marque a caixa do projeto de implantação. Escolha Fechar para salvar as alterações e fechar a caixa de diálogo.

8. Na barra de menus, escolha Build>Build Solution para criar o projeto MFC e o projeto de implantação.

9. Na pasta da solução, localize o setup.exe programa que foi criado pelo projeto de implantação. Você pode copiar esse arquivo (e o .msi arquivo) para instalar o aplicativo e seus arquivos de biblioteca necessários em outro computador.

Teste a sua implementação

Para testar sua implantação, copie os arquivos de implantação para um segundo computador que não tenha as bibliotecas do Microsoft C++ instaladas. Execute o programa de instalação. Se seu aplicativo for carregado e executado normalmente e você não receber um erro de tempo de execução sobre bibliotecas ou componentes ausentes, sua implantação será bem-sucedida.

Para testes de aplicativos, você pode criar um programa de configuração de implantação que instala uma versão de depuração do seu aplicativo, juntamente com bibliotecas de depuração, em máquinas que você controla. Os aplicativos de depuração e as bibliotecas de depuração não são licenciados para redistribuição e não podem ser implantados nas máquinas dos clientes. Para obter mais informações, consulte Preparando uma máquina de teste para executar um executável de depuração.

Ver também

Exemplos de implantação