メインコンテンツへスキップ

Capacitor CLI: プロジェクトセットアップガイド

Web技術でネイティブiOS/Androidアプリを構築するためのCapacitor CLIのセットアップ方法を、いくつかの簡単なステップで学びましょう。

「Capacitor CLI: プロジェクトセットアップガイド」 Capgo ブログ用イラスト

1つのコードベースでiOSとAndroidアプリを構築したいですか? Capacitor CLIは手順を簡素化し、Web技術を使ってネイティブアプリを作成できます。ここでは次のことを学びます:

  • クイックセットアップ:Capacitor CLI をインストールし、数分でプロジェクトを初期化します。
  • プラットフォーム統合:シンプルなコマンドで iOS と Android のサポートを追加します。
  • Live Update: 使用する Capgo で、即座のオーバーザエア更新を実現。
  • よくある修正:同期エラーやビルド失敗などの問題をトラブルシューティングします。

始めるための主なステップ:

  1. インストール Node.js、npm、JDK、 iOSプロファイリングや デバッグ.
  2. 実行 npm install @capacitor/core @capacitor/cli プロジェクトを初期化します。
  3. 以下を使用して iOS と Android プラットフォームを追加します npx cap add ios と npx cap add android.
  4. オプション: ライブ更新用に Capgo を設定する より速く、.

このガイドでは、Capacitor CLI のセットアップから、プラットフォームの設定、アプリのデプロイまで、必要な手順をすべて解説します。さっそく始めましょう!

ご紹介 Capacitor 設定

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の場合:

  1. 開発チームを選択します。
  2. 署名証明書を設定します。
  3. バンドル識別子を更新します。

Android Studio で:

  1. 内のアプリケーションIDを変更します build.gradle.
  2. 署名用のkeystoreを設定します。
  3. debugとreleaseの両方のビルドバリアントを設定します。

すべて設定が完了したら、を使用してプロジェクトをビルドします npx cap build ios または npx cap build android。を実行することを忘れないでください npx cap sync 再度実行し、すべてのアセットが最新であることを確認します。

Capgo セットアップガイド

Capgo Live Update ダッシュボードインターフェース

Capgo を設定して、アプリの即時 OTA 更新を有効にします。

Capgo の主な機能

Capgo は、アプリの更新を効率化する複数のツールを提供します:

  • エンドツーエンド暗号化 更新の安全な配信を保証します。
  • 更新は バックグラウンドで アプリ起動時に実行されます。
  • アナリティクスツール アップデートの成功率やユーザーエンゲージメントの追跡に役立ちます。
  • ある ワンクリックロールバック このオプションを使えば、問題のあるアップデートからすぐに復旧できます。
  • 以下の チャンネルシステム 段階的なロールアウトやベータテスト向けです。

Capgo のインストール

Capgo を使い始めるには、以下の手順に従ってください:

  1. Capgo CLI をインストール:

    npm install --save @capgo/cli
  2. Capgo を初期化 プロジェクト内で:

    npx capgo init
  3. アップデートをビルドしてリリース:

    npm run build
    npx capgo release
  4. アプリを開いて、バックグラウンドのアップデート処理を開始します。

ベストプラクティス

  • チャンネルを使って、全ユーザーにロールアウトする前にアップデートをテストします。
  • アナリティクスを監視して、アップデートが正常に配信され、ユーザーのエンゲージメントが維持されていることを確認します。
  • エラートラッキングを有効にして、問題を早期に検出・修正します。
  • ロールバック機能を準備しておき、問題が起きたときはすぐに対応できるようにします。

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 sync Webアセットが見つかりません。 解決策: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の実装詳細については

Capacitor アプリ向けの Live Updates

Web レイヤーのバグが本番で発生したら、App Store の審査を何日も待たずに Capgo で修正を配信しましょう。ネイティブの変更は通常の審査フローに残したまま、ユーザーはバックグラウンドでアップデートを受け取れます。

最新のブログ記事

Capgoは、真にプロフェッショナルなモバイルアプリを作るために必要な最高のインサイトを提供します。