Capacitor Android ドキュメンテーション
Capacitor は Native の Android ランタイムを特徴としており、開発者は JavaScript と Native Java for Android コード間で通信することができます。
Capacitor の Android アプリは、Android Studio で設定・管理されています。
Androidサポート
API 22+（Android 5.1以降）がサポートされており、これは Android市場の99%以上 に相当します。Capacitorには、Chromeバージョン60以降のAndroid WebViewが必要です。Android 5～6、および10以上では、CapacitorはAndroid System WebViewを使用します。Android 7-9では、Google ChromeがWebViewを提供します。
Android プラットフォームの追加
まず、@capacitor/android パッケージをインストールします。
npm install @capacitor/android
次に、Androidのプラットフォームを追加します。
npx cap add android
Android プロジェクトのオープン
Android Studio でプロジェクトを開くには、次のように実行します:
npx cap open android
あるいは、Android Studio を開いて、 android/ ディレクトリを Android Studio プロジェクトとしてインポートすることもできます。
Running Your App
作成したアプリは、コマンドラインまたは Android Studio で実行することができます。
Android エミュレータを使用するには、API 24+ のシステムイメージを使用する必要があります。エミュレータでは、System WebView は自動的に更新されません。物理デバイスの場合は、システム WebView が更新されていれば、API 21 以下で動作します。
コマンドラインでの実行
物理デバイスやエミュレータでプロジェクトを実行するには、次のように実行します:
npx cap run android
コマンドを実行すると、ターゲットを選択するように促されます。詳しくは run をご覧ください。
runコマンドを使用するには、物理的なAndroidデバイスか、ダウンロードしたエミュレータのシステムイメージのどちらかが必要です。Android Studio でのエミュレータデバイスの作成とシステムイメージのダウンロードについては、 こちらのドキュメント を参照してください。
Android Studio での実行
Android Studio では、まずデバイスやエミュレータを選択し、実行またはデバッグボタンをクリックしてアプリを実行します。Java や Kotlin のコードをデバッグするのでなければ、実行ボタンが好ましいでしょう。
トラブルシューティング
使い始めてすぐに何か問題が発生した場合は、 Android トラブルシューティングガイド を参考にしてください。お困りの方は、お気軽に ディスカッションを開いて までご連絡ください。
次のステップ
アプリが動作すれば、アプリの開発と構築を続ける準備が整いました。様々な API、Capacitor や Cordova のプラグイン、またはカスタムネイティブコードを使用して、アプリの残りの部分を構築してください。
Further Reading
アプリのパーミッションの設定、依存関係の更新、プラグインの構築などの詳細については、以下の Android 固有のガイドを参照してください。