---
title: "flutter_inappwebviewとは？使い方とJS連携・Cookie、6.1.5がFlutter 3.47で止まる箇所"
url: "https://www.issoh.co.jp/tech/details/16739/"
published: 2026-08-19
updated: 2026-10-18
categories: ["Flutter"]
publisher: "株式会社一創"
---

# flutter\_inappwebviewとは？使い方とJS連携・Cookie、6.1.5がFlutter 3.47で止まる箇所

flutter\_inappwebviewは、Flutterアプリの中にWebページを埋め込み、読み込み・通信・JavaScriptをFlutter側から細かく制御するためのパッケージです。2026年10月18日時点の安定版は6.1.5で、2024年10月9日（日本時間）の公開から約2年更新されていません。その間にFlutter本体は3.47系まで進み、新規プロジェクトの土台が変わりました。本記事では表示形態と導入、callHandlerによるJavaScript連携、Cookieの引き継ぎを解析とビルドまで通したコードで示したうえで、Flutter 3.47.7で6.1.5を実際にビルドして見えた問題と、公式webview\_flutterとの選び分けを整理します。

## まとめ：6.1.5採用前のFlutterバージョンとビルド環境の固定

このパッケージを選ぶ理由になるのは、公式のwebview\_flutterに無い機能が要るかどうかです。callHandlerによるPromiseベースの往復通信、リソースの横取り、画面に出さないHeadlessInAppWebViewが要るなら候補になります。JavaScriptとの単純なやり取りはwebview\_flutterでもでき、利用規約やヘルプを表示するだけなら公式で足ります。

採用するなら、先に版の問題を片づけてください。Flutter 3.47系の新規プロジェクトはAndroid Gradle Plugin（AGP）9.1.0で生成され、安定版6.1.5のAndroid実装はAGP 9でビルドが止まります。iOSでは非公開クラス名の参照で審査を落とされた報告があり、Swift Package Manager（SPM）にも対応していません。3つとも6.2.0-beta.3で直っていますが、beta.3はFlutter 3.32以上を求めるprereleaseです。「6.1.5のままAGPを8系に据え置く」か「beta.3を版固定で採る」かを案件の開始時に決め、引き継ぎ資料へ残してください。

## flutter\_inappwebviewが提供する4つの表示形態と対応プラットフォーム

入り口は4つあり、どれを選ぶかでFlutter側から届く制御の深さと画面の見え方が変わります。

### InAppWebViewとHeadlessInAppWebViewの役割

InAppWebViewは、ウィジェットツリーの中に置く埋め込み型のWebViewです。上部に自前のツールバー、下部にネイティブのボタンを並べる画面が作れます。読み込みの開始・終了・進行度・エラーはイベントとしてFlutter側へ流れます。

HeadlessInAppWebViewは画面に出さないWebViewです。表示を伴わずにページを読み込み、JavaScriptを実行して結果だけ受け取ります。裏でログインを走らせてCookieを取る、ページのDOMから値を拾う、といった用途です。ユーザーには何も見えないので、通信の失敗を伝える経路は別に用意してください。

### InAppBrowserとChromeSafariBrowserの違い（in-app browserとWebView）

InAppBrowserは、アプリの上に別ウィンドウとしてWebViewを開く形態です。アドレスバーや進む・戻るを備えた画面が最初から用意され、制御の深さはInAppWebViewとほぼ同じです。中身はあくまでWebViewなので、ページへのスクリプト注入や読み込みの横取りもできます。

