Criar um projeto do CMake Linux no Visual Studio
O suporte ao Linux está disponível no Visual Studio 2017 e posterior. Para ver a documentação dessas versões, defina a lista suspensa de Versão localizada acima do sumário para o Visual Studio 2017 ou Visual Studio 2019.
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)
O suporte ao CMake no Visual Studio requer o suporte do modo de servidor apresentado no CMake 3.8. Para uma variante CMake fornecida pela Microsoft, baixe os binários predefinidos mais recentes em https://github.com/Microsoft/CMake/releases.
Os binários são instalados em ~/.vs/cmake. Depois de implantar os binários, seu projeto é regenerado automaticamente. Se o CMake especificado pelo campo cmakeExecutable em CMakeSettings.json for inválido (não existir ou for uma versão sem suporte) e os binários predefinidos estiverem presentes, o Visual Studio ignorará cmakeExecutable e usará os binários predefinidos.
O Visual Studio 2017 não pode criar um projeto do CMake do zero, mas você pode abrir uma pasta que contém um projeto CMake existente, conforme descrito na próxima seção.
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:
- Selecione Arquivo > Novo Projeto no Visual Studio ou pressione Ctrl + Shift + N.
- 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:
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