Building_PCMan

PCMan程式專案建置和執行：逐步解說

前置作業：工具安裝與環境設定

• 建立一個本機資料夾可以放你的原始碼，這邊名字舉 D:\source\repos\ 為例，請自行代換成你喜歡的資料夾路徑

  • 請確保磁碟有預留足夠剩餘空間，至少留 30~50 GiB 空間，100 GiB 以上更保險

• 安裝 Visual Studio 2017/2019 (Community 即可)

詳細步驟

1. 請至官方網站下載： https://visualstudio.microsoft.com
2. 安裝過程詢問到要安裝那些模組時，將C++有關的套件選項都勾起來安裝，依照安裝程式導引安裝完成
3. 安裝 Visual Studio 2019 者可參考 此頁 匯入組態檔，節省套件找尋時間

• 安裝 Git for Windows (https://gitforwindows.org) 以利直接使用 git 指令方便之後操作

• 安裝 vcpkg 原始碼套件管理員，並用它安裝 cpprestsdk[default-features,websockets] 套件

詳細步驟：

1. 打開命令提示字元(cmd)，執行以下指令抓取 vcpkg 原始碼
   • git clone https://github.com/microsoft/vcpkg.git C:\Tools\vcpkg
2. 執行 cd /d C:\Tools\vcpkg 切換到該目錄下
3. 執行 bootstrap-vcpkg.bat 執行安裝指令，完成後會出現 vcpkg.exe
4. 同目錄下再執行 vcpkg integrate install，讓 Visual Studio 環境可以直接使用藉由 vcpkg 安裝好的套件
   • 正確會印出訊息 Applied user-wide integration for this vcpkg root.
   • 若在其他磁碟區(如：D:\)操作，印出警告訊息 Warning: integration was not applied，請將 vcpkg 原始碼料夾複製到C:\ 任一子資料夾下，再於該資料夾下執行 vcpkg integrate install ，確定印出正確訊息 Applied user-wide integration for this vcpkg root. [註]
5. 於同目錄下再執行以下指令以安裝相關套件：
   • vcpkg install cpprestsdk[default-features,websockets]:x86-windows

專案抓取與建置

1. 打開命令提示字元，執行以下指令抓取 PCMan 原始碼

   • git clone https://github.com/pcman-bbs/pcman-windows.git D:\source\repos\pcman-windows

2. 建置執行 PCMan 專案

   • 用 Visual Studio 開啟 D:\source\repos\pcman-windows\PCMan.sln，並等待載入結束
   • 在 Combo 專案 > 右鍵 > Build(建置) ，等待建置成功
   • 在 Lite 專案 > 右鍵 > Build(建置) ，等待建置成功
   • 在 Lite 或 Combo 專案 > 右鍵 > Set as StartUp Project(設定為起始專案) > 按下 F5 ， 即可執行出現 PCMan 的程式畫面

附註

[註] : https://github.com/Microsoft/vcpkg/issues/5956 提到 I have reinstalled vcpkg directly to the c-drive and now it is working, even if I don't know why. Thank you for the support.

本頁面維護者

• @name2name2
• @holishing