# capacitor-app-upgrade-v4-to-v5

Скилл ведёт приложение на Capacitor 4 к версии 5: запускает npx cap migrate, добивает пропущенное вручную и проверяет сборку.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 639 установок · ★ 73
- Автор: Cap-go
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Cap-go/capgo-skills/tree/HEAD/skills/capacitor-app-upgrade-v4-to-v5/SKILL.md
- Обновлён: 2026-10-17
- HTML: https://affpapa.org/nevibecode/skills/capacitor-app-upgrade-v4-to-v5

## Что делает

Скилл включается, когда в `package.json` стоит `@capacitor/core` версии 4.x, а нужна 5.x. Он прогоняет автоматическую миграцию через `@capacitor/cli@latest-5` и `npx cap migrate`: обновляет пакеты `@capacitor/*`, `variables.gradle`, AGP, Gradle wrapper, переносит `package` в `namespace` и делает `cap sync`. Всё, что CLI не осилил, печатается в выводе — эти шаги скилл доводит по чек-листу.

Перед правками идёт предполётная проверка инструментов: Node.js 16+, Xcode 14.1+, Android Studio Flamingo с JDK 17, AGP 8.0.0, Gradle 8.0.2, compileSdk и targetSdk 33. Если Gradle JDK остался на 11, сборка упадёт с `Android Gradle plugin requires Java 17 to run` — это повод переключить JDK в Android Studio до начала миграции, а не после. Отдельно скилл советует зафиксировать `androidScheme: "http"` в `capacitor.config.*`: в Capacitor 6 значение по умолчанию станет `https`, сменится origin WebView, и localStorage с IndexedDB и cookies пропадут.

Внутри два справочника, которые подгружаются по ситуации: `references/android.md` для ручной правки `build.gradle`, манифеста и Kotlin, `references/plugins.md` для ломающих изменений официальных плагинов — `Device.getId()` теперь отдаёт `{ identifier }` вместо `uuid`, а на Android 13 Push и Local Notifications требуют `checkPermissions()` и `requestPermissions()` в рантайме. Скилл не для перехода между другими мажорными версиями, не для обновления библиотек-плагинов и не для приложений вне Capacitor.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capacitor-app-upgrade-v4-to-v5 -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/capacitor-app-upgrade-v4-to-v5/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/capacitor-app-upgrade-v4-to-v5/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capacitor-app-upgrade-v4-to-v5 -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/capacitor-app-upgrade-v4-to-v5/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capacitor-app-upgrade-v4-to-v5 -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/capacitor-app-upgrade-v4-to-v5/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Cap-go/capgo-skills capacitor-app-upgrade-v4-to-v5
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/capacitor-app-upgrade-v4-to-v5/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capacitor-app-upgrade-v4-to-v5 -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Cap-go/capgo-skills --path skills/capacitor-app-upgrade-v4-to-v5
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/capacitor-app-upgrade-v4-to-v5/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capacitor-app-upgrade-v4-to-v5 -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Cap-go/capgo-skills/tree/HEAD/skills/capacitor-app-upgrade-v4-to-v5/SKILL.md

## Когда брать
- перевести приложение с Capacitor 4 на Capacitor 5 без пропущенных шагов
- починить сборку Android после ошибки `Namespace not specified`
- переключить Gradle JDK на 17 и убрать конфликт с Java 11
- перенести `package` из AndroidManifest.xml в `namespace` в build.gradle
- проверить, что localStorage и cookies пережили смену `androidScheme`

## Примеры запросов агенту
- Проверь версии @capacitor/* в package.json и проведи миграцию с 4 на 5
- Сборка Android падает с `Android Gradle plugin requires Java 17 to run` — что делать?
- Прогони чек-лист для iOS и Android после `npx cap migrate`

## Похожие
- [capacitor-plugin-upgrades](https://affpapa.org/nevibecode/skills/capacitor-plugin-upgrades.md) — скилл · 811 установок
- [capacitor-app-upgrades](https://affpapa.org/nevibecode/skills/capacitor-app-upgrades.md) — скилл · 902 установки
- [agp-9-upgrade](https://affpapa.org/nevibecode/skills/agp-9-upgrade.md) — скилл · 1200 установок
- [play-billing-library-version-upgrade](https://affpapa.org/nevibecode/skills/play-billing-library-version-upgrade.md) — скилл · 1900 установок
- [upgrade-react-native](https://affpapa.org/nevibecode/skills/upgrade-react-native.md) — скилл · 1300 установок
- [kotlin-multiplatform](https://affpapa.org/nevibecode/skills/kotlin-multiplatform.md) — скилл · 1600 установок

Из того же набора: [cap-go/capgo-skills](https://affpapa.org/nevibecode/by/cap-go/capgo-skills.md) — 29 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md