capacitor-app-upgrade-v7-to-v8

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Capacitor App Upgrade v7 to v8

Capacitor 应用 v7 升级至 v8 指南

Upgrade a Capacitor app from version 7 to version 8.

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

When to Use This Skill

何时使用本技能

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

用户表明应用当前使用Capacitor 7，必须升级到v8
用户需要v7到v8的准确迁移路径
用户需要v8专属的原生层和包更新方案

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 v8-compatible range.
Review the v7 to v8 migration notes before editing native files.
Run
```
npm install
```
.
Sync with
```
npx cap sync
```
.
Verify the iOS and Android builds.

基于注入的包快照，确认当前
```
@capacitor/core
```
的版本。
将所有
```
@capacitor/*
```
包更新到与v8兼容的版本范围。
编辑原生文件前先查阅v7到v8的迁移说明。
运行
```
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 8.
If Android fails, check the Gradle and Java requirements for Capacitor 8.

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