官方支援的 Capacitor 版本為 v1 至 v6。
升級 Capacitor
如果您先前使用較舊版本的 Capacitor,並且想要升級到較新版本,請執行以下步驟
- 刪除 /src-capacitor/ios 和 /src-capacitor/android 資料夾,但請務必注意您在這些資料夾中所做的任何變更,因為您必須在步驟 4 之後重新執行這些變更。
- 變更 /src-capacitor/package.json 以反映正確的 Capacitor 相依性版本(您可以在下一個適當的章節中找到與您想要的 Capacitor 版本相關的資訊)。
- 刪除 yarn.lock/package-lock.json,然後在 /src-capacitor 中執行
yarn
/npm install
。 - 此時,您將安裝 Capacitor。現在您可以執行
quasar dev -m capacitor -T [ios|android]
或quasar build -m capacitor -T [ios|android]
,它將新增與您的 Capacitor 版本相對應的升級版 iOS/Android 平台。
建議您也檢查 Capacitor 本身的變更日誌,以查看它有哪些重大變更。
Capacitor v6@quasar/app-webpack v3.9+
需求條件
- Xcode 15+ (適用於 iOS)
- Android Studio Jellyfish 2023.3.1.18 或更新版本 (適用於 Android)
假設您已安裝 Capacitor 模式,以下是您的 /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@quasar/app-webpack v3.9+
需求條件
- Xcode 14.1+ (適用於 iOS)
- Android Studio Flamingo 2022.2.1 或更新版本 (適用於 Android)
假設您已安裝 Capacitor 模式,以下是您的 /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@quasar/app-webpack v3.9+
假設您已安裝 Capacitor 模式,以下是您的 /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 > server > type: “https”)。如果您正在使用依賴它的 Capacitor 插件,最好升級到較新的支援 Capacitor 版本。
假設您已安裝 Capacitor 模式,以下是您的 /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 功能。
Capacitor v2
假設您已安裝 Capacitor 模式,以下是您的 /src-capacitor/package.json 中相依性應有的樣子
dependencies: {
"@capacitor/cli": "^2.0.0",
"@capacitor/core": "^2.0.0"
}
Capacitor v1
假設您已安裝 Capacitor 模式,以下是您的 /src-capacitor/package.json 中相依性應有的樣子
dependencies: {
"@capacitor/cli": "^1.0.0",
"@capacitor/core": "^1.0.0"
}