# CMake 安装步骤（详细版）

## 当前状态

- ❌ CMake 未安装
- ❌ NCS 目录中也没有 CMake

## 安装 CMake

### 方法 1：官方安装程序（推荐）

#### 步骤 1：下载

1. 访问：https://cmake.org/download/
2. 找到 "Latest Release" 部分
3. 下载：**Windows x64 Installer**
   - 文件名类似：`cmake-3.xx.x-windows-x86_64.msi`

#### 步骤 2：安装

1. 运行下载的 `.msi` 文件
2. 安装向导中：
   - 选择 "Add CMake to system PATH for all users" 或 "Add CMake to system PATH for current user"
   - **重要**：必须勾选 PATH 选项！
3. 完成安装

#### 步骤 3：验证

**重启 PowerShell** 后，运行：

```powershell
cmake --version
```

应该显示：
```
cmake version 3.xx.x
CMake suite maintained and supported by Kitware
```

### 方法 2：使用包管理器（如果已安装）

#### Chocolatey

```powershell
choco install cmake
```

#### Scoop

```powershell
scoop install cmake
```

#### Winget（Windows 10/11）

```powershell
winget install Kitware.CMake
```

### 方法 3：便携版（不推荐）

如果不想安装到系统：
1. 下载 ZIP 版本
2. 解压到某个目录（例如：`C:\cmake`）
3. 手动添加到 PATH

## 安装后验证

### 1. 重启 PowerShell

**重要**：安装后必须重启 PowerShell！

### 2. 检查 CMake

```powershell
cmake --version
```

### 3. 检查 PATH

```powershell
$env:Path -split ';' | Select-String "cmake"
```

应该看到 CMake 的路径。

## 如果安装后仍然无法识别

### 问题 1：PATH 未更新

**解决方案**：
1. 手动添加到 PATH：
   - CMake 通常安装在：`C:\Program Files\CMake\bin`
   - 或：`C:\Program Files (x86)\CMake\bin`
2. 添加到环境变量 PATH
3. 重启 PowerShell

### 问题 2：需要重启计算机

某些情况下需要重启计算机才能生效。

## 快速检查脚本

运行以下脚本检查 CMake：

```powershell
Write-Host "=== 检查 CMake ===" -ForegroundColor Cyan

# 检查命令
if (Get-Command cmake -ErrorAction SilentlyContinue) {
    Write-Host "✓ CMake 已安装" -ForegroundColor Green
    cmake --version
} else {
    Write-Host "✗ CMake 未找到" -ForegroundColor Red
    Write-Host ""
    Write-Host "可能的位置：" -ForegroundColor Yellow
    $possiblePaths = @(
        "C:\Program Files\CMake\bin\cmake.exe",
        "C:\Program Files (x86)\CMake\bin\cmake.exe",
        "$env:ProgramFiles\CMake\bin\cmake.exe"
    )
    foreach ($path in $possiblePaths) {
        if (Test-Path $path) {
            Write-Host "  ✓ 找到：$path" -ForegroundColor Green
        }
    }
}
```

## 安装完成后

1. ✅ 安装 CMake
2. ✅ 重启 PowerShell
3. ✅ 验证：`cmake --version`
4. ⏭️ 重新编译：`west build -b nrf52832dk_nrf52832`

## 下载链接

**直接下载链接**（最新稳定版）：
- https://github.com/Kitware/CMake/releases/latest
- 下载：`cmake-3.xx.x-windows-x86_64.msi`

## 最小版本要求

- **CMake 3.20.0 或更高版本**
- NCS 通常需要 CMake 3.20+

## 总结

**必须安装 CMake 才能编译 NCS 项目！**

安装步骤：
1. 下载 CMake 安装程序
2. 安装时勾选 "Add to PATH"
3. 重启 PowerShell
4. 验证：`cmake --version`
5. 重新编译项目

