vs2019+cmake實(shí)現(xiàn)Linux遠(yuǎn)程開(kāi)發(fā)的方法步驟

在上一篇文章中我們介紹了使用vs2019作為遠(yuǎn)程Linux系統(tǒng)的開(kāi)發(fā)環(huán)境，但我們是創(chuàng)建的傳統(tǒng)的sln項(xiàng)目，而對(duì)于Linux開(kāi)發(fā)者來(lái)說(shuō)以autotools或是cmake進(jìn)行項(xiàng)目結(jié)構(gòu)的組織更為簡(jiǎn)單直觀，也符合在Linux環(huán)境上的習(xí)慣。

autotools是較為古老的也是使用最為廣泛的構(gòu)建系統(tǒng)，你在Linux上總是避免不了類似./configure make這樣的命令，背后就是autotools為你完成了檢測(cè)系統(tǒng)環(huán)境到生成makefile的一系列工作。

cmake是較新的一種工具，autotools雖然功能強(qiáng)大使用廣泛，但是它的學(xué)習(xí)成本和維護(hù)成本也十分驚人，所以人們創(chuàng)造了cmake來(lái)簡(jiǎn)化工作。cmake十分簡(jiǎn)單易學(xué)，在表現(xiàn)力上絲毫不亞于autotools，同時(shí)還提供了豐富的官方模塊和第三方模塊以便于定制各種各樣的功能。已經(jīng)有許多項(xiàng)目開(kāi)始使用cmake了，例如google test框架，qbittorrent，KDE，_MySQL_等，未來(lái)Qt也會(huì)從qmake遷移至cmake，目前已經(jīng)提供了初步支持。

遺憾的是vs2019并不支持autotools工具鏈，但是vs2019支持cmake，而且相比vs2017，vs2019提供了遠(yuǎn)程開(kāi)發(fā)的cmake支持，并且支持了更多的設(shè)置選項(xiàng)，所以我們今天將會(huì)介紹如何使用vs2019+cmake實(shí)現(xiàn)Linux遠(yuǎn)程開(kāi)發(fā)。不過(guò)需要注意的是，本文是介紹如何搭建開(kāi)發(fā)環(huán)境的，并不會(huì)介紹cmake的語(yǔ)法，并且我也假設(shè)各位讀者已經(jīng)基本了解了簡(jiǎn)單的CMkaeLists.txt該如何編寫(xiě)，如果不了解那么你可能需要先進(jìn)行簡(jiǎn)單的cmake學(xué)習(xí)，這超出了本文的討論范圍你可以尋找其他的博客園文章學(xué)習(xí)相關(guān)知識(shí)。當(dāng)然，即使理解不了后文所羅列的CMakeLists.txt的內(nèi)容也沒(méi)關(guān)系，我會(huì)盡量給出簡(jiǎn)單易懂的注釋。

好了，現(xiàn)在該讓我們進(jìn)入主題了。

創(chuàng)建遠(yuǎn)程cmake項(xiàng)目

創(chuàng)建很簡(jiǎn)單，在vs的啟動(dòng)窗口中選擇“創(chuàng)建新項(xiàng)目”，然后找到“CMkae項(xiàng)目”，選擇后點(diǎn)擊下一步即可，和創(chuàng)建傳統(tǒng)項(xiàng)目的過(guò)程完全一樣，如圖：

創(chuàng)建完成后你的項(xiàng)目里會(huì)是如下的場(chǎng)景（假如項(xiàng)目名稱叫CMakeProject1）：

也許你會(huì)奇怪，為什么cmake項(xiàng)目不像sln項(xiàng)目那樣區(qū)分出Linux和Windows平臺(tái)呢？答案是我們可以通過(guò)對(duì)項(xiàng)目進(jìn)行設(shè)置來(lái)切換本地環(huán)境和遠(yuǎn)程環(huán)境！

整個(gè)項(xiàng)目由CMakeLists.txt進(jìn)行組織，而vs則負(fù)責(zé)在什么環(huán)境上運(yùn)行cmake，這樣就實(shí)現(xiàn)了同一套項(xiàng)目可以幾乎不經(jīng)過(guò)修改在不同平臺(tái)上編譯運(yùn)行（只要你的目標(biāo)平臺(tái)裝有cmake，且版本最低為3.8；本地環(huán)境vs自帶了cmake）。

默認(rèn)情況下的cmake project是在本地環(huán)境的，所以接下來(lái)我們創(chuàng)建一個(gè)叫“LinuxQt”的遠(yuǎn)程項(xiàng)目，接著設(shè)置對(duì)應(yīng)的遠(yuǎn)程Linux環(huán)境。

設(shè)置遠(yuǎn)程環(huán)境

