安装 Capacitor
你可以创建一个新的 Capacitor 应用程序,也可以将 Capacitor 添加到现有的 Web 项目中。这可以通过 CLI 或使用 VS Code 扩展 来完成。
请记住,确保为你要构建的平台 设置好环境。
创建新的 Capacitor 应用
@capacitor/create-app 包可用于快速创建 Capacitor 应用程序。你可以在空目录中运行以下命令来搭建一个新的 Capacitor 应用。
npm init @capacitor/app
将 Capacitor 添加到现有 Web 应用
Capacitor 被设计为可以轻松集成到任何现代 JavaScript Web 应用程序中。但是,为了在你的现有应用中使用 Capacitor,你的项目需要满足以下三个要求:
- 一个
package.json文件 - 一个单独的目录用于存放构建后的 Web 资源,例如
dist或www - 在 Web 资源目录的根目录下有一个
index.html文件
你的 index.html 文件必须包含 <head> 标签,以便 Capacitor 正确注入。如果你的 HTML 中没有 <head> 标签,Capacitor 插件将无法工作。
安装 Capacitor
在你的应用根目录下,安装 Capacitor 的主要 npm 依赖:核心 JavaScript 运行时和命令行界面 (CLI)。
npm i @capacitor/core
npm i -D @capacitor/cli
初始化 Capacitor 配置
然后,使用 CLI 问卷初始化 Capacitor:
npx cap init
CLI 会询问你几个问题,首先是你的应用名称,以及你想为应用使用的包 ID。
创建 Android 和 iOS 项目
安装 Capacitor 核心运行时后,你可以安装 Android 和 iOS 平台。
npm i @capacitor/android @capacitor/ios
将平台添加到 package.json 后,你可以运行以下命令为你的原生应用程序创建 Android 和 iOS 项目。
npx cap add android
npx cap add ios
将 Web 代码同步到原生项目
创建原生项目后,你可以通过运行以下命令将 Web 应用程序同步到原生项目中。
npx cap sync
npx cap sync 会将你构建的 Web 应用程序(默认为 www 目录)复制到 原生项目中,并安装原生项目的依赖项。
你可以通过修改在 npx cap init 期间创建的 Capacitor 配置 文件中的 webDir 变量,来自定义要复制的文件夹。
下一步
完成环境设置和项目结构配置后,你就可以开始了!如果需要更具体的文档,可以点击以下任意链接。