capacitor-app-upgrade-v6-to-v7

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Capacitor App Upgrade v6 to v7

Capacitor应用从v6升级到v7

Upgrade a Capacitor app from version 6 to version 7.

将Capacitor应用从版本6升级到版本7。

When to Use This Skill

何时使用此技能

User says the app is on Capacitor 6 and must move to v7
User wants the exact v6 to v7 migration path
User needs v7-specific native and package updates

用户表示应用当前使用Capacitor 6，必须迁移到v7版本
用户需要v6到v7的准确迁移路径
用户需要v7专属的原生端和包更新方案

Live Project Snapshot

实时项目快照

Current Capacitor packages from

package.json

: !

node -e "const fs=require('fs');if(!fs.existsSync('package.json'))process.exit(0);const pkg=JSON.parse(fs.readFileSync('package.json','utf8'));const out=[];for(const section of ['dependencies','devDependencies']){for(const [name,version] of Object.entries(pkg[section]||{})){if(name.startsWith('@capacitor/'))out.push(section+'.'+name+'='+version)}}console.log(out.sort().join('\n'))"

从

package.json

中获取当前Capacitor相关包信息： !

node -e "const fs=require('fs');if(!fs.existsSync('package.json'))process.exit(0);const pkg=JSON.parse(fs.readFileSync('package.json','utf8'));const out=[];for(const section of ['dependencies','devDependencies']){for(const [name,version] of Object.entries(pkg[section]||{})){if(name.startsWith('@capacitor/'))out.push(section+'.'+name+'='+version)}}console.log(out.sort().join('\n'))"

Procedure

操作步骤

Start from the injected package snapshot and confirm the current
```
@capacitor/core
```
version.
Update all
```
@capacitor/*
```
packages to the v7-compatible range.
Review the v6 to v7 migration notes before editing native files.
Run
```
npm install
```
.
Sync with
```
npx cap sync
```
.
Verify the iOS and Android builds.

基于注入的包快照，确认当前
```
@capacitor/core
```
的版本。
将所有
```
@capacitor/*
```
包更新到与v7兼容的版本范围。
在编辑原生文件前，先查阅v6到v7的迁移说明。
运行
```
npm install
```
。
执行
```
npx cap sync
```
进行同步。
验证iOS和Android构建是否正常。

Error Handling

错误处理

If the automated migration misses a package, update it manually before syncing again.
If iOS fails, check the deployment target and Xcode compatibility for Capacitor 7.
If Android fails, check the Gradle and Java requirements for Capacitor 7.

如果自动迁移遗漏了某个包，手动更新后再重新同步。
如果iOS构建失败，检查Capacitor 7对应的部署目标版本和Xcode兼容性。
如果Android构建失败，检查Capacitor 7对应的Gradle和Java版本要求。