Tworzenie projektu CMake systemu Linux w programie Visual StudioCreate a CMake Linux project in Visual Studio

Obsługa systemu Linux jest dostępna w programie Visual Studio 2017 i nowszych.Linux support is available in Visual Studio 2017 and later. Aby wyświetlić dokumentację dla tych wersji, Ustaw listę rozwijaną wersja znajdującą się powyżej spisu treści w programie Visual Studio 2017 lub Visual Studio 2019 .To see the documentation for these versions, set the Version drop-down located above the table of contents to Visual Studio 2017 or Visual Studio 2019 .

Zalecamy używanie CMake na potrzeby projektów, które są na wielu platformach lub będą udostępniane jako "open source".We recommend you use CMake for projects that are cross-platform or will be made open-source. Projektów CMake można użyć do kompilowania i debugowania tego samego kodu źródłowego w systemie Windows, podsystemu Windows dla systemu Linux (WSL) i systemów zdalnych.You can use CMake projects to build and debug the same source code on Windows, the Windows Subsystem for Linux (WSL), and remote systems.

Przed rozpoczęciemBefore you begin

Najpierw upewnij się, że masz zainstalowane obciążenie programu Visual Studio Linux, w tym składnik CMake.First, make sure you have the Visual Studio Linux workload installed, including the CMake component. To jest programowanie dla systemu Linux przy użyciu obciążenia C++ w Instalatorze programu Visual Studio.That's the Linux development with C++ workload in the Visual Studio installer. Zapoznaj się z tematem Instalowanie obciążenia C++ systemu Linux w programie Visual Studio , jeśli nie masz pewności, że zainstalowano program.See Install the C++ Linux workload in Visual Studio if you aren't sure you have that installed.

Upewnij się również, że na komputerze zdalnym są zainstalowane następujące elementy:Also, make sure the following are installed on the remote machine:

  • zatocegcc
  • GDBgdb
  • rsyncrsync
  • koduzip
  • Ninja — kompilacja (Visual Studio 2019 lub nowsza)ninja-build (Visual Studio 2019 or above)

Obsługa CMake w programie Visual Studio wymaga obsługi trybu serwera wprowadzonej w CMake 3,8.The CMake support in Visual Studio requires server mode support introduced in CMake 3.8. W przypadku CMake z wariantem dostarczonym przez firmę Microsoft Pobierz najnowsze wstępnie skompilowane pliki binarne w https://github.com/Microsoft/CMake/releases .For a Microsoft-provided CMake variant, download the latest prebuilt binaries at https://github.com/Microsoft/CMake/releases.

Pliki binarne są instalowane w programie ~/.vs/cmake .The binaries are installed in ~/.vs/cmake. Po wdrożeniu plików binarnych projekt zostanie automatycznie replikny.After deploying the binaries, your project automatically regenerates. Jeśli CMake określony przez cmakeExecutable pole w CMakeSettings.json jest nieprawidłowy (nie istnieje lub jest nieobsługiwaną wersją), a wstępnie skompilowane pliki binarne są obecne, program Visual Studio ignoruje cmakeExecutable i używa wstępnie skompilowanych plików binarnych.If the CMake specified by the cmakeExecutable field in CMakeSettings.json is invalid (it doesn't exist or is an unsupported version), and the prebuilt binaries are present, Visual Studio ignores cmakeExecutable and uses the prebuilt binaries.

Program Visual Studio 2017 nie może utworzyć projektu CMake od podstaw, ale można otworzyć folder zawierający istniejący projekt CMake, zgodnie z opisem w następnej sekcji.Visual Studio 2017 can't create a CMake project from scratch, but you can open a folder that contains an existing CMake project, as described in the next section.

Możesz użyć programu Visual Studio 2019 do kompilowania i debugowania w zdalnym systemie Linux lub WSL, a CMake zostanie wywołana w tym systemie.You can use Visual Studio 2019 to build and debug on a remote Linux system or WSL, and CMake will be invoked on that system. Na maszynie docelowej należy zainstalować CMAKE w wersji 3,14 lub nowszej.Cmake version 3.14 or later should be installed on the target machine.

Upewnij się, że na komputerze docelowym jest używana najnowsza wersja programu CMake.Make sure that the target machine has a recent version of CMake. Często Wersja oferowana przez domyślny Menedżer pakietów dystrybucji nie jest wystarczająca do obsługi wszystkich funkcji wymaganych przez program Visual Studio.Often, the version offered by a distribution's default package manager isn't recent enough to support all the features required by Visual Studio. Program Visual Studio 2019 wykrywa, czy w systemie Linux jest zainstalowana najnowsza wersja programu CMake.Visual Studio 2019 detects whether a recent version of CMake is installed on the Linux system. Jeśli nie zostanie znaleziona, program Visual Studio wyświetli pasek informacji w górnej części okienka edytora.If none is found, Visual Studio shows an info-bar at the top of the editor pane. Oferuje ona możliwość instalacji CMake z programu https://github.com/Microsoft/CMake/releases .It offers to install CMake for you from https://github.com/Microsoft/CMake/releases.

W programie Visual Studio 2019 można utworzyć projekt CMake od podstaw lub otworzyć istniejący projekt CMake.With Visual Studio 2019, you can create a CMake project from scratch, or open an existing CMake project. Aby utworzyć nowy projekt CMake, postępuj zgodnie z poniższymi instrukcjami.To create a new CMake project, follow the instructions below. Lub przejdź z wyprzedzeniem, aby otworzyć folder projektu CMAKE , jeśli istnieje już projekt CMAKE.Or skip ahead to Open a CMake project folder if you already have a CMake project.

Tworzenie nowego projektu CMake systemu LinuxCreate a new Linux CMake project

Aby utworzyć nowy projekt systemu Linux CMake w programie Visual Studio 2019:To create a new Linux CMake project in Visual Studio 2019:

  1. Wybierz pozycję plik > nowy projekt w programie Visual Studio lub naciśnij klawisze Ctrl + Shift + N .Select File > New Project in Visual Studio, or press Ctrl + Shift + N .
  2. Ustaw Język na C++ i wyszukaj ciąg "CMAKE".Set the Language to C++ and search for "CMake". Następnie wybierz przycisk dalej .Then choose Next . Wprowadź nazwę i lokalizację , a następnie wybierz pozycję Utwórz .Enter a Name and Location , and choose Create .

Alternatywnie możesz otworzyć własny projekt CMake w programie Visual Studio 2019.Alternatively, you can open your own CMake project in Visual Studio 2019. W poniższej sekcji wyjaśniono, jak.The following section explains how.

Program Visual Studio tworzy plik o minimalnym CMakeLists.txt tylko przy użyciu nazwy pliku wykonywalnego i minimalnej wymaganej wersji CMAKE.Visual Studio creates a minimal CMakeLists.txt file with only the name of the executable and the minimum CMake version required. Możesz jednak ręcznie edytować ten plik. Program Visual Studio nigdy nie zastąpi zmian.You can manually edit this file however you like; Visual Studio will never overwrite your changes.

Aby ułatwić zrozumienie, edytowanie i tworzenie skryptów CMake w programie Visual Studio 2019, zapoznaj się z następującymi zasobami:To help you make sense of, edit, and author your CMake scripts in Visual Studio 2019, refer to the following resources:

Otwieranie folderu projektu CMakeOpen a CMake project folder

Po otwarciu folderu zawierającego istniejący projekt CMake program Visual Studio używa zmiennych w pamięci podręcznej CMake, aby automatycznie konfigurować funkcje IntelliSense i kompilacje.When you open a folder that contains an existing CMake project, Visual Studio uses variables in the CMake cache to automatically configure IntelliSense and builds. Ustawienia konfiguracji lokalnej i debugowania są przechowywane w plikach JSON.Local configuration and debugging settings get stored in JSON files. Możesz opcjonalnie udostępniać te pliki innym osobom korzystającym z programu Visual Studio.You can optionally share these files with others who are using Visual Studio.

Program Visual Studio nie modyfikuje plików CMakeLists.txt .Visual Studio doesn't modify the CMakeLists.txt files. Pozwala to innym osobom pracującym nad tym samym projektem w dalszym ciągu korzystać z istniejących narzędzi.This allows others working on the same project to continue to use their existing tools. Program Visual Studio generuje ponownie pamięć podręczną podczas zapisywania zmian w CMakeLists.txt lub w niektórych przypadkach, aby CMakeSettings.jsna .Visual Studio does regenerate the cache when you save edits to CMakeLists.txt , or in some cases, to CMakeSettings.json . W przypadku korzystania z istniejącej konfiguracji pamięci podręcznej program Visual Studio nie modyfikuje pamięci podręcznej.If you're using an Existing Cache configuration, then Visual Studio doesn't modify the cache.

Aby uzyskać ogólne informacje na temat obsługi CMake w programie Visual Studio, zobacz CMAKE projects in Visual Studio.For general information about CMake support in Visual Studio, see CMake projects in Visual Studio. Przeczytaj ten element przed kontynuowaniem.Read that before continuing here.

Aby rozpocząć, wybierz pozycję plik > Otwórz > folder z menu głównego lub inny typ devenv.exe <foldername> w oknie wiersza polecenia dewelopera .To get started, choose File > Open > Folder from the main menu or else type devenv.exe <foldername> in a developer command prompt window. Otwarty folder powinien zawierać plik CMakeLists.txt wraz z kodem źródłowym.The folder you open should have a CMakeLists.txt file in it, along with your source code.

W poniższym przykładzie przedstawiono prosty plik CMakeLists.txt i plik. cpp:The following example shows a simple CMakeLists.txt file and .cpp file:

// hello.cpp

#include <iostream>

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

CMakeLists.txt :CMakeLists.txt :

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

Następne krokiNext steps

Konfigurowanie projektu CMake systemu LinuxConfigure a Linux CMake project

Zobacz takżeSee also

CMake projekty w programie Visual StudioCMake Projects in Visual Studio