跳到主要内容
版本:v4

安装 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 资源,例如 distwww
  • 在 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 变量,来自定义要复制的文件夹。

下一步

完成环境设置和项目结构配置后,你就可以开始了!如果需要更具体的文档,可以点击以下任意链接。

开始 iOS 开发 ›

开始 Android 开发 ›

开发者工作流程指南 ›