Capacitor Android 文档
Capacitor 提供原生 Android 运行时,使开发者能够在 JavaScript 与原生 Java 或 Kotlin 代码之间进行通信。
Capacitor Android 应用通过 Android Studio 进行配置和管理。
Android 支持
支持 API 21+(Android 5 或更高版本),这覆盖了 超过 99% 的 Android 市场。Capacitor 需要 Chrome 60 或更高版本的 Android WebView。在 Android 5-6 和 10+ 上,Capacitor 使用 Android System WebView。在 Android 7-9 上,Google Chrome 提供 WebView。
添加 Android 平台
首先,安装 @capacitor/android 包。
npm install @capacitor/android
然后,添加 Android 平台。
npx cap add android
打开 Android 项目
要在 Android Studio 中打开项目,请运行:
npx cap open android
或者,您也可以打开 Android Studio 并导入 android/ 目录作为 Android Studio 项目。
运行您的应用
您可以通过命令行或 Android Studio 运行应用。
要使用 Android 模拟器,必须使用 API 24+ 的系统镜像。系统 WebView 在模拟器上不会自动更新。物理设备只要系统 WebView 已更新,最低可支持 API 21。
在命令行中运行
要在设备或模拟器上运行项目,请执行:
npx cap run android
该命令将提示您选择一个目标。详细了解 run 命令。
使用 Android Studio 运行
在 Android Studio 中,首先选择设备或模拟器,然后点击运行或调试按钮来启动应用。除非您正在调试 Java 或 Kotlin 代码,否则建议使用运行按钮。

问题排查
如果您在入门时遇到任何问题,可以查阅 Android 问题排查指南。如果需要帮助,请随时 发起讨论。
下一步
如果您的应用已成功运行,现在可以继续开发和构建您的应用了。使用各种可用的 API、Capacitor 或 Cordova 插件,或自定义原生代码来构建应用的其余部分。
延伸阅读
请遵循以下 Android 特定指南,以获取有关为应用设置权限、更新依赖项、构建插件等的更多信息: