Skip to content

アプリ内ブラウザ ​

AdvancedInAppBrowser は、ツールバー付きの全画面ネイティブブラウザを Flutter の UI の上に開きます。 自前の画面から離れたいが、アプリからは出したくないリンクに使います。

dart
final browser = AdvancedInAppBrowser(
  onOpened: () => debugPrint('opened'),
  onClosed: () => debugPrint('closed'),
  onPageFinished: (url) => debugPrint('loaded $url'),
  onLoadError: (error) => debugPrint('failed: $error'),
);

await browser.open(
  Uri.parse('https://example.com'),
  options: const InAppBrowserOptions(
    toolbarColor: Color(0xFF1E3A8A),
    showUrl: true,
  ),
);

// あとで:
await browser.close();

オプション ​

オプション既定値意味
toolbarColorプラットフォーム既定ツールバーの背景色。タイトルとボタンは読みやすいように黒か白になります。
toolbarTitleページのタイトル現在のページのタイトルの代わりに表示する固定タイトル。
showUrlfalseタイトルの下に現在の URL を表示します。
showNavigationButtonstrue戻る・進む・再読み込みのボタンを表示します。
closeButtonLabelアイコンプラットフォームの閉じるアイコンの代わりに使うテキスト。
settingsWebViewSettings()ブラウザ内 WebView の設定(android: / ios: を含む)。

動作 ​

  • 1つの AdvancedInAppBrowser が同時に表示できるブラウザは1つです。開いている間の open は StateError を投げます。onClosed のあとは再度開けます。
  • ブラウザは専用の WebView を持ちます。開いている間は loadUrl と evaluateJavaScript が使え、 閉じている間は StateError になります。
  • onLoadError はメインページの失敗だけを通知し、画像やスクリプトの失敗は通知しません。
  • 表示できる画面がない場合(アプリがバックグラウンドのときなど)、open は PlatformException(not-attached)で失敗します。

違い ​

  • Android は専用の Activity を表示します。戻るボタンはまずページ履歴を戻り、戻れないときにブラウザを閉じます。 権限ダイアログとファイル選択はブラウザの前面に表示されます。
  • iOS は UINavigationController をモーダルで表示します。戻る・進む・再読み込みは下部のツールバー、 閉じるボタンはナビゲーションバーの左側にあります。
  • Android では Cookie が他の WebView と共有されます。iOS では WebViewSettings.incognito で ブラウザのウェブサイトデータを分離できます。

内部で使うネイティブ API は プラットフォーム API 対応表 を参照してください。

システムブラウザ ​

AdvancedSystemBrowser は、このプラグインの WebView ではなく、システム標準のブラウザ UI でページを開きます。 Android は Chrome Custom Tabs、iOS は SFSafariViewController です。ページはユーザーのブラウザで動作し、 ユーザーの Cookie・保存済みパスワード・パスキーが使えます。アプリからページの内容を読んだり操作したりはできません。 OAuth のサインインなど、埋め込み WebView で行うべきでない処理に使います。

dart
final browser = AdvancedSystemBrowser(onClosed: () => debugPrint('closed'));

if (await browser.isAvailable()) {
  await browser.open(
    Uri.parse('https://example.com/login'),
    options: const SystemBrowserOptions(toolbarColor: Color(0xFF1E3A8A)),
  );
}
  • 受け付けるのは http と https の URL だけで、それ以外は ArgumentError を投げます。
  • isAvailable は iOS では常に true です。Android では https のリンクを処理できるアプリがあれば true で、 なければ open が PlatformException(unavailable)で失敗します。表示できる画面がない場合は not-attached です。
  • onClosed は iOS では確実に呼ばれます。Android の Custom Tabs は閉じたことを通知しないため、タブを表示したあとに アプリがフォアグラウンドに戻ったときに呼ばれ、別の経路で戻った場合も呼ばれます。サインイン完了の判定には使わず、 結果はサーバーで確認してください。
  • Dart から閉じることはできず、ページを操作することもできません。必要な場合は AdvancedInAppBrowser を使ってください。

MIT License で公開しています。