設(shè)置遠(yuǎn)程環(huán)境之前，你需要先在頂部的工具菜單的選項(xiàng)對(duì)話框中將遠(yuǎn)程連接設(shè)置好，并同步遠(yuǎn)程環(huán)境的頭文件，具體過(guò)程可以參考這篇，過(guò)程一樣就不贅述了。

在初始的項(xiàng)目中啟動(dòng)項(xiàng)要么是某個(gè)文件要么是空的，沒(méi)有我們的遠(yuǎn)程環(huán)境，所以我們需要右鍵資源管理器中顯示的CMakeLists.txt文件：

找到“project-name的CMake設(shè)置”，project-name是你的項(xiàng)目名稱，點(diǎn)擊。這時(shí)會(huì)生成一個(gè)“CMakeSettings.json”的文件，這是整個(gè)項(xiàng)目的配置文件，雙擊打開(kāi)會(huì)顯示圖形化的配置界面：

首先我們看到了配置名稱，這是給你的自定義配置起名字的地方，右邊的綠色加號(hào)表示添加新的配置，因?yàn)槲覀冎幌胧褂肔inux遠(yuǎn)程環(huán)境，所以我們直接修改了默認(rèn)的配置項(xiàng)。

接下來(lái)是配置類型，這和cmake中的選項(xiàng)對(duì)應(yīng)，在此處設(shè)置后就無(wú)需再寫(xiě)進(jìn)CMakeLists.txt了，有Debug，Release等模式，我們選擇Release，因?yàn)檫h(yuǎn)程環(huán)境上的Qt我沒(méi)有安裝調(diào)試符合，選Debug除了增大編譯目標(biāo)的體積外也沒(méi)什么用。

下面則是重點(diǎn)，遠(yuǎn)程計(jì)算機(jī)名稱選項(xiàng)。點(diǎn)擊下拉框即可出現(xiàn)我們?cè)谶B接管理器中添加的遠(yuǎn)程環(huán)境，如果你沒(méi)有添加遠(yuǎn)程環(huán)境，在右側(cè)的按鈕可以直接打開(kāi)連接管理器進(jìn)行添加。該選項(xiàng)默認(rèn)是空的，也就是本機(jī)編譯不啟用遠(yuǎn)程環(huán)境。

接下來(lái)是工具集，也就是最終調(diào)用的編譯器工具鏈，vs支持gcc和clang，linux_x64對(duì)應(yīng)gcc，linux_clang_x64對(duì)應(yīng)clang，此外還有arm平臺(tái)的支持，選用什么工具鏈看對(duì)應(yīng)平臺(tái)和個(gè)人喜好，我這里選擇了gcc。

然后是“遠(yuǎn)程生成根”這個(gè)選項(xiàng)，截圖里未給出，這是遠(yuǎn)程編譯時(shí)vs存放整個(gè)項(xiàng)目的路徑，默認(rèn)在你的家目錄下的.vs目錄里，你也可以根據(jù)自己的需要修改這一路徑，我們演示用的項(xiàng)目就直接使用默認(rèn)值了。

生成根選項(xiàng)后是設(shè)置調(diào)用cmake程序時(shí)的參數(shù)的，只要把需要的參數(shù)原樣填入輸入框即可，這里我們沒(méi)用到也就不截圖了。

vs2019中一個(gè)強(qiáng)大的功能就是可以把cmake中由系統(tǒng)或是模塊產(chǎn)生的變量的值顯示出來(lái)（需要在cache成功刷新之后，也就是cmakelists文件保存后或手動(dòng)在項(xiàng)目菜單中單擊為項(xiàng)目生成緩存）：

接著我們點(diǎn)擊顯示高級(jí)選項(xiàng)，因?yàn)橄胍獀s能提供代碼補(bǔ)全還需要一點(diǎn)設(shè)置：

在這里你可以設(shè)置cmake生成什么類型的makefile，cmake的運(yùn)行目錄和編譯完成后程序的安裝目錄，以及cmake本身所在的路徑（如果你把cmake安裝到了不太常規(guī)的地方例如/opt）。

其中重點(diǎn)關(guān)注IntellSense選項(xiàng)，這是選擇代碼補(bǔ)全的引擎：

可以看到所有選項(xiàng)都是由平臺(tái)名稱-編譯器名稱-32位/64位這種格式組成的，默認(rèn)值是空，我們想要代碼補(bǔ)全可用就要選擇和遠(yuǎn)程環(huán)境完全對(duì)應(yīng)的那種模式。

另外右上角一直有直接編輯json文件的按鈕，如果你討厭gui的話可以選擇它。

最后我們保存修改，vs會(huì)自動(dòng)刷新cache，現(xiàn)在我們可以進(jìn)行遠(yuǎn)程開(kāi)發(fā)了。

編寫(xiě)CMakeLists.txt

前面說(shuō)過(guò)cmake項(xiàng)目的組織需要依靠CMakeLists.txt，現(xiàn)在我們來(lái)編寫(xiě)它。

