Optimiser le comportement en cas de clic sur une WebView

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

  • WebView n'est pas compatible avec les schémas d'URL personnalisés qui peuvent être renvoyés dans les annonces si la destination du clic est 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 mobiles tout en préservant le contenu de la vue Web.

Prérequis

Implémentation

Pour optimiser le comportement des clics dans votre instance WebView:

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

  2. Déterminez si vous devez remplacer le comportement de l'URL de destination.

    L'exemple de code vérifie si le domaine actuel est différent du domaine cible. Il ne s'agit là que d'une approche, car les critères que vous utilisez peuvent varier.

  3. Indiquez si vous souhaitez ouvrir l'URL dans un navigateur externe, dans les onglets personnalisés Android ou dans la vue Web existante. Ce guide explique comment ouvrir des URL qui quittent le 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 étape 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 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, return early.
        request?.url?.host?.let { targetDomain ->
          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 {
              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 vos 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 votre vue Web. Cliquez sur chacun des différents types de liens pour voir comment ils se comportent dans votre application.

Voici quelques points à vérifier :

  • Chaque lien ouvre l'URL souhaitée.
  • Lorsque vous revenez à l'application, le compteur de la page de test n'est pas réinitialisé à zéro pour valider que l'état de la page a été préservé.
Précédent
Intégrer l'API WebView pour les annonces