為何捐款
API 瀏覽器
升級指南
NEW!
quasar.config 檔案
使用 Vite 轉換專案至 CLI
瀏覽器相容性
支援 TypeScript
目錄結構
命令列表
CSS 預處理器
路由
懶加載 - 代碼分割
處理資源
啟動檔案
預取功能
API 代理
處理 Vite
處理 process.env
使用 Pinia 進行狀態管理
使用 Vuex 進行狀態管理
Linter
測試與稽核
開發行動應用程式
Ajax 請求
公開開發伺服器
Quasar CLI with Vite - @quasar/app-vite
行動應用程式建置命令

在我們深入探討之前,請確保您已安裝 Cordova CLI。

$ npm install -g cordova

開發中

$ quasar dev -m [ios|android]

# ..or the explicit form:
$ quasar dev -m cordova -T [ios|android]

# ..or the longer form:
$ quasar dev --mode cordova --target [ios|android]

# using a specific emulator (--emulator, -e)
$ quasar dev -m ios -e iPhone-7
# or
$ quasar dev -m ios -e iPhone-X,com.apple.CoreSimulator.SimRuntime.iOS-12-2

# passing extra parameters and/or options to
# underlying "cordova" executable:
$ quasar dev -m ios -- some params --and options --here
# when on Windows and using Powershell:
$ quasar dev -m ios '--' some params --and options --here

然而,如果您希望開啟 IDE (Android Studio / Xcode),並從那裡手動選擇模擬器 (或多個同時選擇!),以便在其上/它們上執行開發應用程式 (或在真實行動/平板裝置上執行開發應用程式)

$ quasar dev -m [ios|android] --ide

警告

在 Android Studio 中,您會看到一則訊息,建議您升級 Gradle 版本。請勿升級 GRADLE,因為這會破壞 Cordova 專案。任何其他要求的升級也一樣。

Gradle upgrade

如果您遇到任何 IDE 錯誤,請點擊 File > Invalidate caches and restart。

Gradle upgrade

為了讓您能夠在裝置模擬器上或直接在手機上 (包含 Hot Module Reload) 進行開發,Quasar CLI 遵循以下步驟

  1. 偵測您機器的外部 IP 位址。如果偵測到多個此類 IP,則會要求您選擇一個。如果您將使用手機進行開發,請選擇可從手機/平板電腦 ping 到的機器 IP 位址。
  2. 它在您的機器上啟動開發伺服器。
  3. 它暫時更改 `/src-cordova/config.xml` 中的 `` 標籤,以指向先前偵測到的 IP。這允許應用程式連接到開發伺服器。
  4. 它延遲到 Cordova CLI 以建置具有暫時更改的 config.xml 的原生應用程式。
  5. Cordova CLI 檢查是否有手機/平板電腦連接到您的開發機器。如果有的話,它會在上面安裝開發應用程式。如果沒有找到,則它會啟動模擬器並執行開發應用程式。
  6. 最後,它還原對 `/src-cordova/config.xml` 所做的暫時變更。

警告

如果在手機/平板電腦上開發,非常重要的是,您的建置機器的外部 IP 位址可從手機/平板電腦存取,否則您將只會得到一個空白畫面的開發應用程式。另請檢查您機器的防火牆,以允許連線到選擇的開發埠。

啟用 iOS 現代建置

預設情況下,由於 Cordova 問題,iOS 的 Xcode 現代建置已停用。但是,如果您知道自己在做什麼並且想要啟用它,請從 `/quasar.config` 檔案中執行

cordova: {
  noIosLegacyBuildFlag: true
}

如果您想在 “build.json” 中指定建置類型,以上也適用。

生產環境建置

$ quasar build -m [android|ios]

# ..or the explicit form:
$ quasar build -m cordova -T [ios|android]

# ..or the longer form:
$ quasar build --mode cordova --target [ios|android]

# this skips .app or .apk creation and just fills in /src-cordova/www
$ quasar build -m [ios|android] --skip-pkg

# passing extra parameters and/or options to
# underlying "cordova" executable:
$ quasar build -m ios -- some params --and options --here
  • 這些命令會解析並建置您的 `/src` 資料夾,然後覆寫 `/src-cordova/www`,然後延遲到 Cordova CLI 以觸發實際的原生應用程式建立。

  • 建置的套件將位於 `/dist/cordova` 中,除非另有設定。

  • 如果您希望跳過 Cordova CLI 打包步驟,而僅填寫 `/src-cordova/www` 資料夾

$ quasar build -m [ios|android] --skip-pkg
  • 如果您希望使用 IDE (Android Studio / Xcode) 手動建置最終資產,而不是執行終端機建置,那麼
$ quasar build -m [ios|android] --ide

警告

在 Android Studio 中,您會看到一則訊息,建議您升級 Gradle 版本。請勿升級 GRADLE,因為這會破壞 Cordova 專案。任何其他要求的升級也一樣。

Gradle upgrade

如果您遇到任何 IDE 錯誤,請點擊 File > Invalidate caches and restart。

Gradle upgrade

如果您想要啟用 UI 程式碼偵錯功能的生產環境建置

$ quasar build -m [ios|android] -d

# ..or the longer form
$ quasar build -m [ios|android] --debug

提示

另請查看getCordovaBuildParams()getCordovaBuildOutputFolder() (`quasar.config > cordova options`) 從配置 Cordova頁面。