跳到主要内容
版本：v6

常见问题

以下是 Capacitor 的常见问题列表。如果您在此处找不到答案，请查看我们的论坛或我们的 Discord。查看侧边栏获取常见问题列表 👉

Capacitor 支持哪些平台？​

Capacitor 可以通过我们的官方和社区平台支持几乎任何设备。

官方平台​

Capacitor 官方支持以下平台：

  • iOS 13+
  • Android 5.1+
    • 需要 Chrome WebView 60+
  • 现代 Web 浏览器
    • Chrome
    • Firefox
    • Safari
    • Edge

社区平台​

Capacitor 还有面向跨平台桌面框架的社区平台。当前的社区目标如下：

我需要将 Ionic Framework 与 Capacitor 一起使用吗？​

不需要！Capacitor 适用于任何 Web 应用，不仅限于使用其他 Ionic 工具构建的应用。如果您希望为 Capacitor 应用使用特定的外观和风格，而 Ionic Framework 不适合您的 UI 工具包，您不必强制使用它。两个应用商店中都有大量使用 Capacitor 但不使用 Ionic Framework 的应用。

在哪里可以找到 Capacitor 项目的插件？​

要找到项目的插件，您应按以下顺序查看以下位置。

Capacitor 社区 GitHub ⚡​

Capacitor 社区 GitHub 组织 列出了我们出色的开发者社区创建的插件。它们是优先为 Capacitor 设计的插件，正在积极开发中，应该可以在任何 Capacitor 3+ 项目中使用。如果您需要插件，这应该是您首先查找的地方之一。

Awesome Capacitor 😎​

像许多其他 Awesome 列表一样，Awesome Capacitor 是一个社区策划的优秀 Capacitor 插件列表。如果您找不到官方或社区插件，很可能已经有人在这里制作了您正在寻找的插件。

Project Fugu 🐡​

Project Fugu 是 Chromium 团队跟踪已添加到 Chromium 浏览器的 Web API 的跟踪器。虽然某些功能可能不支持 Android 和 iOS 两者，但像 Web Share 和 ContactsManager（仅 Android） 等功能，可能会在您的用例中替代 @capacitor/share 或 @capacitor-community/contacts。

您可以使用 Can I Use...? 来检查这些功能是否可以在 Android 和 iOS 上使用，无需任何原生插件。

Cordova 插件 🔌​

您知道 Capacitor 支持 Cordova 插件吗？如果您正在从 Cordova 迁移，或者有一个没有等效 Capacitor 插件的 Cordova 插件，您可以直接在 Capacitor 中使用大多数 Cordova 插件。您可以阅读我们的指南，了解如何在 Capacitor 中使用 Cordova 插件。

我可以不用 Mac 构建 iOS 应用吗？​

简短的回答是，不能。更长的回答是，虽然您可以使用像 Ionic AppFlow 这样的云服务，但您将无法在设备或模拟器上测试您的应用。您应该始终确保使用物理设备测试您的应用，以确认您的 Capacitor 应用对使用 Apple 产品的用户是可用的。

为什么在 Android 模拟器上运行时会看到空白屏幕？​

Capacitor 需要 Android 5.1 以及 WebView 版本 60 或更高版本。例如，如果您创建了一个 Android 6 或 7 的模拟器，则不会安装最新版本的 WebView，您将看到一个空白的白色屏幕。为了解决这个问题，您可以安装更新的 Android 模拟器来测试您的应用。

为什么我在 Apple Silicon 设备上遇到 CocoaPods 错误？​

如果您使用 sudo gem install cocoapods 安装了 CocoaPods 并且使用的是 Apple Silicon 驱动的 Mac，那么在运行 npx cap update 时可能会遇到这样的错误：

[error] Analyzing dependencies
        /Library/Ruby/Gems/2.6.0/gems/ffi-1.15.3/lib/ffi/library.rb:275: [BUG] Bus Error at 0x0000000000000000
        ruby 2.6.3p62 (2019-04-16 revision 67580) [universal.arm64e-darwin20]

这是一个 CocoaPods 的 bug，与 ffi 未在 Apple Silicon 计算机上安装有关。我们建议使用 Homebrew 安装 CocoaPods。或者，如果您安装了 Rosetta，可以在 x86_64 架构上安装 ffi，并在首次使用模拟的 Intel 架构运行 pod install：

$ sudo arch -x86_64 gem install ffi
$ arch -x86_64 pod install

之后，运行 Capacitor 应该可以正常工作。

Contents

编辑此页