Creare un progetto CMake Linux in Visual Studio

Il supporto 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 verranno 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.

Prima di iniziare

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 inoltre che nel computer remoto siano installati gli elementi seguenti:

  • 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 CMake fornita da Microsoft, scaricare i file binari predefiniti più recenti 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 i file binari predefiniti sono presenti, 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 di installare CMake automaticamente 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 direttamente a Apri una cartella di progetto CMake se si ha già 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 diCMakeLists.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 allo stesso progetto di continuare a usare gli strumenti esistenti. Visual Studio rigenera la cache quando si salvano le modifiche in CMakeLists.txto in alcuni casi in 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 Apri>>cartella dal menu principale o 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 diCMakeLists.txt e un file con estensione 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