Creare un progetto CMake Linux in Visual Studio

Il supporto per Linux è disponibile in Visual Studio 2017 e versioni successive. Per visualizzare la documentazione per queste versioni, impostare l'elenco a discesa Versione che si trova sopra il sommario su Visual Studio 2017 o Visual Studio 2019.

È consigliabile usare CMake per i progetti multipiattaforma o che saranno resi open source. È possibile usare i progetti CMake per compilare ed eseguire il debug dello stesso codice sorgente in Windows, il sottosistema Windows per Linux (WSL) e i sistemi remoti.

Operazioni preliminari

Prima di tutto, assicurarsi di avere installato il carico di lavoro Di Visual Studio Linux, incluso il componente CMake. Si tratta del carico di lavoro Sviluppo Linux con C++ nel programma di installazione di Visual Studio. Vedere Installare il carico di lavoro Linux C++ in Visual Studio se non si è certi di aver installato tale carico di lavoro.

Assicurarsi anche che nel computer remoto siano installati i seguenti elementi:

  • gcc
  • gdb
  • rsync
  • zip
  • ninja-build (Visual Studio 2019 o versione successiva)

Il supporto di CMake in Visual Studio richiede il supporto della modalità server introdotto in CMake 3.8. Per una variante di CMake fornita da Microsoft, scaricare la versione più recente dei file binari precompilati all'indirizzo https://github.com/Microsoft/CMake/releases.

I file binari vengono installati in ~/.vs/cmake. Dopo aver distribuito i file binari, il progetto viene rigenerato automaticamente. Se CMake specificato dal cmakeExecutable campo in CMakeSettings.json non è valido (non esiste o è una versione non supportata) e sono presenti i file binari predefiniti, Visual Studio ignora cmakeExecutable e usa i file binari predefiniti.

Visual Studio 2017 non può creare un progetto CMake da zero, ma è possibile aprire una cartella contenente un progetto CMake esistente, come descritto nella sezione successiva.

È possibile usare Visual Studio 2019 per compilare ed eseguire il debug in un sistema Linux remoto o WSL e CMake verrà richiamato in tale sistema. Cmake versione 3.14 o successiva deve essere installato nel computer di destinazione.

Assicurarsi che il computer di destinazione abbia una versione recente di CMake. Spesso, la versione offerta dalla gestione pacchetti predefinita di una distribuzione non è abbastanza recente per supportare tutte le funzionalità richieste da Visual Studio. Visual Studio 2019 rileva se nel sistema Linux è installata una versione recente di CMake. Se non viene trovato alcun elemento, Visual Studio visualizza una barra delle informazioni nella parte superiore del riquadro dell'editor. Offre l'installazione di CMake da https://github.com/Microsoft/CMake/releases.

Con Visual Studio 2019 è possibile creare un progetto CMake da zero o aprire un progetto CMake esistente. Per creare un nuovo progetto CMake, seguire le istruzioni riportate di seguito. In alternativa, passare a Apri una cartella di progetto CMake se si dispone già di un progetto CMake.

Creare un nuovo progetto CMake Linux

Per creare un nuovo progetto CMake per Linux in Visual Studio 2019:

  1. Selezionare File Nuovo progetto in Visual Studio oppure premere CTRL+MAIUSC+N>.
  2. Impostare Linguaggio su C++ e cercare "CMake". Scegliere quindi Avanti. Immettere un nome e una posizione e scegliere Crea.

In alternativa, è possibile aprire il proprio progetto CMake in Visual Studio 2019. Nella sezione seguente viene illustrato come.

Visual Studio crea un file di CMakeLists.txt minimo con solo il nome dell'eseguibile e la versione minima di CMake necessaria. È possibile modificare manualmente questo file come si preferisce. Visual Studio non sovrascriverà mai le modifiche.

Per comprendere, modificare e creare script CMake in Visual Studio 2019, fare riferimento alle risorse seguenti:

Aprire una cartella del progetto CMake

Quando si apre una cartella contenente un progetto CMake esistente, Visual Studio usa le variabili nella cache CMake per configurare automaticamente IntelliSense e le compilazioni. Le impostazioni di configurazione e debug locali vengono archiviate nei file JSON. Facoltativamente, è possibile condividere questi file con altri utenti che usano Visual Studio.

Visual Studio non modifica i file CMakeLists.txt . Ciò consente ad altri utenti che lavorano sullo stesso progetto di continuare a usare gli strumenti esistenti. Visual Studio rigenera la cache quando si salvano modifiche in CMakeLists.txt, o in alcuni casi, per CMakeSettings.json. Se si usa una configurazione cache esistente, Visual Studio non modifica la cache.

Per informazioni generali sul supporto di CMake in Visual Studio, vedere Progetti CMake in Visual Studio. Leggere questa operazione prima di continuare qui.

Per iniziare, scegliere File>Apri>cartella dal menu principale oppure digitare devenv.exe <foldername> in una finestra del prompt dei comandi per gli sviluppatori. La cartella aperta deve contenere un file CMakeLists.txt insieme al codice sorgente.

L'esempio seguente illustra un semplice file di CMakeLists.txt e .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)

Passaggi successivi

Configurare un progetto CMake per Linux

Vedi anche

Progetti CMake in Visual Studio