为什么要捐赠
API 资源管理器
升级指南
NEW!
quasar.config 文件
将项目转换为 CLI with Vite
浏览器兼容性
支持 TypeScript
目录结构
命令列表
CSS 预处理器
路由
延迟加载 - 代码拆分
处理资源
启动文件
预取功能
API 代理
处理 Vite
处理 process.env
使用 Pinia 进行状态管理
使用 Vuex 进行状态管理
代码风格检查器
测试 & 审计
开发移动应用程序
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 错误,请单击文件 > 使缓存失效并重启。

Gradle upgrade

为了让您能够在设备模拟器上或直接在手机上进行开发(包括热模块重新加载),Quasar CLI 会执行以下步骤

  1. 检测您的机器的外部 IP 地址。如果检测到多个此类 IP,则会要求您选择一个。如果您将使用手机进行开发,请选择您的机器上可从手机/平板电脑 ping 通的 IP 地址。
  2. 它会在您的机器上启动一个开发服务器。
  3. 它会临时更改 <content/> 标签(位于 /src-cordova/config.xml 中)以指向之前检测到的 IP。这允许应用程序连接到开发服务器。
  4. 它会将工作委托给 Cordova CLI 以构建带有临时更改的 config.xml 的本地应用程序。
  5. Cordova CLI 会检查是否有移动电话/平板电脑连接到您的开发机器。如果有,它会将开发应用程序安装到设备上。如果没有找到,它会启动一个模拟器并运行开发应用程序。
  6. 最后,它会还原对 /src-cordova/config.xml 所做的临时更改。

警告

如果在手机/平板电脑上进行开发,您的构建机器的外部 IP 地址必须可从手机/平板电脑访问,否则您将得到一个只有白屏的开发应用程序。还要检查您的机器的防火墙,以允许连接到所选的开发端口。

启用 iOS 现代构建

默认情况下,Xcode 针对 iOS 的现代构建被禁用,因为 Cordova 存在问题。但是,如果您知道自己在做什么,并且想要启用它,请从 /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 错误,请单击文件 > 使缓存失效并重启。

Gradle upgrade

如果您想要一个启用了 UI 代码调试功能的生产构建

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

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

提示

还可以查看 getCordovaBuildParams()getCordovaBuildOutputFolder()(quasar.config > cordova 选项),请参阅 配置 Cordova 页面。