我們的測(cè)試項(xiàng)目會(huì)使用Qt，隨機(jī)顯示一些不同引擎產(chǎn)生的隨機(jī)數(shù)，然后把它們顯示在圖表中。選擇這個(gè)示例是為了更好的展示cmake項(xiàng)目的能力，但是遠(yuǎn)程開(kāi)發(fā)gui程序在vs上目前還有些困難：

vs運(yùn)行遠(yuǎn)程環(huán)境的程序依靠ssh，然而Linux的gui程序運(yùn)行需要連接xserver（通常連接信息在環(huán)境變量中），ssh啟動(dòng)的shell環(huán)境里沒(méi)有這些環(huán)境變量，你可能還需要額外設(shè)置程序啟動(dòng)時(shí)的命令行參數(shù)，否則運(yùn)行會(huì)發(fā)生錯(cuò)誤。這是Qt自身的原因，Qt依賴自己的moc系統(tǒng)，和原生c++有些出入，因此代碼補(bǔ)全時(shí)會(huì)經(jīng)常找不到類型等（clion沒(méi)有此類問(wèn)題）。vs自身的問(wèn)題，雖然Qt自己支持cmake，但是vs在遠(yuǎn)程環(huán)境調(diào)用moc時(shí)不能正常工作，自定義widget會(huì)報(bào)類似找不到vtable等問(wèn)題。qt vs tool無(wú)法在遠(yuǎn)程環(huán)境工作。

雖然有以上的缺陷，但是我們編寫(xiě)單個(gè)文件的項(xiàng)目并且不自定義widget，同時(shí)只編譯生成程序而不運(yùn)行的話還是沒(méi)有問(wèn)題的。

下面來(lái)看看CMakeLists.txt是如何編寫(xiě)的：

project(LinuxQtExample)

# 設(shè)置c++語(yǔ)言標(biāo)準(zhǔn)，我使用c++17
set(CMAKE_CXX_STANDARD 17)

cmake_minimum_required (VERSION 3.10)

set(CMAKE_INCLUDE_CURRENT_DIR ON)

# 自動(dòng)調(diào)用moc, uic, rcc
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTORCC ON)

# 找到這些Qt組件
find_package(Qt5Widgets REQUIRED)
find_package(Qt5Core REQUIRED)
find_package(Qt5Gui REQUIRED)
find_package(Qt5Charts REQUIRED)

# 將源代碼添加到此項(xiàng)目的可執(zhí)行文件。
add_executable (LinuxQt "main.cpp")

# 將Qt的庫(kù)鏈接至程序
target_link_libraries(LinuxQt Qt5::Core Qt5::Widgets Qt5::Gui Qt5::Charts)

更多如何用cmake構(gòu)建Qt程序的內(nèi)容請(qǐng)移步這里。

編寫(xiě)測(cè)試代碼

上述設(shè)置結(jié)束后就可以著手編寫(xiě)代碼了，代碼提示和補(bǔ)全也能工作了（雖然對(duì)于Qt的部分補(bǔ)全不正常，但是c++標(biāo)準(zhǔn)庫(kù)的補(bǔ)全是可以正常工作的）：

#include QApplication>
#include QBarCategoryAxis>
#include QBarSet>
#include QBarSeries>
#include QChart>
#include QChartView>
#include QPushButton>
#include QString>
#include QStringList>
#include QValueAxis>
#include QVBoxLayout>

#include iostream>
#include random>

// 這個(gè)函數(shù)里變量名起的很爛，因?yàn)槭鞘纠彝祽辛?，?qǐng)你不要在實(shí)際項(xiàng)目中寫(xiě)出這種代碼
// 創(chuàng)建柱狀圖數(shù)據(jù)的函數(shù)
// std::random_device的某些實(shí)現(xiàn)在Windows上存在bug，每次運(yùn)行會(huì)返回同樣的結(jié)果序列，linux沒(méi)問(wèn)題
// QtCharts的所有類型/函數(shù)都在對(duì)應(yīng)的命名空間中，和其他的QtWidgets不同
static QtCharts::QBarSeries* createSeries()
{
	auto dataSet1 = new QtCharts::QBarSet("mt19937");
	auto seed = std::random_device{}();
	std::uniform_int_distributionint> u(0, 100);
	std::mt19937 rd1(seed);
	for (int i = 0; i  10; ++i) {
		auto a = u(rd1);
		std::cout  a  std::endl;
		*dataSet1  a;
	}

	auto dataSet2 = new QtCharts::QBarSet("minstd_rand");
	std::minstd_rand rd2(seed);
	for (int i = 0; i  10; ++i) {
		auto a = u(rd2);
		std::cout  a  std::endl;
		*dataSet2  a;
	}

	auto dataSet3 = new QtCharts::QBarSet("default");
	std::default_random_engine rd3(seed);
	for (int i = 0; i  10; ++i) {
		auto a = u(rd3);
		std::cout  a  std::endl;
		*dataSet3  a;
	}

	auto dataSet4 = new QtCharts::QBarSet("ranlux48");
	std::ranlux48 rd4(seed);
	for (int i = 0; i  10; ++i) {
		auto a = u(rd4);
		std::cout  a  std::endl;
		*dataSet4  a;
	}

	auto dataSet5 = new QtCharts::QBarSet("knuth_b");
	std::knuth_b rd5(seed);
	for (int i = 0; i  10; ++i) {
		auto a = u(rd5);
		std::cout  a  std::endl;
		*dataSet5  a;
	}

	auto barSeries = new QtCharts::QBarSeries;
	barSeries->append(dataSet1);
	barSeries->append(dataSet2);
	barSeries->append(dataSet3);
	barSeries->append(dataSet4);
	barSeries->append(dataSet5);
	return barSeries;
}

