調用外部DLL/LIB程序

在用戶自定義開發過程中，常常會遇到需要調用外部 DLL/LIB 程序文件的需求，這些文件可能是用戶自己編寫的，也可能是其它供應商提供的。TSMaster 支持調用外部二進制程序庫，但必須通過一定的方法進行封裝。本節內容以調用 NI 公司的 TDMS 文件記錄程序為例，演示封裝 DLL 庫的方法，而 LIB 庫的使用與 DLL 類似，用戶可以在 visual studio工程中執行類似操作實現。

一 獲取外部程序庫

NI 公司的 TDMS 庫可以通過此鏈接下載，對于外部庫的使用，請注意以下限制：

1. 在下載外部程序庫的過程中，請注意發布程序庫的使用協議，同星公司僅提供外部程序庫的使用環境，不為違反外部庫使用協議的行為負責；

2. 外部庫被 TSMaster 載入后，即成為了主程序的一部分，如果外部庫發生了崩潰/內存溢出等行為，會導致 TSMaster 程序不穩定或崩潰，此時需要重新打開軟件并卸載有問題的外部庫；

3. TSMaster 僅支持 32bit-msvc 版本的外部庫，請使用合適版本的 DLL/LIB 文件，否則會導致編譯過程出錯。

（在附件的“tdms_example\TDM C DLL”目錄下，可以找到解壓后的 TDMS 外部庫相關文件。）

二 準備外部庫調用模板

該模板可以從 TSMaster 程序中拷貝，通過 幫助->api 例程-> Mini Program SDK 目錄下名為 VC++的工程，將該工程復制到其它用戶自定義的位置備用即可。

在附件“tdms_example\tdms_sdk”可以看到為 TDMS 功能準備的工程。

三 編輯模板并生成DLL

無論外部庫是 DLL 還是 LIB，或者兩者均有，都可以在模板工程中被調用。需要注意的是，為了能夠使得 TSMaster 能夠正常識別，用戶在準備模板工程過程中，除了實現自己的邏輯外，還需要提供函數的注釋，參數說明等信息。具體方法可以打開默認模板文件，在全局搜索 fun1 關鍵字，該函數為一個示例函數，它出現的地方，也就是用戶需要添加自定義內容的地方。

如上圖所示，可以看到在 MPLibCode.cpp 文件中，實現了 fun1 函數的聲明和實現，在 MPLibCodeExtern.cpp 文 件 中 ， 向 dll 管 理 模 板 注 冊 了 函 數 fun1 的 存 在 ， 在 TSMasterBaseSource.cpp 文件中，向 dll 管理模板注冊了 fun1 函數的相關參數信息。

在集成 TDMS 功能過程中，首先需要將編譯過程需要的 h 文件和 lib 文件拷貝到工程目錄下，并在工程鏈接器中將 LIB 文件作為輸入。對于外部函數，例如 TDMS 庫自帶的DDC_CreateFile 函數，在模板中使用一個新的函數進行封裝，將其命名為 tdms_CreateFile。盡管 LIB 文件的函數可以直接導出，但通常建議新建一個函數對它進行封裝，一是可以統一函數的名稱，便于用戶區分，而是所有 API 的函數返回值必須為 int 類型，如果原生外部庫不是該返回類型，則必須通過傳遞指針等方式獲取返回值，此時必須通過封裝的形式使用。

TDMS 其它的函數封裝過程請參考示例工程，請務必注意封裝函數代碼和函數注冊代碼需要匹配，才能正確工作。基于該模板，在 Debug/Release-x86 模式下，可以生成所需的“tdms_sdk.dll”。

四 在TSMaster中調用模板DLL

為了在 TSMaster 中調用“tdms_sdk.dll”，可以將該 dll 直接拖入，或者通過仿真->小程序庫->加載的方式載入，如下圖所示，直接加載會失敗，這是由于模板 dll 依賴了 TDMS運行時 DLL 文件，依賴文件在“tdms_example\TDM C DLL\dev\bin\32-bit”目錄下，由 NI公司提供，將所有文件拷貝到 TSMaster 工程\Plugins\Dependencies 目錄下（這個目錄需要手動創建，默認 TSMaster 不會創建），再載入模板 dll，即可正確載入。

打開示例工程“tdms_example\tdms_example”，在測試系統的第一條用例，為 TDMS文件生成測試代碼。用戶也可以新建小程序來調用，兩者在操作上沒有區別，都需先在屬性窗口中，勾選所需外部庫，然后在腳本程序中調用所需函數。如下圖所示，腳本運行后會在 D 盤根目錄下創建一個示例 TDMS 文件。

直接運行該腳本，可以發現程序能夠運行但并未按需創建 TDMS 文件，通過運行記錄文件查看錯誤消息，可以看到提示未能打開存儲設備。這個問題是 TDMS 庫所特有的，因為它的依賴文件中，除了 dll 外，還包含一個名為 DataModels 的文件夾，TSMaster 在使用“tdms_example\Plugins\Dependencies”目錄下的依賴文件時，不會對文件夾進行關聯，因此需要手動把該文件夾復制到 TSMaster 安裝程序目錄，例如“C:\ProgramFiles(x86)\TOSUN\TSMaster\bin”。有些外部庫只有 dll 依賴，則不需要手動復制操作。

解決依賴的文件夾后，即可正確生成 TDMS 文件。用戶可以參考以上過程，實現自己的邏輯。整個過程需要對 visual stuido 環境具備一定了解，如有不清楚的地方，請參考示例工程。

五 在TSMaster中調試模板DLL

在使用模板 dll 過程中，不可避免存在調試過程。用戶可以修改模板 visual stuido 中項目屬性->常規->輸出目錄，將 dll 的目錄輸出到調試使用的工程中“MPLibrary”目錄下。例如將“tdms_example”示例中 dll 生成到“tdms_example\tdms_example\MPLibrary”下，然后先運行 TSMaster 工程，再啟動 visual stuido 調試功能。調試過程與小程序調試方法一致，可以參考小程序的調試過程。