Partilhar via


Criar um projeto 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 Versão localizada acima do sumário como Visual Studio 2017 ou Visual Studio 2019.

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

Antes de começar

Primeiro, certifique-se de ter a carga de trabalho do Visual Studio Linux instalada, incluindo o componente CMake. Esse é o desenvolvimento Linux com carga de trabalho C++ no instalador do Visual Studio. Consulte Instalar a carga de trabalho do Linux C++ no Visual Studio se não tiver certeza de que está instalada.

Além disso, certifique-se de que o seguinte está instalado na máquina remota:

  • CCG
  • GDB
  • rsync
  • ZIP
  • ninja-build (Visual Studio 2019 ou superior)

O suporte ao CMake no Visual Studio requer suporte ao modo de servidor introduzido no CMake 3.8. Para uma variante CMake fornecida pela Microsoft, baixe os binários pré-construídos 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 se regenera automaticamente. Se o CMake especificado pelo cmakeExecutable campo em CMakeSettings.json for inválido (ele não existe ou é uma versão sem suporte) e os binários pré-construídos estiverem presentes, o Visual Studio ignorará e usará os binários cmakeExecutable pré-construídos.

O Visual Studio 2017 não pode criar um projeto 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 compilar e depurar em um sistema Linux remoto ou WSL, e o CMake será invocado nesse sistema. Cmake versão 3.14 ou posterior deve ser instalado na máquina de destino.

Certifique-se de que a máquina 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 oferecer suporte a todos os recursos exigidos pelo Visual Studio. O Visual Studio 2019 deteta se uma versão recente do CMake está instalada no sistema Linux. Se nenhum for encontrado, o Visual Studio mostrará uma barra de informações na parte superior do painel do editor. Ele se oferece para instalar o CMake para você a partir de https://github.com/Microsoft/CMake/releases.

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

Criar um novo projeto Linux CMake

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

  1. Selecione Arquivo > Novo Projeto no Visual Studio ou pressione Ctrl + Shift + N.
  2. Defina o idioma como C++ e procure por "CMake". Em seguida, escolha Avançar. Insira um Nome e um Local e escolha Criar.

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

O Visual Studio cria um arquivo CMakeLists.txt mínimo com apenas o nome do executável e a versão mínima do CMake necessária. Você pode editar manualmente este arquivo como quiser; 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 CMake

Quando você abre uma pasta que contém um projeto CMake existente, Visual Studio usa variáveis no cache CMake para configurar automaticamente o IntelliSense e compila. As configurações locais e as configurações 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. Visual Studio regenera o cache quando você salva edições para CMakeLists.txtou, em alguns casos, para 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 ao CMake no Visual Studio, consulte Projetos CMake no Visual Studio. Leia isso antes de continuar aqui.

Para começar, escolha Ficheiro>Abrir>Pasta no menu principal ou então digite devenv.exe <foldername> numa janela de prompt de comando do desenvolvedor. A pasta que você abrir deve ter um arquivo CMakeLists.txt , juntamente com seu código-fonte.

O exemplo a seguir mostra um arquivo CMakeLists.txt simples e um 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óximos passos

Configurar um projeto CMake Linux

Ver também

Projetos CMake no Visual Studio