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

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 のコードをデバッグするのでなければ、実行ボタンが好ましいでしょう。

Running App

トラブルシューティング

使い始めてすぐに何か問題が発生した場合は、 Android トラブルシューティングガイド を参考にしてください。お困りの方は、お気軽に ディスカッションを開いて までご連絡ください。

次のステップ

アプリが動作すれば、アプリの開発と構築を続ける準備が整いました。様々な API、Capacitor や Cordova のプラグイン、またはカスタムネイティブコードを使用して、アプリの残りの部分を構築してください。

Further Reading

アプリのパーミッションの設定、依存関係の更新、プラグインの構築などの詳細については、以下の Android 固有のガイドを参照してください。

Android の設定とパーミッションの設定 ›

Android 用のネイティブプラグインを作る ›