为什么捐赠
API 浏览器
联系站长
Quasar CLI with Webpack - @quasar/app-webpack
Capacitor 版本

官方支持的 Capacitor 版本是从 v1 到 v6。

升级 Capacitor

如果以前使用的是低版本的 Capacitor,而现在想升级到较新的版本,那么:

  1. 删除 /src-capacitor/ios 和 /src-capacitor/android 文件夹,但要确保您清楚在这些文件夹中所做的任何改动,因为在第 4 步之后将不得不重做这些改动。
  2. 修改 /src-capacitor/package.json 文件中 Capacitor 依赖版本(可以在下面与所需 Capacitor 版本对应的章节中查看具体版本号)。
  3. 删除 yarn.lock/package-lock.json 文件后在 /src-capacitor 目录中运行 yarn/npm install 命令。
  4. 在这一步中,将会安装好 Capacitor。现在可以运行 quasar dev -m capacitor -T [ios|android] 或者 quasar build -m capacitor -T [ios|android] 命令,这将添加与您的 Capacitor 版本对应的升级后的 iOS/Android 平台。

检查 Capacitor 本身的更新日志,看看它有哪些破坏性变更,也是明智之举。

Capacitor v8

环境要求

  • Node v22.21.1+
  • Xcode 16+(用于 iOS)
  • Xcode Command Line Tools
  • Homebrew
  • Cocoapods
  • Android Studio 2024.2.1+
  • Android SDK(API 23+)

假设您已经安装了 Capacitor 模式,那么您的 /src-capacitor/package.json 中的依赖项应该是这样的:

/src-capacitor/package.json

dependencies: {
  "@capacitor/app": "^8.0.0",
  "@capacitor/cli": "^8.0.0",
  "@capacitor/core": "^8.0.0",
  "@capacitor/splash-screen": "^8.0.0"
}

其中,@capacitor/app@capacitor/splash-screen 是可选的,但安装它们可以帮助 Quasar 实现一些 UI 功能。

Capacitor v7

环境要求

  • Xcode 16+(用于 iOS)
  • Xcode Command Line Tools
  • Homebrew
  • Cocoapods
  • Android Studio 2024.2.1+
  • Android SDK(API 23+)

假设您已经安装了 Capacitor 模式,那么您的 /src-capacitor/package.json 中的依赖项应该是这样的:

/src-capacitor/package.json

dependencies: {
  "@capacitor/app": "^7.0.0",
  "@capacitor/cli": "^7.0.0",
  "@capacitor/core": "^7.0.0",
  "@capacitor/splash-screen": "^7.0.0"
}

其中,@capacitor/app@capacitor/splash-screen 是可选的,但安装它们可以帮助 Quasar 实现一些 UI 功能。

Capacitor v6

环境要求

  • Xcode 15+(用于 iOS)
  • Android Studio Jellyfish 2023.3.1.18 或更高版本(用于 Android)

假设您已经安装了 Capacitor 模式,那么您的 /src-capacitor/package.json 中的依赖项应该是这样的:

/src-capacitor/package.json

dependencies: {
  "@capacitor/app": "^6.0.0",
  "@capacitor/cli": "^6.0.0",
  "@capacitor/core": "^6.0.0",
  "@capacitor/splash-screen": "^6.0.0"
}

其中,@capacitor/app@capacitor/splash-screen 是可选的,但安装它们可以帮助 Quasar 实现一些 UI 功能。

Capacitor v5

环境要求

  • Xcode 14.1+(用于 iOS)
  • Android Studio Flamingo 2022.2.1 或更高版本(用于 Android)

假设您已经安装了 Capacitor 模式,那么您的 /src-capacitor/package.json 中的依赖项应该是这样的:

/src-capacitor/package.json

dependencies: {
  "@capacitor/app": "^5.0.0",
  "@capacitor/cli": "^5.0.0",
  "@capacitor/core": "^5.0.0",
  "@capacitor/splash-screen": "^5.0.0"
}

其中,@capacitor/app@capacitor/splash-screen 是可选的,但安装它们可以帮助 Quasar 实现一些 UI 功能。

Capacitor v4

假设您已经安装了 Capacitor 模式,那么您的 /src-capacitor/package.json 中的依赖项应该是这样的:

/src-capacitor/package.json

dependencies: {
  "@capacitor/app": "^4.0.0",
  "@capacitor/cli": "^4.0.0",
  "@capacitor/core": "^4.0.0",
  "@capacitor/splash-screen": "^4.0.0"
}

其中,@capacitor/app@capacitor/splash-screen 是可选的,但安装它们可以帮助 Quasar 实现一些 UI 功能。

Capacitor v3

已知问题

目前还不支持 HTTPS 开发服务器(通过 quasar.config 文件 > devServer > https: true 开启)。如果正在使用依赖于它的 Capacitor 插件,最好升级到更新的受支持的 Capacitor 版本。

假设已经安装了 Capacitor 模式,在 /src-capacitor/package.json 文件中的依赖项应该是这样的:

/src-capacitor/package.json

dependencies: {
  "@capacitor/app": "^1.0.0",
  "@capacitor/cli": "^3.0.0",
  "@capacitor/core": "^3.0.0",
  "@capacitor/splash-screen": "^1.0.0"
}

@capacitor/app@capacitor/splash-screen 是可选的,但如果安装了它们,就可以帮助 Quasar 实现一些 UI 功能。

更多信息请参阅 切换到 Android 插件自动加载

Capacitor v2

假设已经安装了 Capacitor 模式,在 /src-capacitor/package.json 文件中的依赖项应该是这样的:

/src-capacitor/package.json

dependencies: {
  "@capacitor/cli": "^2.0.0",
  "@capacitor/core": "^2.0.0"
}

Capacitor v1

假设已经安装了 Capacitor 模式,在 /src-capacitor/package.json 文件中的依赖项应该是这样的:

/src-capacitor/package.json

dependencies: {
  "@capacitor/cli": "^1.0.0",
  "@capacitor/core": "^1.0.0"
}