1つのコードベースでiOSとAndroidアプリを構築したいですか? Capacitor CLIは手順を簡素化し、Web技術を使ってネイティブアプリを作成できます。ここでは次のことを学びます:
- クイックセットアップ:Capacitor CLI をインストールし、数分でプロジェクトを初期化します。
- プラットフォーム統合:シンプルなコマンドで iOS と Android のサポートを追加します。
- Live Update: 使用する Capgo で、即座のオーバーザエア更新を実現。
- よくある修正:同期エラーやビルド失敗などの問題をトラブルシューティングします。
始めるための主なステップ:
- インストール Node.js、npm、JDK、 iOSプロファイリングや デバッグ.
- 実行
npm install @capacitor/core @capacitor/cliプロジェクトを初期化します。 - 以下を使用して iOS と Android プラットフォームを追加します
npx cap add iosとnpx cap add android. - オプション: ライブ更新用に Capgo を設定する より速く、.
このガイドでは、Capacitor CLI のセットアップから、プラットフォームの設定、アプリのデプロイまで、必要な手順をすべて解説します。さっそく始めましょう!
ご紹介 Capacitor 設定

セットアップ要件
始めるには、以下のツールがインストールされていることを確認してください:
- Node.js (バージョン 14 以降) と npm
- Java JDK (バージョン 11 以降)
- iOSプロファイリング (iOSビルドはバージョン12以降)
- デバッグ (Androidビルド用)
- Capacitor CLI (バージョン6または7)
任意: Live Updatesを有効にしたい場合は、以下の「Capgo セットアップガイド」を参照してください。
CLI インストール手順
開始前に、以下が揃っていることを確認してください。 Node.js, npm, JDK, iOSプロファイリングや デバッグ セットアップしてください。準備が整ったら、以下を実行して Capacitor CLI をインストールできます:
npm install --save @capacitor/core @capacitor/cli
npx cap init
このコマンドは Capacitor をインストールし、コアコンポーネントを設定します。
このステップを完了したら、次は 新規プロジェクトの作成 に進み、アプリケーションのスケルトンを作成します。
新規プロジェクトの作成
プロジェクトを開始するには Capacitor CLI を使用して、以下の手順に従ってください。
mkdir my-app && cd my-app
npm init -y
npx cap init my-app com.company.app --web-dir dist
設定ファイルの更新
次の内容を含めるために、 capacitor.config.json ファイルに以下の設定を含めるようにしてください。
{
"appId": "com.company.app",
"appName": "My App",
"webDir": "dist",
"bundledWebRuntime": false,
"server": {
"hostname": "app.example.com",
"androidScheme": "https"
}
}
更新後、この設定を使用してプロジェクトの Capacitor を設定します。
プラットフォームのセットアップ
プロジェクトの骨格が整ったので、次は iOS と Android のターゲットを設定します。
iOS と Android の追加
まず、Capacitor CLI を使用して必要なプラットフォーム固有のパッケージをインストールします。
npm install @capacitor/ios @capacitor/android
npx cap add ios
npx cap add android
iOS の場合、Xcode 14 以降がインストールされていることを確認してください。 CocoaPods 1.11以降、macOS 12以降。Androidの場合は、Android Studio Giraffe (2022.3.1+)、JDK 17以降、および Gradle 7.5以上が必要です。
インストール後、Webアプリケーションの変更に合わせてネイティブターゲットを更新する必要があります。
プラットフォームのアップデート
Webアプリを更新した後、プラットフォームを最新のWeb変更と同期するには、以下の手順に従ってください。
npm run build
npx cap sync
この cap sync コマンドは2つのタスクを処理します。
- 更新されたWebアセットをネイティブプラットフォームにコピー
- 最新の变更に合わせてネイティブ設定とプラグインを更新
IDEセットアップ
適切なIDEで、プラットフォーム固有のプロジェクトを開きます:
npx cap open ios # Opens Xcode
npx cap open android # Opens Android Studio
Xcodeの場合:
- 開発チームを選択します。
- 署名証明書を設定します。
- バンドル識別子を更新します。
Android Studio で:
- 内のアプリケーションIDを変更します
build.gradle. - 署名用のkeystoreを設定します。
- debugとreleaseの両方のビルドバリアントを設定します。
すべて設定が完了したら、を使用してプロジェクトをビルドします npx cap build ios または npx cap build android。を実行することを忘れないでください npx cap sync 再度実行し、すべてのアセットが最新であることを確認します。
Capgo セットアップガイド

