概要
Capacitor は、HTML・CSS・JavaScript / TypeScript で書いた Web アプリを、iOS・Android のネイティブアプリとして動かすオープンソースのランタイム。開発元は Ionic チームで、Apache Cordova の課題を踏まえて別プロジェクトとして作られた(Cordova からの移行ガイドあり)。同じコードを Web(PWA)としても配信できる。
アプリの実体はネイティブアプリに埋め込まれた WebView。Web で作った画面がほぼそのまま動くのが最大の利点で、同時に描画性能面の制約の出どころでもある。
詳細
仕組みと特徴
- ブリッジ: カメラ・位置情報・プッシュ通知などの端末機能は、JavaScript からブリッジ経由でネイティブ側のプラグインを呼ぶ。公式プラグインは TypeScript の型付き API(例:
@capacitor/geolocation) - フレームワークを選ばない: React・Vue・Svelte・Angular・素の JS など、ビルドで静的な Web アセットが出れば何でもよい
- ネイティブプロジェクトはソースコード: Cordova ではビルドのたびに生成し直す成果物だったが、Capacitor では
npx cap addで作ったios/・android/を Git 管理し、Xcode や Android Studio で署名・Info.plist・AndroidManifest.xml・ネイティブコードを直接編集する - 自作プラグイン: JS 側の定義(
registerPlugin<EchoPlugin>('Echo'))、ネイティブ側の本体(iOS はCAPPlugin、Android は@CapacitorPlugin。結果はcall.resolve())、アプリ本体での登録の 3 か所がそろって初めて JS から呼べる
React Native・Flutter との違い
違いは「画面を誰が描画するか」に集約される。
| ツール | 描画 | 強み | 注意点 |
|---|---|---|---|
| Capacitor | WebView 上で Web として描画 | Web 資産とスキルをほぼそのまま活かせる。導入の手間が最小 | 複雑な 3D、高頻度の再描画、重いアニメーションに不向き |
| React Native | JS からネイティブ UI コンポーネントを操作 | 見た目と操作感がネイティブに近い | React 前提。DOM・CSS のコードはそのまま再利用できない |
| Flutter | 独自エンジン(iOS・Android は Impeller)で直接描画 | OS をまたいで UI が一貫、性能も高い | Dart の習得が必要 |
既存の Web アプリ(SaaS・EC・社内ツール)を素早くストアに出したい、Web フロントエンドのチームだけで保守したい、画面がフォーム・一覧・CRUD 中心、という場合に向く。
開発の流れ
npm install @capacitor/core @capacitor/cli→npx cap init(アプリ名と逆ドメイン形式のアプリ ID。webDirを Web ビルドの出力先に合わせる)npx cap add android/npx cap add ios(生成物はコミットする)npm run build→npx cap syncで Web アセットとプラグインを反映npx cap open ios|androidで IDE を開く、またはnpx cap runで直接起動
日常は「ブラウザで 8 割、シミュレーターで 2 割」。Vite の開発サーバーで UI を作り込み、ネイティブ API が絡む部分だけシミュレーターで確かめる。npx cap run ios --live-reload --port 5173 なら実機でもホットリロードでき、書き換えた設定は終了時に戻るのでストア版に紛れ込まない。WebView の中は iOS なら Mac の Safari の Web インスペクタ、Android なら chrome://inspect で調べる。
Capacitor 8(2025 年 12 月公開)の主な変更
- iOS の新規プロジェクトは CocoaPods ではなく Swift Package Manager が既定(
--packagemanager CocoaPodsで従来構成) - Android の edge-to-edge 対応としてコアプラグイン System Bars を追加し、余白は CSS 変数で扱う
- 要件は Node.js 22 以上、Xcode 26.0 以上、iOS 15.0、Android
minSdkVersion24・targetSdkVersion36
ストア公開までに用意するもの
- ディープリンク:
@capacitor/appのappUrlOpenで URL を受けてルーティング。iOS はapple-app-site-associationと Associated Domains、Android はassetlinks.jsonと intent filter - プッシュ通知:
@capacitor/push-notifications。Android は FCM、iOS は APNs のトークンが返る(FCM に一本化するなら iOS にも Firebase SDK を入れる)。実行時の許可も要る - アイコンとスプラッシュ:
@capacitor/assetsで元画像 1 枚ずつから全サイズを生成 - 環境の切り替え: バンドル ID と表示名は Xcode のターゲット・Gradle の flavor で決まる。
capacitor.config.tsからはios.scheme/android.flavorを切り替える - プライバシーの申告: App Store は Privacy Manifest(Required Reason API の理由)、Google Play はデータセーフティのフォーム。プラグインも対象
実運用での注意点
- 「Web サイトを包んだだけ」は審査で落ちうる: App Review Guidelines 4.2 は再パッケージした Web サイトを超える機能を求める。プッシュ通知・オフライン動作・端末連携などアプリにする理由を持たせる
- オリジンが変わる: WebView のオリジンは iOS が
capacitor://localhost、Android がhttps://localhost。サーバーの CORS で許可するか、CapacitorHttpでネイティブ通信に置き換える - 保存先:
localStorageは OS に消されうる。@capacitor/preferencesは暗号化されないので、トークンや鍵は Keychain / Keystore 系のプラグインかメモリーに置く。独自 URL スキームでトークンを受け渡さない。OAuth は PKCE 必須 - バックグラウンドでは JS が止まる: iOS では
setIntervalが当てにならない。経過時間は開始時刻からの差分で計算する
CI(GitHub Actions)
Web(ubuntu-latest)、Android(ubuntu-latest + JDK 21、Gradle)、iOS(macos-latest、xcodebuild)の 3 ジョブに分ける。iOS はシミュレーター向けに CODE_SIGNING_ALLOWED=NO でビルドすれば証明書不要。SPM 構成は -project ios/App/App.xcodeproj、CocoaPods 構成は -workspace。iOS テンプレートにはテストターゲットが入っていないので、ネイティブをテストするなら Unit Testing Bundle を追加する。
Live Updates(OTA 更新)
Web 層(HTML・CSS・JS)だけをサーバーから配信して差し替え、審査を通さずに修正を届けられる。ネイティブ側(Swift / Kotlin、プラグインの追加・更新、権限の変更)はストアのリリースが必要で、Web バンドルとインストール済みネイティブ部分の組み合わせが設計の要。Apple・Google とも WebView で動く JavaScript は条件付きで認めているが、実務上はバグ修正や小さな改善にとどめ、別のアプリに変えない。
手段は Capgo(OSS、セルフホスト可)、Capawesome Cloud、Codemagic Patch など。Ionic Appflow は 2027 年 12 月 31 日でサービス終了、Microsoft の CodePush も App Center 終了で使えない。導入前に互換性の振り分け、ロールバック、バンドル署名による改ざん対策を決めておく。
関連ページ
- GitHub Actions のセキュリティ — CI で署名鍵などのシークレットを扱う際の注意
- JWT Bearer Grant — モバイルの認証・トークン発行に関わる仕組み
- Git —
ios/・android/をソースとして管理する前提 - Tauri — デスクトップで同じ WebView 方式をとるフレームワーク
- GPUI — WebView を使わず GPU で直接描画する、反対側のアプローチ
ソース記事
- Capacitor 入門:Web アプリをそのまま iOS・Android アプリにする仕組みと手順 — 2026-11-09