本文へスキップ
hdknr blog

Capacitor

Ionic チームの OSS ランタイム。Web アプリを WebView ごと iOS・Android のネイティブアプリに包み、端末機能はプラグイン経由で呼ぶ。ネイティブプロジェクトを Git 管理のソースとして扱うのが Cordova との違い

概要

Capacitor は、HTML・CSS・JavaScript / TypeScript で書いた Web アプリを、iOS・Android のネイティブアプリとして動かすオープンソースのランタイム。開発元は Ionic チームで、Apache Cordova の課題を踏まえて別プロジェクトとして作られた(Cordova からの移行ガイドあり)。同じコードを Web(PWA)としても配信できる。

アプリの実体はネイティブアプリに埋め込まれた WebView。Web で作った画面がほぼそのまま動くのが最大の利点で、同時に描画性能面の制約の出どころでもある。

詳細

仕組みと特徴

React Native・Flutter との違い

違いは「画面を誰が描画するか」に集約される。

ツール描画強み注意点
CapacitorWebView 上で Web として描画Web 資産とスキルをほぼそのまま活かせる。導入の手間が最小複雑な 3D、高頻度の再描画、重いアニメーションに不向き
React NativeJS からネイティブ UI コンポーネントを操作見た目と操作感がネイティブに近いReact 前提。DOM・CSS のコードはそのまま再利用できない
Flutter独自エンジン(iOS・Android は Impeller)で直接描画OS をまたいで UI が一貫、性能も高いDart の習得が必要

既存の Web アプリ(SaaS・EC・社内ツール)を素早くストアに出したい、Web フロントエンドのチームだけで保守したい、画面がフォーム・一覧・CRUD 中心、という場合に向く。

開発の流れ

  1. npm install @capacitor/core @capacitor/cli → npx cap init(アプリ名と逆ドメイン形式のアプリ ID。webDir を Web ビルドの出力先に合わせる)
  2. npx cap add android / npx cap add ios(生成物はコミットする)
  3. npm run build → npx cap sync で Web アセットとプラグインを反映
  4. 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 月公開)の主な変更

ストア公開までに用意するもの

実運用での注意点

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 終了で使えない。導入前に互換性の振り分け、ロールバック、バンドル署名による改ざん対策を決めておく。

関連ページ

ソース記事