在我们深入之前,请确保你已安装 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 项目崩溃。其他任何要求的升级也是如此。
如果你遇到任何 IDE 错误,请点击文件 > 使缓存失效并重新启动。
为了让你能够在设备模拟器上或直接在手机上进行开发(包括热模块重载),Quasar CLI 会执行以下步骤
- 检测你机器的外部 IP 地址。如果检测到多个此类 IP,则会要求你选择一个。如果你要使用手机进行开发,请选择可以从手机/平板电脑 ping 通的机器的 IP 地址。
- 它会在你的机器上启动一个开发服务器。
- 它会暂时更改
<content/>
标签(位于/src-cordova/config.xml
中)以指向之前检测到的 IP。这使得应用程序能够连接到开发服务器。 - 它会委托给 Cordova CLI 来构建一个使用临时更改的 config.xml 的原生应用程序。
- Cordova CLI 检查是否有手机/平板电脑连接到你的开发机器。如果有,它会在其上安装开发应用程序。如果没有找到,则它会启动一个模拟器并运行开发应用程序。
- 最后,它会恢复对
/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 项目崩溃。其他任何要求的升级也是如此。
如果你遇到任何 IDE 错误,请点击文件 > 使缓存失效并重新启动。
如果你想要一个启用 UI 代码调试的生产构建
$ quasar build -m [ios|android] -d
# ..or the longer form
$ quasar build -m [ios|android] --debug
技巧
此外,请查看 getCordovaBuildParams()
和 getCordovaBuildOutputFolder()
(quasar.config > cordova 选项),具体内容请参阅 配置 Cordova 页面。