C++ 網絡開發包 ACE 環境配置與編譯完整指南

前言

ACE (Adaptive Communication Environment) 是一個開源的 C++ 網絡編程框架，它封裝了底層的 Socket API，提供了更健壯、可移植且相對簡單的開發介面。對於初學者而言，環境搭建往往是第一道門檻。本文記錄了在 Windows 2000 + VC6.0 環境下，從下載、編譯到專案配置的完整實戰步驟，幫助開發者快速跨過配置障礙，專注於網絡程式設計本身。

一、獲取源碼與解壓

1. 官方資源

• ACE 官方首頁：https://www.cs.wustl.edu/~schmidt/ACE.html
• 下載頁面：https://deuce.doc.wustl.edu/Download.html

建議下載：Latest Beta Kit 中的 ACE.zip。經測試，Latest Release 版本的壓縮包在 WinRAR 3.30 下解壓會報錯。

2. 解壓路徑

將壓縮包解壓至 D:\ACE_wrappers。後續所有路徑均以此為基準。

二、核心配置文件建立

在 D:\ACE_wrappers\ace 目錄下新建 config.h，僅需加入一行：

#include "ace/config-win32.h"

此步驟告訴 ACE 使用 Windows 平台的配置定義，是編譯成功的關鍵。

三、ACE 庫編譯 (動態/靜態)

1. 編譯動態庫

• 用 VC6.0 打開 D:\ACE_wrappers\ace\ace.dsw
• 工作區顯示 ACE DLL classes 與 ACE LIB classes 兩個專案組
• 選單 Build → Set Active Configuration，選擇所需配置（如 ACE DLL - Win32 MFC Debug）
• 執行 Build → Rebuild All（耗時約 30~60 分鐘）

產出位置：

• .lib 檔：D:\ACE_wrappers\ace\
• .dll 檔：D:\ACE_wrappers\bin\

2. 編譯靜態庫

• 打開 ace_static.dsw
• 同樣選擇配置後 Rebuild All
• 產出：ACEs.lib, ACEsd.lib, ACE_RMCasts.lib 等

3. 命名規則速查

註：d = debug，s = static

四、範例程式編譯驗證

• 打開 D:\ACE_wrappers\tests\tests.dsw
• 選單 Build → Batch Build，全選編譯
• 若無錯誤，表示環境已就緒

五、自訂專案配置實戰

以官方教程 ACE Programmer's Guide 中的 server.cpp 為例，常見錯誤與解決方案：

1. 找不到標頭檔

Cannot open include file: 'ace/SOCK_Acceptor.h'

解決：專案 → Settings → C/C++ → Preprocessor → Additional include directories：
D:/ACE_wrappers

2. 執行期庫不匹配

You must link against multi-threaded libraries when using ACE

解決：C/C++ → Code Generation → Use run-time library：
Debug Multithreaded DLL (或 Release Multithreaded DLL)

3. ACE_ERROR/ACE_DEBUG 未宣告

解決：在程式碼加入 #include "ace/Log_Msg.h"

4. main 函數需回傳值

error C4716: 'ace_main_i' : must return a value

解決：在 main 結尾加上 return 0;

5. 連結錯誤：找不到符號

error LNK2001: unresolved external symbol "__declspec(dllimport)..."

解決：Link → Input → Object/Library modules 加入 aced.lib，Additional library path 加入 D:\ACE_wrappers\ace

6. Client 端常見編譯錯誤

7. 執行時找不到 aced.dll

解決：將 D:\ACE_wrappers\bin 加入系統環境變數 PATH，或將 dll 複製到執行檔同目錄。

8. 靜態連結配置

C/C++ → Preprocessor definitions 加入 ACE_AS_STATIC_LIBS，並連結 aces.lib (Release) 或 acesd.lib (Debug)。

六、編譯產出大小對照 (參考)

發布建議：Release 靜態版 (如 servers.exe) 無需附帶 DLL，部署最簡單。

七、簡易測試

# 終端機 1 (Server)
servers 1919

# 終端機 2 (Client)
clients 127.0.0.1 1919

若雙向通訊正常，恭喜你已成功建立 ACE 開發環境！