Optimiser le comportement en cas de clic sur une WebView

Si votre Android application utiliseWebView pour afficher du contenu Web, vous pouvez envisager d'optimiser le comportement des clics pour les raisons suivantes:

  • WebView n'est pas compatible avec la navigation par onglets. Cliquez sur un lien pour ouvrir le contenu dans le navigateur Web par défaut. Navigation par onglets avec
  • WebView n'est pas compatible avec les schémas d'URL personnalisées qui peuvent être renvoyés dans les annonces si la destination du clic pointe vers une application distincte. Par exemple, une URL de destination Google Play peut utiliser market://.

Ce guide présente les étapes recommandées pour optimiser le comportement des clics dans les vues Web mobile tout en conservant le contenu de la vue Web.

Prérequis

Implémentation

Procédez comme suit pour optimiser le comportement des clics dans votre instanceWebView :

  1. Remplacez shouldOverrideUrlLoading() sur la WebViewClient. Cette méthode est appelée lorsqu'une URL est sur le point d'être chargée dans le WebView actuel.

  2. Déterminez si vous devez ignorer le comportement de l'URL de suivi des clics.

    L'extrait de code ci-dessous vérifie si le domaine actuel est différent du domaine cible. Il ne s'agit que d'une approche parmi tant d'autres, car les critères utilisés peuvent varier.

  3. Indiquez si vous souhaitez ouvrir l'URL dans un navigateur externe, dans des onglets personnalisés Android ou dans la vue Web existante. Ce guide explique comment ouvrir des URL externes au site en lançant des onglets personnalisés Android.

Exemple de code

Commencez par ajouter la dépendance androidx.browser à votre fichier build.gradle au niveau du module, généralement app/build.gradle. Cette opération est obligatoire pour les onglets personnalisés:

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

L'extrait de code suivant montre comment implémenter shouldOverrideUrlLoading():

Java

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, return early.
            if (request.getUrl().getHost() == 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 URL(view.getUrl()).getHost();
            } catch (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, return early.
        request?.url?.host?.let { targetDomain ->
          val currentDomain = URL(view?.url).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 {
              this@MainActivity.startActivity(intent)
            } catch (exception: ActivityNotFoundException) {
              Log.d("TAG", "Failed to load URL with scheme: ${request.url.scheme}")
            }
            return true
          }

          // 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
        }
        return false
      }
    }
  }
}

Tester la navigation sur les pages

Pour tester les modifications apportées à la navigation sur les pages, chargez

https://webview-api-for-ads-test.glitch.me#click-behavior-tests

dans la vue Web. Cliquez sur chacun des différents types de liens pour voir leur comportement dans votre application.

Voici quelques points à vérifier :

  • Chaque lien ouvre l'URL prévue.
  • Lors du retour à l'application, le compteur de la page de test n'est pas réinitialisé pour vérifier que l'état de la page a bien été conservé.