跳到主要内容
版本：v6

环境设置

Capacitor 有三个官方支持的应用目标平台：Android、iOS 和 Web。为了为所有三个平台创建应用，您需要安装以下所有依赖。如果您不针对某个原生移动目标平台，可以跳过相应的部分。

核心要求​

为了使用 Capacitor 开发任何应用，您需要安装 NodeJS 18 或更高版本。您可以通过 Node 网站 上的安装程序、使用 Volta（一个 JavaScript 工具管理器），或者使用像 homebrew 或 Chocolatey 这样的包管理器来安装 Node。

安装 Node 后，打开您选择的终端并输入以下命令以确保 Node 正确安装：

node --version
# v20.9.0

安装了 Node 后，您就可以开始使用 Capacitor 创建渐进式 Web 应用（PWA）了。

iOS 要求​

要构建 iOS 应用，您需要 macOS。虽然有一些解决方案如 Ionic Appflow 可以在没有 Mac 的情况下执行 iOS 云构建，但强烈建议您在本地拥有可用的工具，以便正确测试您的 Capacitor 应用。

为了使用 Capacitor 开发 iOS 应用，您需要四个额外的依赖：

  • Xcode
  • Xcode 命令行工具
  • Homebrew
  • Cocoapods

一旦您安装了核心要求以及 Xcode、Xcode 命令行工具和 Cocoapods，您就可以创建 iOS 应用和 PWA 了。

Xcode​

Xcode 是 Apple 的 IDE，用于创建原生 macOS、iOS 和 iPadOS 应用。您可以通过 Apple App Store 在 Mac 上安装 Xcode。Capacitor 6 需要 Xcode 15.0 或更高版本。

Xcode 命令行工具​

Xcode 命令行工具是 Xcode 核心之外未包含的额外工具，用于构建和测试您的应用。安装 Xcode 后，您可以通过在终端中运行以下命令来安装 Xcode 命令行工具：

xcode-select --install

输入密码并等待几分钟让软件包安装完成后，您可以通过运行以下命令来验证工具是否已安装：

xcode-select -p
# /Applications/Xcode.app/Contents/Developer

Homebrew​

Homebrew 是 macOS 软件包的包管理器。您需要安装它以在 Intel 和 Apple Silicon Mac 上安装 CocoaPods。

要安装 Homebrew，请运行以下 bash 命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
信息

不只是我们这么说！brew.sh 也推荐这样安装 Homebrew。

如果您不想安装 Homebrew，可以在下面找到替代的（但不推荐）安装说明。

CocoaPods​

CocoaPods 是 iOS 依赖管理器，Capacitor 使用它来安装和管理 iOS 项目的原生依赖。您可以通过在终端中运行以下命令来安装 CocoaPods：

brew install cocoapods

您可以通过运行以下命令来验证 CocoaPods 是否正确安装：

pod --version
# 1.12.1

不通过 Homebrew 安装 CocoaPods​

您可以直接通过 Ruby Gem 安装 CocoaPods。要安装它，可以运行以下命令：

sudo gem install cocoapods

然而，以这种方式安装 CocoaPods 不会在 Apple Silicon Mac 上工作。您需要在启用 Rosetta 的情况下运行 CocoaPods。为此，您可以运行以下命令：

sudo arch -x86_64 gem install ffi

然后，每当您想要更新应用以使用更新版本的 Web 代码时，您需要运行以下命令：

npx cap copy
arch -x86_64 pod install

Android 要求​

为了使用 Capacitor 开发 Android 应用，您需要两个额外的依赖：

  • Android Studio
  • 已安装的 Android SDK
备注

您不需要单独安装 Java 开发工具包（JDK）。Android Studio 会自动为您安装正确的 JDK。

一旦您安装了核心要求以及包含 Android Studio 的 Android SDK，您就可以创建 Android 应用和 PWA 了。

Android Studio​

Android Studio 是 Google 的 IDE，用于创建原生 Android 应用。您可以通过访问 Android Studio 下载页面 来安装 Android Studio。Capacitor 6 需要 Android Studio 2023.1.1 或更高版本。

Android SDK​

安装 Android Studio 后，您需要安装一个 Android SDK 包。

开发 Android 应用需要安装一些 Android SDK 包。请确保安装 Android SDK 工具，以及 API 22 或更高版本的 Android SDK 平台。

在 Android Studio 中，从菜单打开 工具 -> SDK 管理器，并在 SDK 平台 选项卡中安装您想要测试的平台版本：

SDK 平台

要开始使用，您只需安装一个 API 版本。在上图中，安装了 Android 9（API 28）和 Android 10（API 29）的 SDK。最新的稳定版本是 Android 14（API 34）。

Contents

编辑此页