メインコンテンツまでスキップ
バージョン: v7

環境設定

Capacitorは3つのアプリケーションターゲットを公式にサポートしています。Android、iOS、そしてWebです。3つのプラットフォームすべてに対応したアプリケーションを作成するためには、以下の依存関係をすべてインストールする必要があります。ネイティブモバイルターゲットのいずれかをターゲットにしていない場合は、関連するセクションをスキップすることができます。

備考

デスクトップのサポートが必要ですか？Capacitorを使用してWindowsまたはElectronアプリをビルドすることも可能です!

要件​

Capacitorでアプリケーションを開発するには、NodeJS 20以上がインストールされている必要があります。Nodeをインストールするには、Nodeのウェブサイトのインストーラを使用するか、JavaScriptツールマネージャの Volta を使用するか、homebrewやChocolateyのようなパッケージマネージャを使用します。

Nodeをインストールしたら、ターミナルを開いて以下のコマンドを入力し、nodeが正しくインストールされていることを確認します。

node --version
# v20.9.0

Nodeをインストールしたら、CapacitorでProgressive Web Application (PWA)の作成を始めることができます。

iOSの要件​

iOSアプリをビルドするには、macOSが必要です。Macを持っていない場合、iOSクラウドビルドを実行するために使用できる Ionic Appflow のようなソリューションがありますが、Capacitorアプリケーションを適切にテストするために、ローカルでツールを利用できるようにすることを強く推奨します。

Capacitorを使用してiOSアプリケーションを開発するには、さらに依存関係が必要です。

  • Xcode
  • Xcode Command Line Tools
  • Homebrew
  • Cocoapods

Xcode、Xcode Command Line Tools、Cocoapodsをインストールすると、iOSアプリケーションとPWAの両方を作成することができるようになります。

Xcode​

Xcode is Apple's IDE for creating native macOS, iOS, and iPadOS applications. You can install Xcode by using the Apple App Store on your Mac. Capacitor 7 requires a minimum of Xcode 16.0.

Xcodeのコマンドラインツール​

Xcodeのコマンドラインツールは、アプリケーションの構築とテストに必要な、Xcodeのコアに含まれていない追加のツールです。Xcodeがインストールされたら、ターミナルで以下のコマンドを実行することで、Xcode Command Line Toolsをインストールすることができます。

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](https://cocoapods.org/)をインストールするには、ターミナルで次のコマンドを実行します。

brew install cocoapods

以下のコマンドを実行することで、CocoaPodsが正しくインストールされたことを確認できます。

pod --version
# 1.12.1

Homebrewを使わないCocoaPodsのインストール​

CocoaPodsはRuby Gemで直接インストールすることができます。インストールするには、以下のコマンドを実行します。

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アプリケーションを開発するには、さらに2つの依存関係が必要です。

  • Android Studio
  • Android SDKのインストール
注記

Java Development Kit (JDK)を別途インストールする必要はありません。Android Studio が自動的に適切なJDKをインストールします。

Android StudioでAndroid SDKをインストールし、コア要件を満たせば、AndroidアプリとPWAの両方を作成することができます。

Android Studio​

Android Studioは、ネイティブAndroidアプリケーションを作成するためのGoogleのIDEです。Android Studioは Android Studio download page からインストールできます。Capacitor 7には、最低でもAndroid Studio 2024.2.1. が必要です。

Android SDK​

Android Studioのインストールが完了したら、Android SDKのパッケージをインストールする必要があります。

Androidアプリを開発するには、いくつかのAndroid SDKパッケージがインストールされている必要があります。Android SDK Toolsと、API 23以上のバージョンのAndroid SDK Platformsを必ずインストールしてください。

Android Studioのメニューから Tools -> SDK Manager を開き、SDK Platforms タブにテストしたいプラットフォームのバージョンをインストールします。

SDK Platforms

使い始めるには、1つのAPIバージョンをインストールするだけでよい。上の画像では、Android 9（API 28）とAndroid 10（API 29）のSDKがインストールされている。最新の安定バージョンはAndroid 15（API 35）です。

Contents

このページを編集