在 Web 项目中使用 Capacitor
Capacitor 完全支持传统的 Web 应用和渐进式 Web 应用(PWA)。实际上,使用 Capacitor 可以让你轻松地为 iOS 和 Android 应用商店的应用发布一个 PWA 版本,所需工作量极小。
浏览器支持
Capacitor 核心库和插件基于 ES2017 构建。所有现代浏览器(包括 iOS 和 Android 上支持 PWA 的浏览器)都支持这种较新的 JavaScript 语法,但在 IE11 中需要额外的 JavaScript 转换(例如使用 Babel)才能运行。
提供 Web 支持的插件会进行功能检测,如果浏览器不支持特定的 Web API,则会抛出异常。
安装
如果你已经在为 iOS 或 Android 使用 Capacitor 进行构建,则无需额外的安装步骤!
否则,请先阅读安装指南再继续。
将 Capacitor 作为模块使用
大多数情况下,应用会使用支持导入 JavaScript 模块的构建系统框架。通过从 @capacitor/core 导入,或导入一个插件,Capacitor JavaScript 运行时将随你的应用一同加载。
将 Capacitor 作为脚本引入使用
要在未使用构建系统或打包器/模块加载器的 Web 应用中使用 Capacitor 运行时,请按以下步骤操作:
- 在 Capacitor 配置文件 中将
bundledWebRuntime设置为true
"bundledWebRuntime": true
- 将 Capacitor 运行时包 (
capacitor.js) 复制到你的 Web 资源目录中
npx cap sync web
- 在
index.html中,在其他 JavaScript 代码之前引入capacitor.js
<script src="capacitor.js"></script>
<script src="your/app.js"></script>
发布上线
当你准备好发布你的渐进式 Web 应用并与世界分享时,只需上传你的 Web 资源目录中的内容即可。
其中包含了运行你的应用所需的一切!