Criar um projeto do CMake Linux no Visual Studio

Recomendamos que você use o CMake para projetos que são multiplataforma ou serão feitos de software livre. Você pode usar projetos do CMake para criar e depurar o mesmo código-fonte no Windows, no Subsistema do Windows para Linux (WSL) e em sistemas remotos.

Antes de começar

Primeiro, verifique se você tem a carga de trabalho do Visual Studio Linux instalada, incluindo o componente do CMake. É o desenvolvimento do Linux com carga de trabalho C++ no Instalador do Visual Studio. Consulte Instalar a carga de trabalho do Linux do C++ no Visual Studio se você não tiver certeza de que tem isso instalado.

Além disso, verifique se o seguinte está instalado no computador remoto:

• gcc
• gdb
• rsync
• zip
• ninja-build (Visual Studio 2019 ou superior)

Você pode usar o Visual Studio 2019 para criar e depurar em um sistema Linux remoto ou WSL, e o CMake será invocado nesse sistema. O Cmake versão 3.14 ou posterior deve ser instalado no computador de destino.

Verifique se o computador de destino tem uma versão recente do CMake. Muitas vezes, a versão oferecida pelo gerenciador de pacotes padrão de uma distribuição não é recente o suficiente para dar suporte a todos os recursos necessários para o Visual Studio. O Visual Studio 2019 detecta se uma versão recente do CMake está instalada no sistema Linux. Se nenhuma for encontrada, o Visual Studio mostrará uma barra de informações na parte superior do painel do editor. Ele oferece a instalação do CMake para você a partir de https://github.com/Microsoft/CMake/releases.

Com o Visual Studio 2019, você pode criar um projeto do CMake do zero ou abrir um projeto CMake existente. Para criar um novo projeto do CMake, siga as instruções abaixo. Ou pule para abrir uma pasta de projeto do CMake se você já tiver um projeto do CMake.

Criar um projeto do Linux com o CMake

Para criar um novo projeto CMake do Linux no Visual Studio 2019:

1. Selecione Arquivo > Novo Projeto no Visual Studio ou pressione Ctrl + Shift + N.
2. Defina a Linguagem como C++ e pesquise "CMake". Em seguida, escolha Avançar. Insira um Nome e uma Localização e escolha Criar.

Como alternativa, você pode abrir seu próprio projeto do CMake no Visual Studio 2019. A seção a seguir explica como.

O Visual Studio cria um arquivo mínimo CMakeLists.txt apenas com o nome do executável e a versão mínima necessária do CMake. Você pode editar manualmente esse arquivo da maneira que desejar. O Visual Studio nunca substituirá suas alterações.

Para ajudá-lo a entender, editar e criar seus scripts CMake no Visual Studio 2019, consulte os seguintes recursos:

• Documentação no editor do CMake no Visual Studio
• Navegação de código para scripts CMake
• Adicionar, remover e renomear arquivos e destinos com facilidade em projetos do CMake

Abrir uma pasta de projeto do CMake

Quando você abre uma pasta que já contém um projeto CMake, o Visual Studio usa as variáveis no cache do CMake para configurar o IntelliSense e as builds. As configurações locais e de depuração são armazenadas em arquivos JSON. Opcionalmente, você pode compartilhar esses arquivos com outras pessoas que estão usando o Visual Studio.

O Visual Studio não modifica os arquivos CMakeLists.txt. Isso permite que outras pessoas que trabalham no mesmo projeto continuem a usar suas ferramentas existentes. O Visual Studio regenera o cache quando você faz edições no CMakeLists.txt ou, em alguns casos, no CMakeSettings.json. Se você estiver usando uma configuração de Cache Existente, o Visual Studio não modificará o cache.

Para obter informações gerais sobre o suporte do CMake no Visual Studio, confira Projetos CMake no Visual Studio. Leia isso antes de continuar aqui.

Para começar, escolha Arquivo>Abrir>Pasta no menu principal ou digite devenv.exe <foldername>em uma janela de prompt de comando de desenvolvedor. A pasta que você abrir deverá conter um arquivo CMakeLists.txt, junto com o código-fonte.

O exemplo a seguir mostra um arquivo CMakeLists.txt simples e o arquivo .cpp:

// hello.cpp

#include <iostream>

int main(int argc, char* argv[])
{
    std::cout << "Hello from Linux CMake \n";
}

CMakeLists.txt:

cmake_minimum_required(VERSION 3.8)
project (hello-cmake)
add_executable(hello-cmake hello.cpp)

Próximas etapas

Configurar um projeto do Linux CMake

Confira também

Projetos do CMake no Visual Studio