Skip to content

Latest commit

 

History

History
78 lines (52 loc) · 3.34 KB

2.2-開發相關.md

File metadata and controls

78 lines (52 loc) · 3.34 KB

開發相關

Github Pull Request 流程簡述

  1. 如果很久以前 fork 過，先在自己儲存庫的 Settings 裡，翻到最下面，刪除

  2. 打開 MAA 主儲存庫，點擊 Fork，繼續點擊 Create fork

  3. clone 儲存庫（你自己賬戶下） dev 分支到本地

    git clone <你的儲存庫 git 連結> -b dev

  4. 配置編程環境

    1. 下載並安裝 Visual Studio 2022 community, 安裝的時候需要選中 基於c++的桌面開發 和 .NET桌面開發

  5. 雙擊打開 MAA.sln 檔案。 Visual Studio 會自動加載整個項目。

  6. 測試一下是否成功搭建編程環境，選擇參數 Release, x64, 右鍵 MaaWpfGui 設為啟動項目；點擊啟動，選擇繼續調試。如果成功打開了 GUI，就說明成功搭建了環境。如果求穩，可以繼續連接模擬器跑一下 MAA

  7. 到這裡，你就可以愉快地 瞎 ㄐㄅ 改 發電了

  8. 開發過程中，每一定數量，記得提交一個 commit, 別忘了寫上 message
    假如你不熟悉 git 的使用，你可能想要新增一个分支，而不是直接提交在 dev 上

    git branch your_own_branch
git checkout your_own_branch

    這樣你的提交就能在新的分支上生長，不會被 dev 更新打擾

  9. 完成開發後，推送本地分支到遠端（自己）

    git push origin dev

  10. 打開 MAA 主儲存庫。提交一個 pull request，等待管理員通過。別忘了你是在 dev 分支上修改，別提交到 master 分支去了

  11. 當 MAA 原儲存庫出現更改（別人做的），你需要把這些更改同步到你的分支

    1. 關聯 MAA 原儲存庫

      git remote add upstream https://github.com/MaaAssistantArknights/MaaAssistantArknights.git

    2. 從 MAA 原儲存庫拉取更新

      git fetch upstream

    3. 變基（推薦）合併修改

      git rebase upstream/dev # 變基

      或

      git merge # 合并

    4. 重複上述 7, 8, 9, 10 中的操作

注：在打開 VS2022 之後，和 git 有關的操作可以不用命令列工具，直接使用 vs 自帶的“Git 更改”即可

在 Visual Studio 中啟用 clang-format

  1. 下載 clang-format.zip 或者編譯 zzyyyl/llvm-project，得到一個 clang-format.exe
  2. 在 工具-設定 中檢索 clang-format
  3. 點擊 啟用 ClangFormat 支援，然後選擇下面的 使用自定義 clang-format.exe 檔案，選擇第一步得到的 clang-format.exe

Visual Studio 設置 clang-format

然後你的 Visual Studio 就能愉快地使用支援 c++20 語法的 clang-format 啦！

你也可以使用 tools\ClangFormatter\clang-formatter.py 來直接執行你的 clang-format 來進行格式化，只需要在項目根目錄下執行：

  • python tools\ClangFormatter\clang-formatter.py --clang-format=PATH\TO\YOUR\clang-format.exe --input=src\MaaCore