跳到主要内容
版本:v8

Capacitor Android 文档

Capacitor 具有原生 Android 运行时,使开发者能够在 JavaScript 和原生 Java 或 Kotlin 代码之间进行通信。

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

Android 支持

支持 API 24+(Android 7 或更高版本),代表了约 99% 的 Android 市场。Capacitor 需要带有 Chrome 版本 60 或更高版本的 Android WebView。在 Android 7-9 上,Google Chrome 提供 WebView。在 Android 10+ 上,Capacitor 使用 Android System 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+ 系统镜像。System WebView 不会在模拟器上自动更新。只要系统 WebView 已更新,物理设备应该可以支持低至 API 24。

在命令行上运行

要在设备或模拟器上运行项目,请运行:

npx cap run android

该命令将提示您选择目标。了解更多关于 run 的信息

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

使用 Android Studio 运行

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

运行应用

故障排除

如果您在入门过程中遇到任何问题,可以查阅 Android 故障排除指南。如果您需要帮助,请随时发起讨论

后续步骤

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

延伸阅读

请遵循这些 Android 特定指南,了解更多有关为应用设置权限、更新依赖项、构建插件等的信息:

配置和设置 Android 权限 ›

为 Android 构建原生插件 ›