跳到主要内容
版本:v6

Capacitor Android 文档

Capacitor 提供了原生 Android 运行时环境,使开发者能够在 JavaScript 与原生 Java 或 Kotlin 代码之间进行通信。

Capacitor Android 应用通过 Android Studio 进行配置和管理。

Android 支持情况

支持 API 22+(Android 5.1 或更高版本),这覆盖了超过 99% 的 Android 市场。Capacitor 要求 Android WebView 使用 Chrome 60 或更高版本。在 Android 5-6 及 10+ 系统上,Capacitor 使用 Android 系统 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 命令的信息

使用 run 命令需要有物理 Android 设备或已下载的模拟器系统镜像。有关在 Android Studio 中创建模拟器设备和下载系统镜像的说明,请参阅相关文档

通过 Android Studio 运行

在 Android Studio 中,首先选择设备或模拟器,然后点击运行或调试按钮来启动应用。除非你正在调试 Java 或 Kotlin 代码,否则建议使用运行按钮。

运行应用

故障排除

如果在入门过程中遇到任何问题,可以参考 Android 故障排除指南。如需帮助,欢迎发起讨论

后续步骤

如果你的应用已成功运行,现在可以继续开发和构建应用了。利用各种可用的 API、Capacitor 或 Cordova 插件,或自定义原生代码来完成应用的其余部分。

延伸阅读

如需了解更多关于设置应用权限、更新依赖项、构建插件等 Android 相关指南,请参阅:

配置和设置 Android 应用权限 ›

构建 Android 原生插件 ›