Membuat proyek CMake Linux di Visual Studio

  • Artikel

Dukungan Linux tersedia di Visual Studio 2017 dan yang lebih baru. Untuk melihat dokumentasi untuk versi ini, atur menu menurun Versi yang terletak di atas daftar isi ke Visual Studio 2017 atau Visual Studio 2019.

Kami sarankan Anda menggunakan CMake untuk proyek yang bersifat lintas platform atau akan dibuat sumber terbuka. Anda dapat menggunakan proyek CMake untuk membangun dan melakukan debug kode sumber yang sama pada Windows, Subsistem Windows untuk Linux (WSL), dan sistem jarak jauh.

Sebelum Anda mulai

Pertama, pastikan Anda telah menginstal beban kerja Linux Visual Studio, termasuk komponen CMake. Itulah pengembangan Linux dengan beban kerja C++ di alat penginstal Visual Studio. Lihat Menginstal beban kerja C++ Linux di Visual Studio jika Anda tidak yakin telah menginstalnya.

Selain itu, pastikan yang berikut ini diinstal pada komputer jarak jauh:

  • gcc
  • gdb
  • rsync
  • zip
  • ninja-build (Visual Studio 2019 atau lebih tinggi)

Dukungan CMake di Visual Studio memerlukan dukungan mode server yang diperkenalkan di CMake 3.8. Untuk varian CMake yang disediakan Microsoft, unduh biner bawaan terbaru di https://github.com/Microsoft/CMake/releases.

Biner diinstal di ~/.vs/cmake. Setelah menyebarkan biner, proyek Anda menghasilkan ulang secara otomatis. Jika CMake yang ditentukan oleh bidang cmakeExecutable di CMakeSettings.json tidak valid (tidak ada atau merupakan versi yang tidak didukung), dan biner bawaan ada, Visual Studio mengabaikan cmakeExecutable dan menggunakan biner bawaan.

Visual Studio 2017 tidak dapat membuat proyek CMake dari awal, tetapi Anda dapat membuka folder yang berisi proyek CMake yang ada, seperti yang dijelaskan di bagian berikutnya.

Anda dapat menggunakan Visual Studio 2019 untuk membangun dan melakukan debug pada sistem Linux jarak jauh atau WSL, dan CMake akan dipanggil pada sistem tersebut. Cmake versi 3.14 atau yang lebih baru harus diinstal pada komputer target.

Pastikan bahwa komputer target memiliki versi CMake yang terbaru. Sering kali, versi yang ditawarkan oleh manajer paket default distribusi tidak cukup baru untuk mendukung semua fitur yang diperlukan oleh Visual Studio. Visual Studio 2019 mendeteksi apakah versi terbaru CMake diinstal pada sistem Linux. Jika tidak ada yang ditemukan, Visual Studio memperlihatkan bilah-info di bagian atas panel editor. Visual Studio menawarkan untuk menginstal CMake untuk Anda dari https://github.com/Microsoft/CMake/releases.

Dengan Visual Studio 2019, Anda dapat membuat proyek CMake dari awal, atau membuka proyek CMake yang ada. Untuk membuat proyek CMake baru, ikuti instruksi di bawah ini. Atau lewati ke Membuka folder proyek CMake jika Anda sudah memiliki proyek CMake.

Membuat proyek Linux CMake baru

Untuk membuat proyek Linux CMake baru di Visual Studio 2019:

  1. Pilih File > Proyek Baru di Visual Studio, atau tekan Ctrl + Shift + N.
  2. Atur Bahasa ke C++ dan cari "CMake". Kemudian pilih Berikutnya. Masukkan Nama dan Lokasi, dan pilih Buat.

Atau, Anda dapat membuka proyek CMake sendiri di Visual Studio 2019. Bagian berikut menjelaskan caranya.

Visual Studio membuat file CMakeLists.txt minimal hanya dengan nama yang dapat dieksekusi dan versi CMake minimum yang diperlukan. Anda dapat mengedit file ini secara manual sesuai keinginan; Visual Studio tidak akan pernah menimpa perubahan Anda.

Untuk membantu Anda memahami, mengedit, dan menulis skrip CMake Anda di Visual Studio 2019, lihat sumber daya berikut:

Membuka folder proyek CMake

Saat Anda membuka folder yang berisi proyek CMake yang ada, Visual Studio menggunakan variabel dalam cache CMake untuk mengonfigurasi IntelliSense dan build secara otomatis. Konfigurasi lokal dan pengaturan penelusuran kesalahan disimpan dalam file JSON. Anda dapat secara opsional berbagi file ini dengan orang lain yang menggunakan Visual Studio.

Visual Studio tidak mengubah file CMakeLists.txt. Ini memungkinkan orang lain mengerjakan proyek yang sama untuk terus menggunakan alat yang ada. Visual Studio menghasilkan ulang cache saat Anda menyimpan pengeditan ke CMakeLists.txt, atau dalam beberapa kasus, ke CMakeSettings.json. Jika Anda menggunakan konfigurasi Cache yang Ada, Visual Studio tidak akan mengubah cache.

Untuk informasi umum tentang dukungan CMake di Visual Studio, lihat Proyek CMake di Visual Studio. Baca artikel tersebut sebelum melanjutkan di sini.

Untuk memulai, pilih File>Buka>Folder dari menu utama atau lainnya ketikdevenv.exe <foldername> di jendela prompt perintah pengembang. Folder yang Anda buka harus memiliki file CMakeLists.txt di dalamnya, beserta dengan kode sumber.

Contoh berikut menunjukkan file CMakeLists.txt sederhana dan file .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)

Langkah berikutnya

Mengonfigurasikan proyek Linux CMake

Lihat juga

Proyek CMake di Visual Studio