Capacitor のインストール
新しいCapacitorアプリケーションを作成したり、既存のWebプロジェクトにCapacitorを追加することができます。これはCLIまたはVS Code extension を使用して行うことができます。
ビルドするプラットフォームの環境設定 を確認するのを忘れないようにしましょう。
新しいCapacitorアプリケーションを作成する
capacitor/create-app` パッケージを使うと、Capacitor アプリケーションを素早く作成することができます。空のディレクトリで以下のコマンドを実行すると、新しい Capacitor アプリケーションの足場ができます。
npm init @capacitor/app
既存のウェブアプリケーションにCapacitorを追加する
Capacitorは、最新のJavaScriptウェブアプリにドロップできるように設計されています。ただし、既存のアプリケーションでCapacitorを使用する ためには、プロジェクトに次の3つの要件が必要です:
package.json
ファイルdist
やwww
などのビルドされたウェブ資産を格納する別のディレクトリ- ウェブアセットディレクトリのルートにある
index.html
ファイル
Capacitorを正しくインジェクションするには、index.html
ファイルに <head>
タグが含まれている必要があります。もし
がない場合、Capacitorプラグインは動作しません。
Capacitorのインストール
アプリのルートに、Capacitorの主なnpm依存関係(コアJavaScriptランタイムとコマンドラインインターフェース(CLI))をインストールします。
npm i @capacitor/core
npm i -D @capacitor/cli
Capacitorの設定を初期化する
次に、CLIアンケートを使ってCapacitorを初期化します。
npx cap init
CLIは、アプリ名とアプリに使用するパッケージIDから始まり、いくつかの質問をします。capacitor-configファイルには、bundlerのビルドプロセスで予想される出力ディレクトリ(例:Angularの場合は www
、Reactの場合は build
、Vueの場合は public
など)を含む、これらの設定の詳細が記述されます。
Capacitor が使用するフォルダは、npx cap init
中に作成される Capacitor Config ファイルの webDir
変数を変更することでカスタマイズできます。Capacitorは使用しているフレームワークをチェックすることで、Webプロジェクトのデフォルトを検出しようとすることに注意してください。とはいえ、最初のビルドの同期に問題がある場合は、この設定変数をクロスチェックすることをお勧めします。
AndroidとiOSのプ ロジェクトを作成する
Capacitorコアランタイムがインストールされたら、AndroidとiOSプラットフォームをインストールします。
npm i @capacitor/android @capacitor/ios
プラットフォームを package.json
に追加したら、以下のコマンドを実行してネイティブアプリケーション用の Android と iOS プロジェクトを作成します。
npx cap add android
npx cap add ios
ウェブコードをネイティブプロジェクトに同期させる
ネイティブプロジェクトを作成したら、以下のコマンドを実行して、Webアプリケーションをネイティブプロジェクトに同期させることができます。
npx cap sync
npx cap sync
コマンドは、Capacitor Config ファイルの webDir
にあるビルドされた Web バンドルをネイティブプロジェクトにコピーし、ネイティブプロジェクトの依存関係をインストールします。
次に進むべき道
環境が整い、プロジェクトの構成が適切に設定されれば、準備は完了です! より具体的なドキュメントが必要な場合は、以下のリンク先を参照してください。