ChromeSafariBrowserは、AndroidのCustom Tabs、iOSのSFSafariViewControllerを呼び出す形態で、ここだけ性質が違います。表示するのはシステムのブラウザ部品で、アプリからページの中身には触れません。Androidの[Custom Tabs](https://developer.chrome.com/docs/android/custom-tabs)は既定ブラウザとCookieやログイン状態を共有します。一方、Appleの[SFSafariViewControllerの説明](https://developer.apple.com/documentation/safariservices/sfsafariviewcontroller)は、アプリからWebサイトのデータに触れられないことを明記し、Safariとデータを共有したい場合はASWebAuthenticationSessionを使うよう案内しています。決済やOAuthの同意画面のように、アプリが介入すべきでない画面はChromeSafariBrowserへ回します。

### プラットフォームごとの土台と最低条件

6.1.5の対応はAndroid・iOS・macOS・Windows・Webの5つで、Linuxは6.2.0-beta.3からです。土台はプラットフォームごとに違い、AndroidはシステムのWebView、iOSとmacOSはWKWebView、WindowsはWebView2、Webではiframeを使います。同じDartのコードでも、使えるAPIと挙動は土台に引きずられます。

[公式のGetting Started](https://inappwebview.dev/docs/intro)が示す6.x系の要件は、AndroidがminSdkVersion 19・compileSdk 34以上・AGP 7.3.0以上、iOSが12.0以上でXcode 15.0以上、macOSが10.14以上です。Web向けビルドの制約は[Flutter Webとは？CanvasKitとWasmの描画差・SEO制約・採用条件](/tech/details/16727/)と合わせて判断してください。

## flutter\_inappwebviewの導入と最小構成

ここからのコードは、Flutter 3.47.7（Dart 3.13.5）で`flutter create`した新規プロジェクトに6.1.5を入れ、`flutter analyze`で指摘0件、`flutter build web`の成功までを確認したものです。実機・エミュレーターでのJavaScript通信とCookieの動作は確認していないため、端末のWebViewの版ごとに必ず動かして確かめてください。

### pubspec.yamlへの追加と解決される依存パッケージ

依存は版を固定して書き、`pubspec.lock`もリポジトリで管理します。キャレット指定（`^6.1.5`）でも現状は同じ版に解決されますが、6.2系の安定版が出れば要求するFlutterが変わる可能性があります（beta.3は3.32以上）。固定しておけば、検証していない版へ勝手に上がる事故を防げます。

```
dependencies:
  flutter:
    sdk: flutter
  flutter_inappwebview: 6.1.5

flutter:
  assets:
    - assets/bridge.html
```

`flutter pub add flutter_inappwebview:6.1.5`を実行すると、プラットフォーム別の実装パッケージがまとめて入ります。今回の解決結果は、Android実装1.1.3、iOS実装1.1.2、macOS実装1.1.2、Web実装1.1.2、Windows実装0.6.0、共通インターフェース1.3.0+1でした。後の章で触れる不具合は、この実装パッケージ側の版で決まります。

### InAppWebViewを置く最小コード

アセットのHTMLを読み込み、進行度をバーで出し、JavaScriptから呼べるハンドラを1つ登録する構成です。`useShouldOverrideUrlLoading`は、InAppWebViewでコールバックを実装し、値を未指定にすると自動で有効になります。一方、Androidで`target="_blank"`のリンクを拾うには`supportMultipleWindows`を`true`にしたうえで`onCreateWindow`の実装が要ります（supportMultipleWindowsの既定値はfalseです）。

```
import 'package:flutter/material.dart';
import 'package:flutter_inappwebview/flutter_inappwebview.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MaterialApp(home: WebPage()));
}

class WebPage extends StatefulWidget {
  const WebPage({super.key});

  @override
  State<WebPage> createState() => _WebPageState();
}

class _WebPageState extends State<WebPage> {
  InAppWebViewController? _controller;
  double _progress = 0;

  final _settings = InAppWebViewSettings(
    javaScriptEnabled: true,
    useShouldOverrideUrlLoading: true,
    supportMultipleWindows: true,
  );

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('InAppWebView')),
      body: Column(
        children: [
          if (_progress < 1) LinearProgressIndicator(value: _progress),
          Expanded(
            child: InAppWebView(
              initialFile: 'assets/bridge.html',
              initialSettings: _settings,
              onWebViewCreated: (controller) {
                _controller = controller;
                controller.addJavaScriptHandler(
                  handlerName: 'getUser',
                  callback: (args) {
                    return {'id': 42, 'name': 'issoh', 'requested': args};
                  },
                );
              },
              onProgressChanged: (controller, progress) {
                setState(() => _progress = progress / 100);
              },
              shouldOverrideUrlLoading: (controller, action) async {
                final uri = action.request.url;
                if (uri != null && !['http', 'https', 'file'].contains(uri.scheme)) {
                  return NavigationActionPolicy.CANCEL;
                }
                return NavigationActionPolicy.ALLOW;
              },
              onCreateWindow: (controller, createWindowAction) async {
                final url = createWindowAction.request.url;
                if (url != null) {
                  await controller.loadUrl(urlRequest: URLRequest(url: url));
                }
                return false;
              },
            ),
          ),
        ],
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () async {
          final title = await _controller?.evaluateJavascript(source: 'document.title');
          debugPrint('title=$title');
        },
        child: const Icon(Icons.code),
      ),
    );
  }
}
```

`onCreateWindow`で`false`を返し、同じWebViewで開き直しています。別画面で開きたいなら、ここで新しいルートを積んで`createWindowAction.windowId`を渡し、`true`を返します。

### AndroidとiOSで追加する設定

Flutter 3.47.7のテンプレートでは、Androidの`INTERNET`権限が`android/app/src/debug/AndroidManifest.xml`と`android/app/src/profile/AndroidManifest.xml`に書かれ、mainには書かれていません。デバッグでは表示できたのにリリースビルドで真っ白になる場合は、まず`src/main/AndroidManifest.xml`への権限の追記漏れを疑ってください。iOSでhttpのページを開くなら、Info.plistのApp Transport Securityで対象ドメインだけを許可します。Android 11以降でChromeSafariBrowserを使う場合は、マニフェストの`queries`にCustom Tabsサービスを宣言する必要があります。

## Flutter 3.47.7で6.1.5を使うときに起きる3つの問題

6.0〜6.1系が出た2023〜2024年に書かれた使い方の解説は、当時のFlutterを前提にしています。その後にFlutter本体の既定値が変わり、6.1.5の実装パッケージは追随していません。古い手順を参考にするときは、今のFlutterとビルドツールで通るかを確かめてください。

### Android：AGP 9.1.0のテンプレートでビルドが止まる

Flutter 3.47.7の`flutter create`は、`android/settings.gradle.kts`にAGP 9.1.0とKotlin 2.4.0を、`android/gradle/wrapper/gradle-wrapper.properties`にGradle 9.3.1を書き込みます。このプロジェクトに6.1.5を入れて`flutter build apk --debug`を実行すると、Android実装1.1.3の`build.gradle`を評価する段階で失敗しました。

```
Build file '$PUB_CACHE/hosted/pub.dev/flutter_inappwebview_android-1.1.3/android/build.gradle' line: 44

* What went wrong:
A problem occurred evaluating project ':flutter_inappwebview_android'.
> `getDefaultProguardFile('proguard-android.txt')` is no longer supported since it includes `-dontoptimize`, which prevents R8 from performing many optimizations.
```

原因は、Android実装が`getDefaultProguardFile('proguard-android.txt')`を指定していることです。AGP 9はR8の最適化を止めるこのファイルを受け付けません。同じ報告は[issue #2765](https://github.com/pichillilorenzo/flutter%5Finappwebview/issues/2765)にあり、2026年1月に6.2.0-beta.3側で修正されています。

回避策は2通り試し、どちらもAPKの生成まで通りました。1つは依存を`6.2.0-beta.3`へ上げる方法で、AGP 9.1.0のままAndroid実装1.2.0-beta.3が入りビルドが通ります。もう1つは`settings.gradle.kts`のAGPを8.13.0へ下げる方法で、Gradle本体は9.3.1のままでもビルドできました。ただし後者ではFlutterが「AGP 8.13.0のサポートは近く打ち切る。9.0.1以上へ上げるように」という警告を出します。AGPの据え置きは、beta.3か次の安定版へ移るまでのつなぎと考えてください。

### iOS：PGHostedWindowの参照で審査リジェクトの報告

2025年12月、Flutter 3.35系でビルドしたアプリがApp StoreのGuideline 2.5.1（非公開APIの使用）で却下された報告が[issue #2754](https://github.com/pichillilorenzo/flutter%5Finappwebview/issues/2754)に上がりました。Appleが指摘したのは`flutter_inappwebview_ios.framework`内の`PGHostedWindow`というクラス名です。

iOS実装1.1.2のソースを見ると、`InAppWebView.swift`の動画全画面判定で、`NSClassFromString`に渡す文字列として`"PGHostedWindow"`を持っています。6.2.0-beta.3ではこの判定が書き直され、ソースのコメントにも「審査リジェクトを避けるため非公開クラス名を使わない」旨とissue番号が残っています。同じissueでは`__SwiftValue`も指摘されていますが、こちらはFirebase Apple SDK 12.8.0（2026年1月13日公開）で修正済みで、このパッケージだけの問題ではありません。iOSで配信するなら、審査提出前にbeta.3へ上げるか、ビルド成果物から`strings`で該当文字列が残っていないかを確かめてください。

### iOS・macOS：SPM非対応でCocoaPodsを外せない

[Flutterの公式ドキュメント](https://docs.flutter.dev/packages-and-plugins/swift-package-manager/for-app-developers)は、3.44からSPM対応を既定で有効にし、SPMに対応していない依存にはCocoaPodsへフォールバックすると説明しています。iOS実装1.1.2にはPackage.swiftがなく、podspecだけを持ちます。依存先も`OrderedSet`というCocoaPodsのpodです。つまり6.1.5を入れている限り、プロジェクトからCocoaPodsは外せません。

beta.3のiOS実装1.2.0-beta.3はPackage.swiftを持ち、依存もAppleの`swift-collections`へ置き換わっています。CocoaPodsの公開リポジトリ（trunk）は2026年12月2日に読み取り専用になる予定で、既存のpodが取れなくなるわけではありません。ただ移行の流れは止まらないので、CocoaPods依存を残す期間は[CocoaPodsとは？1.17.0の使い方とpod install、2026年12月の読み取り専用化への備え](/tech/details/12417/)を参考に見積もってください。SPMの既定化そのものは[Flutter 3.44とは？SPM既定化とHCPPで変わる移行判断](/tech/details/15767/)で扱っています。

## 6.1.5と6.2.0-beta.3の版の判断

2026年10月18日にGitHubのAPIで確認した時点で、既定ブランチ（master）の最新コミットは2026年2月10日でした。同じ時点で未解決のissueは129件、未マージのプルリクエストは88件あり、6月以降も新しいissueが31件立っています。報告は続いているのにコードが動いていない状態で、安定版とbeta版のどちらを取っても、上流の修正を待つ前提は置けません。

### 安定版6.1.5と6.2.0-beta.3の要求条件

| 項目               | 6.1.5（安定版）       | 6.2.0-beta.3  |
| ---------------- | ---------------- | ------------- |
| 公開日（日本時間）        | 2024年10月9日       | 2026年2月4日     |
| 要求Dart／Flutter   | ^3.5.0／3.24以上    | ^3.8.0／3.32以上 |
| Linux            | 非対応              | 対応            |
| AGP 9            | ビルド不可            | 修正済み（#2765）   |
| iOSのSPM          | 非対応（CocoaPodsのみ） | 対応            |
| PGHostedWindow参照 | あり               | 削除済み          |

公開日と要求条件は[pub.devの版一覧](https://pub.dev/packages/flutter%5Finappwebview/versions)と各版のCHANGELOGによります。

### beta系にしかないAPIと既定値の変更

ネット上のサンプルには、6.1.5では存在しないAPIが混ざっています。`javaScriptBridgeEnabled`などブリッジの許可範囲を絞る設定群と、ブリッジ名を変える`setJavaScriptBridgeName`は、6.2.0-beta.1（共通インターフェース1.4.0-beta.1）で追加されたものです。6.1.5の環境で両方を書いて`flutter analyze`にかけると、「名前付き引数が未定義」「メソッドが未定義」のエラーになりました。Windowsではbeta.1でスクロール量の`scrollMultiplier`の既定値も6から1へ変わっています。

Ajaxの横取りで同期リクエストを対象外にする`interceptOnlyAsyncAjaxRequests`（既定値`true`）は、6.0.0-beta.32の破壊的変更として入ったもので、6.1.5でも既定で有効です。`useShouldInterceptAjaxRequest`で同期のXMLHttpRequestも対象にする場合は、この値を`false`にします。ただしFlutterとの非同期通信によりsend()が応答を待たなくなるため、同期実行を前提としたページの処理は壊れる可能性があります。5.x系から上げる案件では、ここが最初の確認箇所です。

### 6.2.0-beta.3を本番の受託案件に載せる条件

beta.3を選んでよいのは、次の3つが揃うときだと考えます。案件のFlutterが3.32以上で固定されていること。AGP 9・iOSの審査対応・SPMのいずれかが要件上避けられないこと。そして、beta.4以降で破壊的変更が入っても追随できる保守契約があることです。prereleaseは`pubspec.yaml`で版を明示しないと解決されないため、版固定の理由を引き継ぎ資料に書いてください。SDKの版をプロジェクト単位で固定する運用は[FVMとは？Flutter SDKをプロジェクト単位で固定する運用とCI設定](/tech/details/16731/)で扱っています。

逆に、納品後の改修予定がない一括請負でbeta.3を選ぶのは避けたほうが無難です。安定版のままにするなら、Androidの`settings.gradle.kts`でAGPを8系に据え置く必要があり、Flutter本体の更新もその範囲に縛られます。

## addJavaScriptHandlerとcallHandlerによるJavaScript連携

Flutterと埋め込みページの双方向通信が、このパッケージが選ばれる理由の中心です。手順は短いのですが、登録の位置と初期化の待ち合わせを外すと呼び出しが届きません。

### Dart側：onWebViewCreatedでのハンドラ登録

前章の最小コードでは、`onWebViewCreated`の中で`addJavaScriptHandler`に`getUser`という名前とコールバックを渡しています。ページの読み込み後に登録すると、その時点で走り終えたスクリプトからは呼べないため、WebViewの生成直後に登録します。コールバックの戻り値はJSONに変換されてJavaScriptへ返るので、返せるのはMapやList、文字列・数値などJSONで表せる値だけです。日時や金額は文字列か数値へ落とす形式を先に決めておくと、取り違えが減ります。

### JavaScript側：callHandlerのPromiseと初期化イベント

ページ側は`window.flutter_inappwebview.callHandler(ハンドラ名, ...引数)`で呼び、戻りのPromiseで結果を受け取ります。[公式のJavaScript通信の説明](https://inappwebview.dev/docs/webview/javascript/communication)によると、Androidで`WebViewFeature.DOCUMENT_START_SCRIPT`に対応していない端末では、読み込みの最初の時点でブリッジがまだ差し込まれていません。その場合は`flutterInAppWebViewPlatformReady`イベントの発火を待ってから呼びます。次のHTMLは、ブリッジがあれば即座に、なければイベントを待って呼ぶ形です。

```
<!DOCTYPE html>
<html>
<head><meta charset="utf-8"><title>bridge</title></head>
<body>
<p id="out">waiting</p>
<script>
  function start() {
    window.flutter_inappwebview.callHandler('getUser', 'profile')
      .then(function (user) {
        document.getElementById('out').textContent = user.name + ' / ' + user.id;
      });
  }
  if (window.flutter_inappwebview && window.flutter_inappwebview.callHandler) {
    start();
  } else {
    window.addEventListener('flutterInAppWebViewPlatformReady', start);
  }
</script>
</body>
</html>
```

ページのソースを編集できない場合でも、[UserScript](https://inappwebview.dev/docs/webview/javascript/user-scripts/)（`initialUserScripts`）でこの待ち合わせと呼び出しのコードを注入できます。ただし他社が管理するページへの注入は、相手の仕様変更でいつでも壊れます。双方向通信まで行う要件は、着手前にページ側の管理者と連携の可否と変更時の連絡を取り決めてください。

## CookieによるWebViewへのログイン状態の引き継ぎ

アプリのログイン状態をWebViewへ渡す場合は、Web側が受け付けるセッションCookieを用意し、setCookieの完了と成功を確認してから対象ページを読み込みます。CookieManagerで直接書き込めますが、プラットフォームによって使えるメソッドが違います。

### CookieManagerのsetCookieとgetCookies

Cookieの操作は`CookieManager.instance()`で取り出した共有インスタンスで行います。`setCookie`はURL・名前・値のほか、期限、Secure、HttpOnly、SameSiteを指定できます。読み出しはURL単位の`getCookies`、名前で絞る`getCookie`、削除は`deleteCookie`・`deleteCookies`・`deleteAllCookies`です。

```
import 'package:flutter/foundation.dart';
import 'package:flutter_inappwebview/flutter_inappwebview.dart';

Future<void> passLoginCookie(String sessionId) async {
  final cookieManager = CookieManager.instance();
  final url = WebUri('https://example.com/');
  await cookieManager.setCookie(
    url: url,
    name: 'session_id',
    value: sessionId,
    isSecure: true,
    isHttpOnly: true,
    sameSite: HTTPCookieSameSitePolicy.LAX,
  );
  final cookies = await cookieManager.getCookies(url: url);
  debugPrint('cookies=${cookies.map((c) => c.name).toList()}');
}
```

Windowsで独自のWebView環境を使う場合は、`CookieManager.instance(webViewEnvironment: env)`のように環境を渡します。渡したときは共有インスタンスではなく、その環境専用のインスタンスが毎回作られます。渡し忘れると既定の環境を見に行き、設定したはずのCookieが読めません。

### JavaScript実装へ落ちる環境とHttpOnly

公式ドキュメントは、iOS 11未満・macOS 10.13・Web向けビルドでは、Cookie操作のほとんどがJavaScriptで実装されていると明記しています。このうち`deleteAllCookies`と`getAllCookies`は使えません。JavaScript経由ではHttpOnlyのCookieに手が届かないため、セッションIDにHttpOnlyを付けるサーバーでは読み取りが空になります。6.1.5の下限はiOS 12.0なので、iOSでこの分岐に当たることは実質なく、影響が残るのはWeb向けビルドです。

### トークンの置き場所とヘッダで渡す方式

元になる認証情報をアプリ側のどこに置くかは別の問題で、平文で持ち回ると端末を解析された時点で成りすましが成立します。保管先は[flutter\_secure\_storageとは？11.0系の暗号方式とトークン保存の判断](/tech/details/16735/)の基準で決めてください。

もう1つは、初回の`URLRequest`の`headers`に認証情報を載せる方式です。認証ヘッダの指定自体はCookieを作りませんが、応答のSet-CookieによってCookieが保存されることはあります。初回に付けたヘッダが後続リクエストへ自動継承される前提は置かず、サーバー側のセッション方式と合わせて設計します。

## webview\_flutterと選び分ける基準

「公式は機能が少ない」という前提は、2026年10月時点の公式パッケージには一律に当てはまりません。

### webview\_flutter 4.14系が埋めた機能

webview\_flutterの最新は2026年7月8日（日本時間）公開の4.14.1で、要求はFlutter 3.38・Dart 3.10以上です。[4.14.0のCHANGELOG](https://pub.dev/packages/webview%5Fflutter/changelog)で`WebViewCookieManager.getCookies`が追加され、Cookieの読み出しもできるようになりました。「公式ではCookieを読めない」と書いた比較記事は古くなっています。対応OSはAndroid SDK 24以上、iOS 13.0以上、macOS 10.15以上の3つです。表示と読み込み制御、Cookieの読み書きで要件が閉じるなら公式で足ります。

### postMessageとcallHandlerで変わる双方向通信

差が残るのはJavaScript連携の方式です。公式の`addJavaScriptChannel`は、チャンネル名と受信コールバックを登録する片方向の仕組みで、ページ側は`Print.postMessage('Hello')`のように文字列を送るだけで戻り値はありません。返答が要るなら、Dart側からスクリプトを実行して結果を書き戻す処理を自分で組みます。callHandlerはPromiseで結果が返るので、「呼んで、待って、受け取る」流れをそのまま書けます。React Nativeで同じ連携を組む場合は[react-native-webviewとは？postMessage連携と版が三つに割れた導入判断](/tech/details/16749/)を参照してください。

### 対応範囲と更新頻度の比較

| 比較軸                   | flutter\_inappwebview         | webview\_flutter  |
| --------------------- | ----------------------------- | ----------------- |
| 最新安定版                 | 6.1.5（2024年10月）               | 4.14.1（2026年7月）   |
| publisher             | inappwebview.dev              | flutter.dev       |
| pub points            | 130／160                       | 160／160           |
| 直近30日のDL数             | 約123万                         | 約374万             |
| 対応OS                  | Android・iOS・macOS・Windows・Web | Android・iOS・macOS |
| JS双方向                 | Promiseで戻り値                   | 戻り値なし             |
| Flutter 3.47の新規プロジェクト | Androidは要AGP調整                | そのまま              |

pub pointsとDL数は、2026年10月18日にpub.devのAPI（`/api/packages/パッケージ名/score`の`grantedPoints`と、直近30日の`downloadCount30Days`）で取得した値で、日々変わります。flutter\_inappwebviewの減点30点は、静的解析の指摘61件（20点）とLinux非対応（10点）でした。WindowsかWebを含むか、callHandlerのPromiseでDart側の返答を受けたいか。どちらかに当てはまるか、読み込みの横取りやHeadlessInAppWebViewまで要るならflutter\_inappwebview、どれも要らなければ公式です。

## flutter\_inappwebviewを採用しない判断が正しくなる場面

機能の多いパッケージは要件に対して過剰になりやすく、あえて選ばないほうが総コストの下がる場面があります。

### Webページを表示するだけの画面

利用規約やヘルプセンターのように、表示して戻るだけの画面しかないなら公式のwebview\_flutterで完結します。ここでflutter\_inappwebviewを選ぶと、使わない設定とイベントの分だけコードが読みにくくなり、約2年更新の止まった依存と前章のAGP調整を抱え込みます。目安は、webview\_flutterのJavaScript実行や読み込み制御では満たせないAPIが必要かどうかです。

### 既存Webシステムを包んでアプリ化する設計

既存のWebシステムをWebViewで包む設計は、初期の見積もりが小さく出ます。ただし、プッシュ通知からの画面遷移、オフライン時の表示、戻る操作とページ履歴の整合、ファイルの送受信は、いずれもWebView側で個別に組む作業です。埋め込むWebシステムが更新されるたびにアプリの確認も発生します。どこまでをWebに任せるかの線引きに迷う場合は、[Flutter / React Native開発](/service/apps/cross%5Fplatform/)の設計段階の相談としてご検討ください。Flutter自体を選び続けてよいかは[Flutterの将来性を数値で判断する｜リリース実績・国内案件数・競合の現在地](/tech/details/16721/)で整理しています。

## よくある質問

### flutter\_inappwebviewは商用のアプリで無料で使えますか？

Apache License 2.0で公開されているオープンソースのパッケージで、商用利用に費用はかかりません。配布物にライセンス表記を含める義務があるので、アプリのライセンス画面に載っているかを納品前に確認してください。

### 安定版が約2年更新されていないのは危険な兆候ですか？

更新の停止そのものより、Flutter本体の変化に追随していない点が実害になります。Flutter 3.47系ではAndroidのAGP 9でビルドが止まり、iOSでは審査で指摘された参照が残っています。案件のFlutterとAGPの版で実際にビルドと審査提出まで通るかを先に確かめ、通らなければbeta.3か公式パッケージへ切り替えます。

### webview\_flutterから乗り換えるときの作業量はどれくらいですか？

表示だけの画面なら、ウィジェットの置き換えとイベント名の対応付けで済みます。手間がかかるのはJavaScript連携で、postMessageの片方向の作りをcallHandlerの往復へ組み替える設計変更が入ります。埋め込むページ側の書き換えも見積もりに含めてください。

### Flutter 3.47で6.1.5のAndroidビルドが失敗したときはどうすればよいですか？

AGPを8系へ下げるか、6.2.0-beta.3へ上げるかの二択です。下げる場合は`android/settings.gradle.kts`の`com.android.application`の版を8.13.0などへ書き換えます。Flutterからサポート終了予定の警告が出るので、一時しのぎと考えてください。上げる場合はFlutter 3.32以上が前提になります。

### Web向けビルドでも同じように動きますか？

Flutter 3.47.7では、6.1.5を入れたアプリの`flutter build web`も`--wasm`付きのビルドも通りました。ただしWebでは中身がiframeになり、6.1.5ではJavaScriptハンドラが使えません（Webへの実装は6.2.0-beta.3から）。Cookie操作もJavaScript実装になり、`deleteAllCookies`と`getAllCookies`は使えません。`web/index.html`へ`web_support.js`を読み込む設定も必要です。

## 関連記事

- [flutter\_secure\_storageとは？11.0系の暗号方式とトークン保存の判断](/tech/details/16735/)
- [Flutter 3.47とは？material\_ui移行・iOS 15と3.47.7までの修正](/tech/details/16894/)
- [Flutterの環境構築｜Windows・macOS別のSDK導入とflutter doctor診断](/tech/details/16729/)
- [Flutter Webとは？CanvasKitとWasmの描画差・SEO制約・採用条件](/tech/details/16727/)
- [react-native-webviewとは？postMessage連携と版が三つに割れた導入判断](/tech/details/16749/)

---

出典: [flutter\_inappwebviewとは？使い方とJS連携・Cookie、6.1.5がFlutter 3.47で止まる箇所](<https://www.issoh.co.jp/tech/details/16739/>)（株式会社一創）
