WebView 클릭 동작 최적화

앱에서 WebView를 사용하여 웹 콘텐츠를 표시하는 경우 다음과 같은 이유로 클릭 동작을 최적화하는 것이 좋습니다.

• WebView은 탭 탐색을 지원하지 않습니다. 링크를 클릭하면 기본 웹브라우저에서 콘텐츠가 열립니다.

• WebView는 클릭 도착 페이지가 별도의 앱인 경우 광고에 반환될 수 있는 맞춤 URL 스키마를 지원하지 않습니다. 예를 들어 Google Play 클릭연결 URL은 market://을 사용할 수 있습니다.

• WebView에서는 Google 로그인 및 Facebook 로그인이 지원되지 않습니다.

이 가이드에서는 웹 뷰 콘텐츠를 유지하면서 모바일 웹 뷰의 클릭 동작을 최적화하기 위한 권장 단계를 제공합니다.

기본 요건

• 웹 뷰 설정 가이드를 완료합니다.

구현

다음 단계에 따라 WebView 인스턴스에서 클릭 동작을 최적화하세요.

1. WebViewClient에서 shouldOverrideUrlLoading()을 재정의합니다. 이 메서드는 현재 WebView에서 URL이 로드되려고 할 때 호출됩니다.

2. 클릭 URL의 동작을 재정의할지 여부를 결정합니다.

   코드 예에서는 현재 도메인이 타겟 도메인과 다른지 확인합니다. 사용하는 기준이 다를 수 있으므로 이는 하나의 접근 방식일 뿐입니다.

3. 외부 브라우저, Android 맞춤 탭 또는 기존 웹 뷰 내에서 URL을 열지 결정합니다. 이 가이드에서는 Android 맞춤 탭을 실행하여 사이트에서 벗어나는 URL을 여는 방법을 보여줍니다.

코드 예

먼저 모듈 수준 build.gradle 파일(일반적으로 app/build.gradle)에 androidx.browser 종속 항목을 추가합니다. 맞춤 탭에는 다음이 필요합니다.

dependencies {
  implementation 'androidx.browser:browser:1.5.0'
}

다음 코드 스니펫은 shouldOverrideUrlLoading()를 구현하는 방법을 보여줍니다.

자바

public class MainActivity extends AppCompatActivity {

  private WebView webView;

  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // ... Register the WebView.

    webView = new WebView(this);
    WebSettings webSettings = webView.getSettings();
    webSettings.setJavaScriptEnabled(true);
    webView.setWebViewClient(
        new WebViewClient() {
          // 1. Implement the web view click handler.
          @Override
          public boolean shouldOverrideUrlLoading(
              WebView view,
              WebResourceRequest request) {
            // 2. Determine whether to override the behavior of the URL.
            // If the target URL has no host and no scheme, return early.
            if (request.getUrl().getHost() == null && request.getUrl().getScheme() == null) {
              return false;
            }

            // Handle custom URL schemes such as market:// by attempting to
            // launch the corresponding application in a new intent.
            if (!request.getUrl().getScheme().equals("http")
                && !request.getUrl().getScheme().equals("https")) {
              Intent intent = new Intent(Intent.ACTION_VIEW, request.getUrl());
              // If the URL cannot be opened, return early.
              try {
                MainActivity.this.startActivity(intent);
              } catch (ActivityNotFoundException exception) {
                Log.d("TAG", "Failed to load URL with scheme:" + request.getUrl().getScheme());
              }
              return true;
            }

            String currentDomain;
            // If the current URL's host cannot be found, return early.
            try {
              currentDomain = new URI(view.getUrl()).toURL().getHost();
            } catch (URISyntaxException | MalformedURLException exception) {
              // Malformed URL.
              return false;
            }
            String targetDomain = request.getUrl().getHost();

            // If the current domain equals the target domain, the
            // assumption is the user is not navigating away from
            // the site. Reload the URL within the existing web view.
            if (currentDomain.equals(targetDomain)) {
              return false;
            }

            // 3. User is navigating away from the site, open the URL in
            // Custom Tabs to preserve the state of the web view.
            CustomTabsIntent intent = new CustomTabsIntent.Builder().build();
            intent.launchUrl(MainActivity.this, request.getUrl());
            return true;
          }
        });
  }
}

Kotlin

class MainActivity : AppCompatActivity() {

  private lateinit var webView: WebView

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // ... Register the WebView.

    webView.webViewClient = object : WebViewClient() {
      // 1. Implement the web view click handler.
      override fun shouldOverrideUrlLoading(
          view: WebView?,
          request: WebResourceRequest?
      ): Boolean {
        // 2. Determine whether to override the behavior of the URL.
        // If the target URL has no host and no scheme, return early.
        if (request?.url?.host == null && request.url.scheme == null) {
          return false
        }
        val currentDomain = URI(view?.url).toURL().host

        // Handle custom URL schemes such as market:// by attempting to
        // launch the corresponding application in a new intent.
        if (!request.url.scheme.equals("http") &&
            !request.url.scheme.equals("https")) {
          val intent = Intent(Intent.ACTION_VIEW, request.url)
          // If the URL cannot be opened, return early.
          try {
            [e-mail](intent)
          } catch (exception: ActivityNotFoundException) {
            Log.d("TAG", "Failed to load URL with scheme: ${request.url.scheme}")
          }
          return true
        }

        val targetDomain = request.url.host

        // If the current domain equals the target domain, the
        // assumption is the user is not navigating away from
        // the site. Reload the URL within the existing web view.
        if (currentDomain.equals(targetDomain)) {
          return false
        }

        // 3. User is navigating away from the site, open the URL in
        // Custom Tabs to preserve the state of the web view.
        val customTabsIntent = CustomTabsIntent.Builder().build()
        customTabsIntent.launchUrl(this@MainActivity, request.url)
        return true
      }
    }
  }
}

페이지 탐색 테스트

페이지 탐색 변경사항을 테스트하려면

https://google.github.io/webview-ads/test/#click-behavior-tests

웹 뷰에 삽입합니다. 다양한 링크 유형을 각각 클릭하여 앱에서 어떻게 작동하는지 확인합니다.

다음과 같은 사항을 확인해 보시기 바랍니다.

• 각 링크는 의도한 URL을 엽니다.
• 앱으로 돌아가면 페이지 상태가 유지되었는지 확인하기 위해 테스트 페이지의 카운터가 0으로 재설정되지 않습니다.