# Как попробовать инструмент

## Сначала — важное различие

**Публичный preview CLI и текущий каталог 022 — не один уровень готовности.** Подтверждённый маршрут отдельного правила в интеграционном тесте ещё не означает, что весь каталог доступен одной CLI-командой. Общая интеграция портфеля остаётся отдельной задачей.

## Сборка preview

Документированный профиль preview: macOS 26.x, arm64, Xcode 26.6 и Apple Swift 6.3.3 (`swiftlang-6.3.3.1.3`). Точная матрица находится в `docs/toolchains/phase-zero-profile.md`; поддержка другого окружения не предполагается автоматически.

Из корня репозитория:

```bash
swift build -c release --disable-automatic-resolution --product swift-analyzer
.build/release/swift-analyzer --help
```

Если зависимости ещё не получены, сначала следуй `docs/preview/installation.md` и сохрани зафиксированный `Package.resolved`. Пока другой агент собирает или тестирует этот checkout, дождись завершения его SwiftPM-процесса.

## Для анализа нужен подготовленный manifest

Preview потребляет уже подготовленные данные сборки. Передать только путь к произвольному проекту недостаточно. Для точной процедуры подготовки смотри `openspec/specs/001-phase-zero-reachability/quickstart.md`.

Когда manifest уже готов:

```bash
.build/release/swift-analyzer doctor --manifest /path/to/manifest.json --format human
.build/release/swift-analyzer stats --manifest /path/to/manifest.json --format human
.build/release/swift-analyzer scan --manifest /path/to/manifest.json --format json
```

`/path/to/manifest.json` — пример пути, а не файл из репозитория. Эти команды иллюстрируют preview; они не включают автоматически все правила 022.

| Команда | Зачем нужна |
|---|---|
| `doctor` | Проверить входные данные и готовность возможностей |
| `stats` | Посмотреть наблюдаемую статистику |
| `scan` | Получить результаты запрошенного анализа |
| `why` | Разобраться в объяснении конкретного результата |

Для автоматизации используй JSON и сохраняй код возврата. Например, exit 3 означает неполный результат, а не успешную проверку без проблем. Полная грамматика — в `docs/preview/cli.md`.

## Запуск этого сайта

Сайт независим от сборки Swift-анализатора. Требуется Node.js 20 или новее.

```bash
cd website
npm ci
npm start
```

Локальный адрес выводит команда запуска. Статическая сборка: `npm run build`;
просмотр собранного сайта: `npm run serve`. Эти development-команды не являются
публичными URL продукта.

---
Language: ru
Canonical: https://docs.swift-analyzer.com/getting-started/
Source revision: 4558458d