build: Adopt CMake presets for CI and add clangd/VSCode integration (#15595)

* feat: clangd support

* feat: 完善CMakePresets

* docs: 更新cmake命令

* fix: smoke test run

* docs: 更新vscode开发文档

* feat: 添加执行MaaWpf到cmake中

* feat: 支持全部的presets

* chore: 重新安排顺序

* chore: add some comment

* chore: add more comments

* feat: 简化res-update-game

* chore: 移除多余build

* chore: 统一x64和arm64

* chore: 修正重复忽略.vscode

* feat: vscode cmaketool乱码

* docs: 添加提示
This commit is contained in:
soundofautumn
2026-02-06 23:05:41 +08:00
committed by GitHub
parent e167e41696
commit 84f1bf490c
15 changed files with 566 additions and 119 deletions

View File

@@ -70,8 +70,7 @@ icon: iconoir:developer
6. cmake プロジェクト設定を実行
```cmd
mkdir -p build
cmake -G "Visual Studio 18 2026" -B build -DBUILD_WPF_GUI=ON -DBUILD_DEBUG_DEMO=ON
cmake --preset windows-x64
```
7. `build/MAA.slnx` をダブルクリックで開き、Visual Studio にプロジェクトを自動ロード
@@ -133,6 +132,40 @@ icon: iconoir:developer
Visual Studio 起動後、Git 操作は「Git 変更」画面からコマンドライン不要で可能
:::
## VSCodeでの開発オプション
::: warning
**Visual Studio での開発を推奨します。** MAA プロジェクトは主に Visual Studio をベースに構築されており、上記の完全な環境セットアップですべての開発ニーズをカバーし、すぐに使える最高の体験を提供します。VSCode ワークフローは、VSCode + CMake + clangd に精通した開発者向けの代替手段としてのみ提供されており、設定のハードルが比較的高くなります。
:::
VSCodeを好む場合、CMake、clangdなどの拡張機能でコード補完、ナビゲーション、デバッグが可能です。前述の手順16クローン、依存関係、CMake設定を完了した後、以下の手順で設定できます。
### 推奨拡張機能
VSCode Marketplace からインストール:
| 拡張機能 | 用途 |
| --------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| [CMake Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools) | CMake の設定、ビルド、デバッグ統合 |
| [clangd](https://marketplace.visualstudio.com/items?itemName=llvm-vs-code-extensions.vscode-clangd) | C++ インテリセンス、コードナビゲーション、診断LSPベース |
| [C/C++](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools) | C++ プログラムのデバッグCMake Tools または launch.json と連携) |
::: tip
clangd を使用する場合、C/C++ 拡張機能の IntelliSense を無効化(`C_Cpp.intelliSenseEngine` を `disabled` に設定)することを推奨します。競合を避けるためです。
:::
### 設定手順
1. VSCode でプロジェクトルートを開く
2. **CMake Tools**:ステータスバーで Configure Preset`windows-x64`、`linux-x64`を選択し、Build Preset でビルドを実行
3. **clangd**Windows で MSVC を使用する場合、`compile_commands.json` がなくても clangd で開発可能。Linux/macOS ではプリセットで `CMAKE_EXPORT_COMPILE_COMMANDS` が有効となり、clangd は `build/compile_commands.json` を自動使用
4. **デバッグ**:プロジェクトには `.vscode/launch.json` が含まれており、MaaWpfGui や Debug Demo の起動が可能
### ビルドとデバッグのショートカット
- **ビルド**`Ctrl+Shift+B` または CMake Tools ステータスバー
- **デバッグ**F5 または Run and Debug パネルで設定を選択
## MAAのファイルフォーマット要件
MAAは、リポジトリ内のコードとリソースファイルが美しく統一されるよう、一連のフォーマットツールを使用してメンテナンスと読み取りを容易にしています。