API 浏览器
Quasar CLI with Vite - @quasar/app-vite
Capacitor 版本

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

¥The officially supported versions of Capacitor are v1 through v6.

升级 Capacitor(Upgrading Capacitor)

¥Upgrading Capacitor

如果你之前使用的是较低版本的 Capacitor,并且想要升级到较新版本,则:

¥If you previously used a lower version of Capacitor and you want to upgrade to a newer version, then:

  1. 删除 /src-capacitor/ios 和 /src-capacitor/android 文件夹,但请确保你了解在这些文件夹中所做的任何更改,因为你必须在步骤 4 之后重新执行这些更改。

    ¥Delete the /src-capacitor/ios and /src-capacitor/android folders, but make sure that you are aware of any changes that you made in those folders as you will have to redo them after step 4.

  2. 修改 /src-capacitor/package.json 文件以反映 Capacitor 依赖的正确版本(你可以在下一个与你所需的 Capacitor 版本相关的相应部分中阅读它们)。

    ¥Change /src-capacitor/package.json to reflect the correct versions of Capacitor dependencies (you can read them in the next appropriate section related to your desired Capacitor version).

  3. 删除 yarn.lock/package-lock.json,然后在 /src-capacitor 中运行 yarn / npm install

    ¥Delete yarn.lock/package-lock.json then run yarn / npm install in /src-capacitor.

  4. 此时,Capacitor 已安装完毕。现在你可以运行 quasar dev -m capacitor -T [ios|android]quasar build -m capacitor -T [ios|android],它将添加与你的 Capacitor 版本对应的升级版 iOS/Android 平台。

    ¥At this point, you will have Capacitor installed. Now you can run quasar dev -m capacitor -T [ios|android] or quasar build -m capacitor -T [ios|android] and it will add the upgraded iOS/Android platform that corresponds to your Capacitor version.

检查 Capacitor 本身的更新日志,了解它有哪些重大变更也是明智之举。

¥It would also be wise to check the changelog of Capacitor itself to see what breaking changes it has.

Capacitor v7(Capacitor v7)

要求

  • Xcode 16+(适用于 iOS)

    ¥Xcode 16+ (for iOS)

  • Xcode 命令行工具

    ¥Xcode Command Line Tools

  • Homebrew

  • Cocoapods

  • Android Studio 2024.2.1+

  • Android SDK(API 23+)

假设你已经安装了 Capacitor 模式,/src-capacitor/package.json 中的依赖应如下所示:

¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json should look like:

/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 功能。

¥The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.

Capacitor v6(Capacitor v6)

要求

  • Xcode 15+(适用于 iOS)

    ¥Xcode 15+ (for iOS)

  • Android Studio Jellyfish 2023.3.1.18 或更新版本(适用于 Android)

    ¥Android Studio Jellyfish 2023.3.1.18 or newer (for Android)

假设你已经安装了 Capacitor 模式,/src-capacitor/package.json 中的依赖应如下所示:

¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json should look like:

/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 功能。

¥The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.

Capacitor v5(Capacitor v5)

要求

  • Xcode 14.1+(适用于 iOS)

    ¥Xcode 14.1+ (for iOS)

  • Android Studio Flamingo 2022.2.1 或更新版本(适用于 Android)

    ¥Android Studio Flamingo 2022.2.1 or newer (for Android)

假设你已经安装了 Capacitor 模式,/src-capacitor/package.json 中的依赖应如下所示:

¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json should look like:

/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 功能。

¥The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.

Capacitor v4(Capacitor v4)

假设你已经安装了 Capacitor 模式,/src-capacitor/package.json 中的依赖应如下所示:

¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json should look like:

/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 功能。

¥The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.

Capacitor v3(Capacitor v3)

已知问题

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

¥HTTPS devserver (through quasar.config file > devServer > https: true) is not supported. If you are using Capacitor plugins that depend on it, it’s better to upgrade to the newer supported Capacitor versions.

假设你已经安装了 Capacitor 模式,/src-capacitor/package.json 中的依赖应如下所示:

¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json should look like:

/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 功能。

¥The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.

更多关于 切换到自动 Android 插件加载 的信息。

¥More info for Switch to automatic Android plugin loading.

Capacitor v2(Capacitor v2)

假设你已经安装了 Capacitor 模式,/src-capacitor/package.json 中的依赖应如下所示:

¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json should look like:

/src-capacitor/package.json

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

Capacitor v1(Capacitor v1)

假设你已经安装了 Capacitor 模式,/src-capacitor/package.json 中的依赖应如下所示:

¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json should look like:

/src-capacitor/package.json

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