android-browser-helper, une nouvelle bibliothèque pour créer des activités Web fiables.

André Cipani Bandarra
André Cipriani Bandarra

Nous avons publié la version 1.0.0 d'android-browser-helper, une nouvelle bibliothèque Android pour l'activité Web fiable. En plus d'être basée sur les bibliothèques modernes Android JetPack, elle permet aux développeurs d'utiliser l'activité Web fiable pour créer leurs applications Android.

android-browser-helper est désormais la bibliothèque recommandée pour créer des applications qui utilisent l'activité Web fiable.

La bibliothèque est hébergée dans le dépôt Maven de Google officiel, qui fonctionne directement dans les projets Android et qui est également compatible avec AndroidX, qui constituait un problème courant avec la bibliothèque précédente.

D'autres fonctionnalités et une meilleure expérience de développement seront ajoutées à cette bibliothèque. Voici une courte liste des éléments déjà ajoutés:

  • Gère l'ouverture du contenu dans un navigateur compatible avec les activités Web fiables et, si ce n'est pas le cas, implémente une stratégie de remplacement.
  • Rend la stratégie de remplacement personnalisable afin que les développeurs puissent personnaliser le comportement de leur application lorsqu'un navigateur compatible avec les activités Web fiables n'est pas installé. La démonstration twa-webview-fallback montre comment utiliser une stratégie de remplacement qui utilise Android WebView, par exemple.
  • Facilite la configuration d'activités Web fiables fonctionnant avec plusieurs origines, comme illustré dans la démonstration twa-multi-domain]4.

La bibliothèque peut être ajoutée à l'application Android à l'aide de la dépendance suivante à l'application build.gradle:

dependencies {
    //...
    implementation 'com.google.androidbrowserhelper:androidbrowserhelper:2.2.0'
}

Migrer depuis le client custom-tabs

Les développeurs qui utilisaient l'ancienne version de custom-tabs-client devront apporter quelques modifications à leur application lors de la migration vers android-browser-helper.

Heureusement, en plus de remplacer l'ancienne bibliothèque par la nouvelle, ces modifications impliquent principalement de modifier la recherche et le remplacement de quelques chaînes dans AndroidManifest.xml.

Voici un récapitulatif des noms qui ont été modifiés:

Nom sur custom-tabs-client (ancienne bibliothèque) Nom sur android-browser-helper (nouvelle bibliothèque)
android.support.customtabs.trusted.LauncherActivity com.google.androidbrowserhelper.trusted.LauncherActivity
android.support.v4.content.FileProvider androidx.core.content.FileProvider
android.support.customtabs.trusted.TrustedWebActivityService com.google.androidbrowserhelper.trusted.DelegationService

La démonstration svgomg-twa a été mise à jour pour utiliser android-browser-helper. Cette diff montre toutes les modifications requises lors de la migration d'un projet existant utilisant custom-tabs-client vers android-browser-helper.

Souhaitez-vous rajouter quelque chose ?

android-browser-helper vise à simplifier le développement d'applications à l'aide d'activités Web fiables. La bibliothèque continuera d'évoluer à mesure que de nouvelles fonctionnalités seront ajoutées à l'activité Web fiable.

Si une fonctionnalité n'est pas disponible dans les activités Web fiables, réfléchissez à la façon dont Android-browser-helper pourrait simplifier le développement ou avez une question sur l'utilisation de la bibliothèque, veillez à consulter le dépôt GitHub et à signaler un problème.

Commentaires