跳到主要内容
版本:v3

在 Web 项目中使用 Capacitor

Capacitor 完全支持传统 Web 应用和渐进式 Web 应用(PWA)。事实上,使用 Capacitor 可以轻松地为您的 iOS 和 Android 应用商店应用发布 PWA 版本,只需极少的工作量。

浏览器支持

Capacitor 核心和插件基于 ES2017 构建。这种较新的 JavaScript 语法在所有现代浏览器(包括为 iOS 和 Android 上的 PWA 提供支持的浏览器)中都受支持,但在 IE11 中无法工作,除非进行额外的 JavaScript 转换,例如使用 Babel

具有 Web 支持的插件会进行特性检测,如果浏览器不支持特定的 Web API,则会抛出异常。

安装

如果您已经在为 iOS 或 Android 构建 Capacitor 应用,则无需额外的安装步骤!

否则,在继续之前请参阅安装指南

将 Capacitor 作为模块使用

大多数情况下,应用会使用带有构建系统的框架,这些系统支持导入 JavaScript 模块。通过从 @capacitor/core 导入,或通过导入插件,Capacitor JavaScript 运行时将随您的应用一起加载。

将 Capacitor 作为脚本标签使用

要在不使用构建系统或打包器/模块加载器的 Web 应用中使用 Capacitor 运行时,请执行以下操作:

  1. Capacitor 配置文件 中将 bundledWebRuntime 设置为 true
"bundledWebRuntime": true
  1. 将 Capacitor 运行时包(capacitor.js)复制到您的 Web 资源目录
npx cap sync web
  1. 在其他 JavaScript 之前,在 index.html 中导入 capacitor.js
<script src="capacitor.js"></script>
<script src="your/app.js"></script>

上线

当您准备好发布渐进式 Web 应用并与世界分享时,只需上传您的 Web 资源目录的内容即可。

其中包含运行应用所需的一切!