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 la navigation par onglets. Lorsque vous cliquez sur un lien, le contenu s'ouvre dans le navigateur Web par défaut.

• 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 suivi des clics Google Play peut utiliser market://.

• Google Sign-In et Se connecter avec Facebook ne sont pas compatibles avec WebView.

Ce guide fournit des é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

• Suivez le guide Configurer la vue Web.

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 le WebView actuel.

2. Déterminez si vous souhaitez remplacer le comportement de l'URL de clic.

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

3. Décidez si l'URL doit s'ouvrir dans un navigateur externe, dans Android Custom Tabs ou dans la vue Web existante. Ce guide explique comment ouvrir des URL en quittant le site à l'aide 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. Voici ce qui est requis 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 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
      }
    }
  }
}

Tester la navigation sur vos pages

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

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

dans votre vue Web. Cliquez sur chacun des types de liens pour voir comment ils se comportent dans votre application.

Voici quelques points à vérifier :

• Chaque lien ouvre l'URL prévue.
• Lorsque vous revenez à l'application, le compteur de la page de test ne revient pas à zéro pour valider que l'état de la page a été conservé.