> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# WebViewから外部ブラウザーを開く

> ネイティブアプリのWebViewで、NotiflyのWebポップアップのボタンから外部ブラウザーを開く方法を説明します。

> [!NOTE]
>
> この機能は、Notifly JS SDK `@notifly-tech/notifly-js-sdk`の2.17.8以降で使用できます。

## 概要

Notiflyコンソールで[Webポップアップ](https://docs.notifly.tech/ja/user-guide/channel/web-message/guide.md)のリンクを開く方法を**外部ブラウザで開く**に設定すると、JS SDKは`target="_blank"`でリンクを開きます。ChromeやSafariなどの一般的なモバイルブラウザーでは、追加の設定は必要ありません。

ネイティブアプリのWebViewから外部にリンクを開くには、ネイティブ側の処理が必要です。この処理がない場合、同じWebViewでリンクが開いたり、何も起こらなかったりします。

| プラットフォーム | デフォルトの動作 | 原因 |
| - | - | - |
| Android WebView | 同じWebViewで開くか、アプリのウィンドウ処理によっては無視されます | `setSupportMultipleWindows`のデフォルト値は`false`です |
| iOS WKWebView | タップしても何も起こりません | `WKUIDelegate`の`createWebViewWith`メソッドが未実装です |

アプリ内のWebViewでNotiflyのWebポップアップを表示する場合は、以下のプラットフォーム別のネイティブ設定を追加してください。

> [!NOTE]
>
> Notiflyの[Android SDK](https://docs.notifly.tech/ja/developer-guide/android-sdk.md)または[iOS SDK](https://docs.notifly.tech/ja/developer-guide/ios-sdk.md)のみを使用してアプリ内ポップアップを表示する場合、SDK内にリンクの処理が含まれているため、追加の設定は必要ありません。

## プラットフォーム別の設定

> [tab] Android
>
> Android WebViewは、`target="_blank"`のリンクを自動的に外部ブラウザーで開きません。以下の両方の手順を適用してください。
>
> ### 手順1. マルチウィンドウを有効にする
>
> 新しいウィンドウを開くリクエストを処理できるようにWebViewを設定します。
>
> > [tab] Kotlin
> >
> > ```kotlin theme={null}
> > webView.settings.setSupportMultipleWindows(true)
> > webView.settings.javaScriptCanOpenWindowsAutomatically = true
> > ```
>
> > [tab] Java
> >
> > ```java theme={null}
> > WebSettings settings = webView.getSettings();
> > settings.setSupportMultipleWindows(true);
> > settings.setJavaScriptCanOpenWindowsAutomatically(true);
> > ```
>
> ### 手順2. 新しいウィンドウのリクエストを転送する
>
> マルチウィンドウを有効にすると、`target="_blank"`のリンクをタップした際に`WebChromeClient.onCreateWindow()`が呼び出されます。このメソッドでURLを取得し、システムのURLハンドラーに渡します。通常、Webリンクは端末のデフォルトブラウザーで開きます。
>
> > [tab] Kotlin
> >
> > ```kotlin theme={null}
> > import android.content.Intent
> > import android.os.Message
> > import android.webkit.WebChromeClient
> > import android.webkit.WebResourceRequest
> > import android.webkit.WebView
> > import android.webkit.WebViewClient
> >
> > webView.webChromeClient = object : WebChromeClient() {
> >     override fun onCreateWindow(
> >         view: WebView, isDialog: Boolean,
> >         isUserGesture: Boolean, resultMsg: Message?
> >     ): Boolean {
> >         // URLを取得するために一時的なWebViewを作成します。
> >         val tempWebView = WebView(view.context)
> >         tempWebView.webViewClient = object : WebViewClient() {
> >             override fun shouldOverrideUrlLoading(
> >                 view: WebView, request: WebResourceRequest
> >             ): Boolean {
> >                 // 取得したURLをシステムのURLハンドラーで開きます。
> >                 val intent = Intent(Intent.ACTION_VIEW, request.url)
> >                 view.context.startActivity(intent)
> >                 return true
> >             }
> >         }
> >         // 転送オブジェクトを介して一時的なWebViewを接続します。
> >         val transport = resultMsg?.obj as? WebView.WebViewTransport
> >         transport?.webView = tempWebView
> >         resultMsg?.sendToTarget()
> >         return true
> >     }
> > }
> > ```
>
> > [tab] Java
> >
> > ```java theme={null}
> > import android.content.Intent;
> > import android.os.Message;
> > import android.webkit.WebChromeClient;
> > import android.webkit.WebResourceRequest;
> > import android.webkit.WebView;
> > import android.webkit.WebViewClient;
> >
> > webView.setWebChromeClient(new WebChromeClient() {
> >     @Override
> >     public boolean onCreateWindow(WebView view, boolean isDialog,
> >                                   boolean isUserGesture, Message resultMsg) {
> >         // URLを取得するために一時的なWebViewを作成します。
> >         WebView tempWebView = new WebView(view.getContext());
> >         tempWebView.setWebViewClient(new WebViewClient() {
> >             @Override
> >             public boolean shouldOverrideUrlLoading(WebView v, WebResourceRequest request) {
> >                 // 取得したURLをシステムのURLハンドラーで開きます。
> >                 Intent intent = new Intent(Intent.ACTION_VIEW, request.getUrl());
> >                 v.getContext().startActivity(intent);
> >                 return true;
> >             }
> >         });
> >         // 転送オブジェクトを介して一時的なWebViewを接続します。
> >         WebView.WebViewTransport transport = (WebView.WebViewTransport) resultMsg.obj;
> >         transport.setWebView(tempWebView);
> >         resultMsg.sendToTarget();
> >         return true;
> >     }
> > });
> > ```
>
> > [!NOTE]
> >
> > この例は`shouldOverrideUrlLoading(WebView, WebResourceRequest)`を使用するため、Android 7.0（APIレベル24）以降が必要です。すでに`WebChromeClient`を使用している場合は、既存のクラスに`onCreateWindow()`を追加してください。

> [tab] iOS
>
> WKWebViewは、`target="_blank"`のリンクをタップすると、`WKUIDelegate`の`createWebViewWith`メソッドを呼び出します。このメソッドが未実装の場合、リンクは無視されます。WebViewの設定を別途変更する必要はありません。
>
> `webView.uiDelegate = self`が未設定の場合は設定し、以下の`createWebViewWith`メソッドを追加してください。新しいWKWebViewが作成されないよう、`nil`を返します。`UIApplication.shared.open`はURLをシステムに渡し、Webリンクはデフォルトブラウザーまたは関連付けられたアプリで開きます。
>
> ```swift theme={null}
> // MARK: - WKUIDelegate
> extension YourViewController: WKUIDelegate {
>     func webView(
>         _ webView: WKWebView,
>         createWebViewWith configuration: WKWebViewConfiguration,
>         for navigationAction: WKNavigationAction,
>         windowFeatures: WKWindowFeatures
>     ) -> WKWebView? {
>         // target="_blank"のリンクをWebViewの外部で開きます。
>         if let url = navigationAction.request.url {
>             UIApplication.shared.open(url)
>         }
>         return nil
>     }
> }
> ```

## 動作の流れ

上記の設定を適用すると、以下の流れでWebViewの外部にリンクを開きます。

1. ユーザーがNotiflyのWebポップアップのボタンをタップすると、JS SDKが`target="_blank"`でリンクを開きます。
2. WebViewは新しいウィンドウを開くリクエストをネイティブ側に委譲します。Androidでは`onCreateWindow`、iOSでは`createWebViewWith`が呼び出されます。
3. ネイティブコードがURLを取得し、システムのURLハンドラーに渡します。通常、WebリンクはChromeやSafariなど、端末のデフォルトブラウザーで開きます。

## 注意事項

* この設定は、Notiflyコンソールでメッセージのリンクを開く方法を**外部ブラウザで開く**にした場合にのみ適用されます。デフォルトの**現在のウィンドウで開く**の場合、この設定に関係なくWebView内でリンクが開きます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.