建站
咨詢
售后
建站咨詢
新聞中心
一、緣起
在上一篇文章中，分享了一個(gè)跨平臺(tái)的頭文件是長成什么樣子的，這個(gè)頭文件對于 windows 平臺(tái)下更有意義一些，因?yàn)橐幚韼旌瘮?shù)的導(dǎo)入和導(dǎo)出聲明(dllexport、dllimport)。
創(chuàng)新互聯(lián)建站是一家專注于成都做網(wǎng)站、成都網(wǎng)站設(shè)計(jì)與策劃設(shè)計(jì),同仁網(wǎng)站建設(shè)哪家好?創(chuàng)新互聯(lián)建站做網(wǎng)站,專注于網(wǎng)站建設(shè)十年,網(wǎng)設(shè)計(jì)領(lǐng)域的專業(yè)建站公司;建站業(yè)務(wù)涵蓋:同仁等地區(qū)。同仁做網(wǎng)站價(jià)格咨詢:13518219792
其實(shí)，可以在這個(gè)頭文件的基礎(chǔ)上繼續(xù)擴(kuò)充，以達(dá)到更細(xì)粒度的控制。例如：對編譯器的判斷、對編譯器版本的判斷等等。
同樣的，我們在源代碼中也會(huì)遇到一些跨平臺(tái)的問題。不同的功能，在不同的平臺(tái)下，實(shí)現(xiàn)方式是不一樣的，如何對這些平臺(tái)相關(guān)的代碼進(jìn)行組織呢?這篇文章就來聊聊這個(gè)問題。
PS: 文末提供了一個(gè)簡單的、跨平臺(tái)構(gòu)建代碼示例。
二、問題引入
假設(shè)我們寫一個(gè)庫，需要實(shí)現(xiàn)一個(gè)函數(shù)：獲取系統(tǒng)時(shí)間戳。作為實(shí)現(xiàn)庫的作者，你決定提供下面的 API 函數(shù)：
- t_time.h: 聲明接口函數(shù)（t_get_timestamp）；
- t_time.c：實(shí)現(xiàn)接口函數(shù)；
下面的任務(wù)就是在函數(shù)實(shí)現(xiàn)中，通過不同下的 C 庫或系統(tǒng)調(diào)用，來計(jì)算系統(tǒng)當(dāng)前的時(shí)間戳。
在 Linux 平臺(tái)下，可以通過下面這段代碼實(shí)現(xiàn)：
- struct timeval tv;
- gettimeofday(&tv, null);
- return tv.tv_sec * 1000 + tv.tv_usec / 1000;
在 Windows 平臺(tái)下，可以通過下面這段代碼實(shí)現(xiàn)：
- struct timeb tp;
- ftime(&tp);
- return tp.time *1000 + tp.millitm;
那么問題來了：怎么把這兩段平臺(tái)相關(guān)的代碼組織在一起?下面就介紹 3 種不同的組織方式，沒有優(yōu)劣之分，每個(gè)人都有不同的習(xí)慣，選擇適合自己和團(tuán)隊(duì)的方式就行。
此外，這個(gè)示例中只有 1 個(gè)函數(shù)，而且比較短小。如果這種跨平臺(tái)的函數(shù)很多、而且都很長，也許你的選擇又不一樣了。
三、三個(gè)解決方案
方案1
直接在接口函數(shù)中，通過平臺(tái)宏定義來區(qū)分不同平臺(tái)。
平臺(tái)宏定義(T_LINUX, T_WINDOWS)，是在上一篇文章中介紹的，通過操作系統(tǒng)、編譯器來判斷當(dāng)前的平臺(tái)是什么，然后定義出統(tǒng)一的平臺(tái)宏定義為我們自己所用：
代碼組織方式如下：
- int64 t_get_timestamp()
- {
- int64 ts = -1;
- #if defined(T_LINUX)
- struct timeval tv;
- gettimeofday(&tv, null);
- ts = tv.tv_sec * 1000 + tv.tv_usec / 1000;
- #elif defined(T_WINDOWS)
- struct timeb tp;
- ftime(&tp);
- ts = tp.time;
- ts = ts *1000 + tp.millitm;
- #endif
- return ts;
- }
這樣的方式，把所有平臺(tái)代碼全部放在 API 函數(shù)中了，通過平臺(tái)宏定義進(jìn)行條件編譯，因?yàn)榇a比較短小，看起來還不錯(cuò)。
方案2
把不同平臺(tái)的實(shí)現(xiàn)代碼放在獨(dú)立的文件中，然后通過 #include 預(yù)處理符號，在 API 函數(shù)中，把平臺(tái)相關(guān)的代碼引入進(jìn)來。
也就是再增加 2 個(gè)文件：
- t_time_linux.c：存放 Linux 平臺(tái)下的代碼實(shí)現(xiàn)；
- t_time_windows.c：存放 Windows 平臺(tái)下的代碼實(shí)現(xiàn)；
(1) t_time_linux.c
- #include "t_time.h"
- #include
- int64 t_get_timestamp()
- {
- int64 ts = -1;
- struct timeval tv;
- gettimeofday(&tv, null);
- ts = tv.tv_sec * 1000 + tv.tv_usec / 1000;
- return ts;
- }
(2) t_time_windows.c
- #include "t_time.h"
- #include
- #include
- int64 t_get_timestamp()
- {
- int64 ts = -1;
- struct timeb tp;
- ftime(&tp);
- ts = tp.time;
- ts = ts *1000 + tp.millitm;
- return ts;
- }
(3) t_time.c
這個(gè)文件不做任何事情，僅僅是 include 其他的代碼。
- #include "t_time.h"
- #if defined(T_LINUX)
- #include
- #elif defined(T_WINDOWS)
- #include
- #else
- int64 t_get_timestamp()
- {
- return -1;
- }
- #endif
有些人比較反感這樣的組織方式，一般都是 include 一個(gè) .h 頭文件，而這里通過平臺(tái)宏定義，include 不同的 .c 源文件，感覺怪怪的?!
其實(shí)，也有一些開源庫是這么干的，比如下面：
方案3
在上面方案2中，是在源代碼中填入不同平臺(tái)的實(shí)現(xiàn)代碼。
其實(shí)可以換一種思路，既然已經(jīng)根據(jù)平臺(tái)的不同、放在不同的文件中了，那么可以讓不同的源文件加入到編譯過程中就可以了。
測試代碼是使用 cmake 工具來構(gòu)建的，因此可以編輯 CMakelists.txt 文件，來控制參與編譯的源文件。
CMakelists.txt 文件部分內(nèi)容
- # 設(shè)置平臺(tái)變量
- if (CMAKE_SYSTEM_NAME MATCHES "Linux")
- set(PLATFORM linux)
- elseif (CMAKE_SYSTEM_NAME MATCHES "Windows")
- set(PLATFORM windows)
- endif()
- # 根據(jù)平臺(tái)變量，來編譯不同的源文件
- set(LIBSRC t_time_${PLATFORM}.c)
這樣的組織方式，感覺代碼更“干凈”一些。同樣的，我們也可以看到一些開源庫也是這么做的：
四、One More Thing
為了文章的篇幅，以上只是貼了代碼的片段。
我寫了一個(gè)最簡單的 demo，使用 cmake 來構(gòu)建跨平臺(tái)的動(dòng)態(tài)庫、靜態(tài)庫、可執(zhí)行程序。寫這個(gè) demo 的目的，主要是作為一個(gè)外殼，來測試一些寫文章時(shí)的代碼。
在 Linux 平臺(tái)下，通過 cmake 指令手動(dòng)編譯;在 Windows 平臺(tái)下，可以通過 CLion 集成開發(fā)環(huán)境直接編譯、執(zhí)行，也可以通過 cmake 工具直接生成 VS2017/2019 解決方案。
已經(jīng)把這個(gè) demo 放在 gitee 倉庫中了，感興趣的小伙伴，請?jiān)诠娞柣貜?fù)：dg36，即可收到克隆地址。
分享標(biāo)題：詳解跨平臺(tái)代碼的3種組織方式
分享URL：http://fisionsoft.com.cn/article/dhdhsog.html
