Optimiser le comportement en cas de clic sur une WebView

Si votre Android application utilise WebView pour afficher du contenu Web, vous pouvez d'optimiser le comportement en termes de clics pour les raisons suivantes:

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

Ce guide fournit des recommandations pour optimiser le comportement en termes de clics sur mobile. les vues Web tout en conservant le contenu de la vue Web.

Prérequis

Implémentation

Procédez comme suit pour optimiser le comportement en termes de clics dans votre WebView instance:

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

  2. Déterminez si le comportement de l'URL de suivi des clics doit être ignoré.

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

  3. Choisissez d'ouvrir ou non l'URL dans un navigateur externe, Android Custom dans les onglets, ou encore la vue Web existante. Ce guide explique comment ouvrir des URL en quittant le site en lançant les onglets personnalisés Android.

Exemple de code

Commencez par ajouter la dépendance androidx.browser à votre 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 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 votre vue Web. Cliquez sur les différents types de liens dans votre application.

Voici quelques points à vérifier :

  • Chaque lien ouvre l'URL prévue.
  • Lorsque vous revenez dans l'application, le compteur de la page de test n'est pas réinitialisé pour confirmer que l'état de la page a été conservé.
Précédent
API WebView pour les annonces