为什么捐赠
API 资源管理器
升级指南
NEW!
quasar.config 文件
转换为 CLI with Webpack
浏览器兼容性
支持 TypeScript
目录结构
命令列表
CSS 预处理器
路由
延迟加载 - 代码拆分
处理资源
启动文件
预取功能
API 代理
处理 Webpack
处理 process.env
使用 Pinia 进行状态管理
使用 Vuex 进行状态管理
代码检查器
测试 & 审计
开发移动应用
Ajax 请求
向公众开放开发服务器
Quasar CLI 与 Webpack - @quasar/app-webpack
移动应用构建命令

在我们深入之前,请确保你已安装 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 现代构建

默认情况下,由于 Cordova 的问题,Xcode 的 iOS 现代构建已禁用。但是,如果你知道自己在做什么并且想要启用它,请从 /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 页面。