アプリ内ブラウザ
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 | ページのタイトル | 現在のページのタイトルの代わりに表示する固定タイトル。 |
showUrl | false | タイトルの下に現在の URL を表示します。 |
showNavigationButtons | true | 戻る・進む・再読み込みのボタンを表示します。 |
closeButtonLabel | アイコン | プラットフォームの閉じるアイコンの代わりに使うテキスト。 |
settings | WebViewSettings() | ブラウザ内 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を使ってください。