Обновление приложений Capacitor
Guides the agent through upgrading a Capacitor app project to a newer major version. Supports upgrades from Capacitor 4 through 8, including multi-version jumps. Performs all upgrade steps manually â does not use the interactive `npx cap migrate` command. Do not use for plugin library upgrade or non-Capacitor mobile frameworks.
Что делает навык
Навигирует агента через пошаговое обновление проекта Capacitor до более новой мажорной версии (от 4 до 8), применяя инструкции из справочных файлов для каждого перехода. Обновление выполняется вручную без использования интерактивной команды npx cap migrate, с обязательной синхронизацией и проверкой сборки на каждом этапе. Не предназначено для обновления библиотек плагинов или немобильных фреймворков.
Когда применять
- Обновление проекта Capacitor с версии 4 на 5, 6, 7 или 8.
- Многоступенчатое обновление (например, с 5 на 8), требующее последовательного прохождения всех промежуточных версий.
- Исправление ошибок сборки Android или iOS после обновления мажорной версии.
- Устранение предупреждений о синтаксисе свойств Gradle при обновлении до версии 8 и выше.
Как работает
- Определите текущую мажорную версию, прочитав @capacitor/core из package.json, и уточните целевую версию у пользователя.
- Для каждого перехода между мажорными версиями последовательно читайте соответствующий справочный файл (например, references/upgrade-v4-to-v5.md) и применяйте изменения.
- После применения каждого этапа выполняйте npx cap sync, сборку и проверку на обеих платформах (Android и iOS).
- После завершения всех этапов выполните финальную проверку: npx cap sync, npx cap run android и npx cap run ios.
- При ошибках сборки Android используйте AGP Upgrade Assistant в Android Studio, а для iOS проверьте соответствие deployment target требованиям.
Примеры запросов агенту
Что понадобится
- Node.js (версия зависит от целевой версии: 16+ для v4, 18+ для v5, 20+ для v6, 22+ для v8)
- Xcode (версия зависит от целевой версии: 14.1+ для v4, 26.0+ для v8)
- Android Studio (версия зависит от целевой версии: Flamingo 2022.2.1+ для v4, Otter 2025.2.1+ для v8)
Описание составлено по SKILL.md навыка, сверено 05.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.