Capgo を設定して、アプリの即時 OTA 更新を有効にします。
Capgo の主な機能
Capgo は、アプリの更新を効率化する複数のツールを提供します:
- エンドツーエンド暗号化 更新の安全な配信を保証します。
- 更新は バックグラウンドで アプリ起動時に実行されます。
- アナリティクスツール アップデートの成功率やユーザーエンゲージメントの追跡に役立ちます。
- ある ワンクリックロールバック このオプションを使えば、問題のあるアップデートからすぐに復旧できます。
- 以下の チャンネルシステム 段階的なロールアウトやベータテスト向けです。
Capgo のインストール
Capgo を使い始めるには、以下の手順に従ってください:
-
npm install --save @capgo/cli -
Capgo を初期化 プロジェクト内で:
npx capgo init -
アップデートをビルドしてリリース:
npm run build npx capgo release -
アプリを開いて、バックグラウンドのアップデート処理を開始します。
ベストプラクティス
- チャンネルを使って、全ユーザーにロールアウトする前にアップデートをテストします。
- アナリティクスを監視して、アップデートが正常に配信され、ユーザーのエンゲージメントが維持されていることを確認します。
- エラートラッキングを有効にして、問題を早期に検出・修正します。
- ロールバック機能を準備しておき、問題が起きたときはすぐに対応できるようにします。
Capgo は Capacitor 8 と互換性があり、CI/CD パイプラインにスムーズに統合でき、Apple と Google のストア要件にも準拠しています。
よくある問題とヒント
プラットフォームと Capgo のセットアップが完了すると、よくあるエラーに遭遇することがあります。ここでは、それらに素早く対処する方法を説明します。
環境構築の問題
-
CLI が見つかりません エラー:コマンド
npx capが失敗します。 解決策: 以下を実行してnpm install --save @capacitor/cli @capacitor/coreもう一度お試しください。 -
Node バージョンの不一致 エラー:Node.js のバージョンエラーにより、CLI コマンドが失敗します。 解決策:セットアップ要件に従って、Node.js バージョン 14 以上をインストールしてください。
設定の問題
-
設定の不一致 エラー:
capacitor.config.json変更が反映されません。 解決策:appIdとwebDirプロジェクトのpackage.jsonと Web ビルド出力フォルダが一致することを確認してください。 -
プラットフォーム同期エラー エラー:実行中
npx cap syncプラグインのバージョン競合を引き起こします。 解決策:更新@capacitor/androidと@capacitor/ios同じメジャーバージョンに更新し、sync コマンドを再実行してください。
ビルドとデプロイ
-
ビルド署名の失敗 エラー:証明書や keystore が不足しているため、iOS または Android のビルドが失敗します。 解決策:IDE のセットアップ手順に従ってください。iOS の場合は Xcode で開発チームを追加し、Android の場合は keystore を設定します。
build.gradle. -
Webディレクトリが見つかりません エラー:
npx cap syncWebアセットが見つかりません。 解決策:Webビルドコマンド(例:npm run build)を実行してから、プラットフォームを同期してください。
Live Update の問題
- Capgo 更新の失敗
エラー:本番アプリに更新が表示されません。
解決策:あなたの Capgo API キー における
capacitor.config.json正しいチャネルをターゲットにしていることを確認してください。
プラットフォーム固有のセットアップの詳細は、Platform Setupセクションをもう一度確認してください。Live Updatesを利用する場合は、追加のトラブルシューティングのヒントについてCapgo Setup Guideを参照してください。
まとめ
セットアップの確認
Capacitor CLIでWebアプリを開始し、iOSとAndroidプラットフォームをセットアップします。必要に応じてLive Updates用のCapgoも追加してください。
始め方は以下の通りです:
- プロジェクトを初期化するには、Capacitor CLIを使用します。
- アプリのパッケージIDを設定し、Web出力ディレクトリを定義します。
- iOSとAndroidプラットフォームのサポートを追加します。
- 次のコマンドでCapgoをインストールしてセットアップします:
npm install --save @capgo/cli && npx capgo init
詳細なセットアップ手順やトラブルシューティングについては、公式のCapacitorおよびCapgoドキュメントを確認してください。
Capacitor CLIからの続き:Project Setup Guide
使用している場合 Capacitor CLI: プロジェクトセットアップガイド ダッシュボードと API の運用を計画するには、これを次と連携させます API の概要 「API の概要」の実装の詳細については、 はじめに 「はじめに」における実装の詳細については、 API キー API Keys の実装の詳細については、 デバイス Devices の実装詳細については、および Bundle Bundlesの実装詳細については