【Z站推薦】用AWTK編寫跨平臺的代碼

ZLG致遠電子 2022-09-07 11:35

AI重塑EDA設計流程｜2026芯片研發效率革命，來這里找答案… NFC 還能這樣用？瑞薩無線充電方案全解析

AWTK 是 ZLG 開源的跨平臺 GUI 引擎，本文介紹一下基于 AWTK 開發應用程序需要遵循的規范和方法，以保證應用程序也能跨平臺運行。

??盡量使用?tkc?中的函數

tkc 中提供了編碼、時間、網絡、串口、線程、互斥和文件系統等各種需要跨平臺接口的封裝，這些接口在各個平臺都有實現。

??針對接口編程

如果需要的某個功能，在各個平臺都有不同的實現，先研究各個平臺提供的功能，再抽象一個統一的接口，針對各個平臺實現一個適配器。應用程序使用統一的接口去訪問這些功能，應用程序不但能夠跨平臺運行，代碼也更具可讀性。

??指定特定平臺的庫、頭文件、預處理參數和鏈接參數

helper 提供了一組函數來處理不同平臺的參數。平臺名稱的取值有：

“Windows” Windows 平臺；
“Linux” Linux 平臺；
“Darwin” MacOS 平臺；
* Android 和 IOS 不使用 scons 編譯，故不使用這種方式。

添加平臺特有的庫；? ??
示例：

helper.add_platform_libs("Windows",?["ws2_32"])

helper.add_platform_libs("Linux",?["pthread",?"dl",?"readline",?"m"])

helper.add_platform_libs("Darwin",?["pthread",?"dl",?"readline",?"m"])

添加平臺特有的庫的搜索路徑；? ??

add_platform_libpath(self,?platform_name,?APP_LIBPATH)

示例：

helper.add_platform_libpath("Linux",?["/usr/local/lib"])

* 注意這里的 APP_LIBPATH 是數組類型。

添加平臺特有的頭文件的搜索路徑；

add_platform_cpppath(self, platform_name, APP_CPPPATH)

示例：

helper.add_platform_libpath("Linux", ["/usr/local/include"])

* 注意這里的 APP_CPPPATH 是數組類型。

添加平臺特有的宏定義預處理參數；

add_platform_ccflags(self, platform_name, APP_CCFLAGS)

示例：

helper.add_platform_ccflags("Linux", " -DSOME_MACRO=1 ")

* ccflags 是字符串格式不是數組。

添加平臺特有的C++文件的預處理參數；

add_platform_cxxflags(self, platform_name, APP_CXXFLAGS)

示例：

helper.add_platform_cxxflags("Linux", " -DSOME_MACRO=1 ")

* cxxflags 是字符串格式不是數組。

添加平臺特有的鏈接參數；

add_platform_linkflags(self,?platform_name,?APP_LINKFLAGS)

* linkflags 是字符串格式不是數組。

??區分各個平臺的宏

WIN32 或 WINDOWS Windows 平臺；
MINGW Windows 平臺的 MinGW 編譯；
LINUX Linux 平臺；
MACOS 或__APPLE__ Macos 平臺；
ANDROID Android 平臺；
IOS iOS 平臺。

* 這些宏雖然可以區分不同的平臺，但是如果將這些宏分散在應用程序中，代碼將會變得丑陋難讀。建議先定義接口，在適配器中使用這些宏。

示例：

#ifdef?ANDROID
#include?"SDL.h"
#endif?/*ANDROID*/

#if?defined(__APPLE__)?||?defined(LINUX)
#include?
#include?
#include?
#include?
#elif?defined(WIN32)
#include?
#include?
#include?
#include?
#include?
#include?
#define?unlink?_unlink
#define?rename?MoveFileA
#define?ftruncate?_chsize
#include?"./dirent.inc"
#include?"tkc/utf8.h"
#include?"tkc/mem.h"
#endif

#if?defined(__APPLE__)
#include?
#endif?/*__APPLE__*/