int main(int argc, char* argv[])
{
	QApplication app(argc, argv);
	auto chart = new QtCharts::QChart;

	// 創(chuàng)建Y軸顯示數(shù)據(jù)
	auto axisY = new QtCharts::QValueAxis;
	axisY->setRange(0, 100);
	axisY->setTickCount(10);
	axisY->setTitleText("Y軸");
	chart->addAxis(axisY, Qt::AlignLeft);

	// x軸顯示10次取隨機(jī)數(shù)的結(jié)果
	QStringList x;
	for (int i = 0; i  10; ++i) {
		x  QString::number(i+1);
	}
	auto axisX = new QtCharts::QBarCategoryAxis;
	axisX->append(x);
	chart->addAxis(axisX, Qt::AlignBottom);

	auto barSeries = createSeries();
	chart->addSeries(barSeries);

	chart->setTitle("隨機(jī)數(shù)分布圖");
	// 顯示圖例以及讓圖例擺放在圖表的底部
	chart->legend()->setVisible(true);
	chart->legend()->setAlignment(Qt::AlignBottom);
	// 顯示chart的容器
	auto view = new QtCharts::QChartView(chart);
	view->setRenderHint(QPainter::Antialiasing);

	auto layout = new QVBoxLayout;
	layout->addWidget(view);
	// 點(diǎn)擊按鈕刷新顯示的數(shù)據(jù)
	auto button = new QPushButton("點(diǎn)擊刷新");
	QObject::connect(button, QPushButton::clicked, [chart]() {
		// removeAll會(huì)幫你刪除原來(lái)的series，所以不必?fù)?dān)心內(nèi)存泄漏
		chart->removeAllSeries();
		auto barSeries = createSeries();
		chart->addSeries(barSeries);
	});
	layout->addWidget(button, Qt::AlignCenter);
	auto window = new QWidget;
	window->setLayout(layout);
	window->setWindowTitle("圖表");
	// 圖表默認(rèn)會(huì)顯示成最小，為了不讓圖表縮成一團(tuán)需要給一個(gè)固定的大小
	window->resize(700, 500);
	window->show();
	app.exec();
}

代碼中使用了utf8編碼的中文字符串，你需要設(shè)置源文件的編碼為utf8以免在Linux上運(yùn)行時(shí)出現(xiàn)亂碼。具體見(jiàn)這里。

運(yùn)行測(cè)試

如之前所說(shuō)，我們不能直接點(diǎn)擊運(yùn)行按鈕，所以對(duì)于gui程序我們只能選擇頂部工具欄的生成->全部生成，這樣vs會(huì)自動(dòng)調(diào)用cmake和make來(lái)完成程序的構(gòu)建：

可以看到vs將整個(gè)項(xiàng)目用rsync同步到了遠(yuǎn)程機(jī)上，接著運(yùn)行了cmake和make。

生成成功后我們到之前設(shè)置的“遠(yuǎn)程生成根”下out/build/...，省略號(hào)表示的是你的cmake項(xiàng)目配置的名字，編譯好的程序就在這里，下面在遠(yuǎn)程環(huán)境中運(yùn)行：

總結(jié)

cmake項(xiàng)目總體上比sln更簡(jiǎn)單也更好控制，只是細(xì)節(jié)上還有欠缺。

cmake本省也簡(jiǎn)單易學(xué)，有著強(qiáng)大的功能，如果你是從Linux上的開(kāi)發(fā)環(huán)境遷移至Windows不妨試一試cmake。

到此這篇關(guān)于vs2019+cmake實(shí)現(xiàn)Linux遠(yuǎn)程開(kāi)發(fā)的方法步驟的文章就介紹到這了,更多相關(guān)vs2019 Linux遠(yuǎn)程開(kāi)發(fā)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！