有時候我們需要把自己寫的類或者函數給別人使用,但又不希望讓別人知道具體的實現,那麼封裝成庫就是一個很好的方法。本文描述了怎麼去把一個C++程式封裝成一個靜態庫並且如何去使用這些靜態庫。 ...
零碎記事
距離上次發博客已經有一年半了,轉眼間我也是從做圖像研究到了做游戲開發,說起來看看前面的博文,本來就有前兆的東西呢(笑)......因為主要還是在使用虛幻引擎,所以C++的東西會碰到多一些。
以後程式技術方面的文章就放博客,游戲設計相關的雜談就放知乎那邊吧,博主的知乎可以通過友鏈過去。
B站那邊的賬號也打算開始複活,後面是更新游戲設計雜談類的視頻還是更新虛幻技術方面的視頻還在猶豫不決......
為什麼要把程式封裝成庫
有時我們需要把自己的程式交給第三方調用,但是又不想被別人看到自己的具體實現代碼,就封裝成庫給別人使用。庫有動態鏈接庫和靜態鏈接庫,區別是動態鏈接庫可以在程式運行時動態鏈接,而靜態鏈接庫相當於.cpp文件,在編譯時的鏈接階段就鏈接進去了。
博主的環境
系統:Window 10
IDE:VS2022
如果在使用的是其他IDE的,看完這個其實自己應該也能知道用其他IDE該怎麼操作,其實就是一個對編譯和鏈接過程的理解深度的問題,懂了在哪裡都能自己封裝和使用庫的。
這邊的演示有中文路徑,VS對中文路徑支持得確實還挺可以的,不會報錯。不過建議大家還是儘量別這樣了,就怕萬一你那邊對中文路徑支持不好,編譯出問題。
封裝步驟
準備好待封裝的程式
我準備了一個Point類,就當做是要給別人用的,現在我就把這個類封裝成靜態庫。
//Point.h #pragma once #include <utility> typedef std::pair<int, int> Coordinate; class Point { private: Coordinate location; public: Point(); Point(int x, int y); Coordinate GetLocation(); int GetX() const; int GetY() const; virtual Point operator + (const Point& B) const; virtual Point operator - (const Point& B) const; };
//Point.cpp #include "Point.h" Point::Point() : location(Coordinate(0, 0)) { } Point::Point(int x, int y): location(Coordinate(x, y)) { } Coordinate Point::GetLocation() { return location; } int Point::GetX() const { return location.first; } int Point::GetY() const { return location.second; } Point Point::operator+(const Point& B) const { return Point(GetX()+B.GetX(), GetY()+B.GetY()); } Point Point::operator-(const Point& B) const { return Point(); }
開始封裝
配置項目
平常我們是編譯成可執行文件(即.exe),現在我們設置一下,改成編譯成靜態庫(即.lib)。
這個設置在VS2022里是這樣的:
右擊項目->屬性->配置屬性->常規->配置類型->改為靜態庫
這樣我們編譯出來的東西就不是.exe文件,而是.lib文件了,也就是靜態鏈接庫。
編譯
這邊在VS2022里,編譯就是生成。
就跟編譯普通程式一樣,編譯成功。
找到編譯好的靜態庫
自己翻翻項目下麵的文件夾,能找到編譯出來的靜態庫的。
我這邊是 項目根目錄/x64/Debug/項目名.lib,就是下圖裡的那個Point.lib,這就是靜態庫。
打包
其實就是把頭文件跟靜態庫一起給別人就行了,靜態庫的作用跟.cpp文件差不多,使用時就是包含頭文件,然後鏈接到靜態庫把實現關聯起來即可。
使用靜態庫
使用步驟
包含頭文件
新建了個項目,這個項目要用到我的那個Point類,為了方便包含頭文件,我把上邊的那個有Point.h有和Point.lib的文件夾挪到新項目文件夾下了。
新建了個程式,要用到我寫的那個Point類,那就先包含Point.h,裡面有關於Point類的聲明。
//使用靜態庫.cpp
#include <iostream> #include "大摸魚師千里的Point類/Point.h" using namespace std; int main() { Point a(1, 2); Point b(3, 4); Point c = a + b; cout << c.GetX() << ", " << c.GetY() << endl; return 0; }
但是這個時候編譯還是通不過的,如下圖報了“無法解析外部符號”,是鏈接的錯誤來的。頭文件雖然有Point類聲明信息,但沒有實現的信息,實現的信息在靜態庫里,但是現在鏈接器還找不到靜態庫,所以報錯了。
添加鏈接路徑
有兩種方法,一種是在源文件里設置,另一種是在項目里設置。
源文件設置
先講在源文件里設置,其實就是加個編譯頭告訴鏈接器靜態庫的路徑而已,語法如下:
#pragma comment(lib, 你的靜態庫路徑)
這樣子鏈接器在搜索預設的庫文件路徑外,還會搜你這裡的設的靜態庫路徑。
在我這裡,加了就是會變成這樣:
//使用靜態庫.cpp #include <iostream> #include "大摸魚師千里的Point類/Point.h" using namespace std; #pragma comment(lib, "大摸魚師千里的Point類/Point.lib") int main() { Point a(1, 2); Point b(3, 4); Point c = a + b; cout << c.GetX() << ", " << c.GetY() << endl; return 0; }
因為鏈接器找到路徑了,編譯就能過了,程式正常運行,效果如下。
項目設置
VS2022里是這麼設置鏈接器搜索的庫目錄的
先是設置庫的目錄,項目屬性->VC++目錄->庫目錄->編輯->新行->把靜態庫所在目錄添加進去
因為這個時候只是加了搜索的庫目錄,但是還沒有具體到哪個庫,可以像上邊那樣用編譯頭來指定,就是不加相對路徑直接指定靜態庫,就像這樣。
#pragma comment(lib, "Point.lib")
現在講怎麼在項目里配置具體到指定庫。
項目屬性->鏈接器->輸入->附加依賴項->編輯->添加你的庫
設完就是不加編譯頭也能編譯運行程式了,這是效果
以上就是C++封裝庫和使用的全部內容了,覺得有學到的話可以點個贊嘿嘿。
搜索
複製