Saamer

Ce blog est un blog invité de Saamer Mansoor. Saamer est un bricoleur et un développeur d’applications chez TheFirstPrototype.com. Vous pouvez le trouver sur Twitter @saamerm, écrire sur Medium, et contribuer à l’Open Source sur GitHub.

Lorsque le Play Core v1.8 d’Android a été publié en août 2020, il a ajouté une nouvelle fonctionnalité géniale pour permettre aux utilisateurs de fournir des critiques in-app. Patrick Getzmann a travaillé sur un binding pour cette bibliothèque au cours des derniers mois et il l’a récemment mis à jour pour supporter la v1.8. Cela signifie qu’avec seulement quelques lignes de code, vous pouvez apporter cette fonctionnalité et bien d’autres à votre application.

Les critiques in-app améliorent l’expérience utilisateur car les utilisateurs n’aiment pas être emmenés en dehors de leur application. Apple a fourni cette fonctionnalité depuis iOS 10.3 sorti en mars 2017, elle était donc très attendue sur Android. Voyons comment nous pouvons utiliser la nouvelle bibliothèque Play Core pour apporter cette fonctionnalité aux applications Android.

Bibliothèque Play Core

Au début de ce voyage, j’ai travaillé en étroite collaboration avec Patrick pour mettre à jour le paquet NuGet PlayCore qui peut être directement ajouté à votre projet Android. Comme l’API est au cœur d’Android, j’ai fait ce PR au projet de Patrick comme un exemple de la façon de l’utiliser. Il montre comment créer un InAppReviewService.cs dans votre projet Android et utiliser l’injection de dépendances pour l’appeler.

Cependant, sorti de nulle part, James Montemagno m’a contacté pour intégrer cette fonctionnalité dans son plugin Store Review déjà populaire. Nous nous sommes associés à lui pour rendre la fonctionnalité plus accessible à travers sa bibliothèque NuGet qui avait déjà la fonctionnalité pour iOS. Cela signifie que la mise en œuvre de cette fonctionnalité dans votre application est maintenant simple!

Etape 1 – Ajouter le NuGet

La première étape consiste à ajouter la v3 nouvellement mise à jour du Store Review Plugin NuGet à tous vos projets. Cela ajoutera automatiquement la bibliothèque Play Core bindings en tant que dépendance.

Etape 2 – Appel RequestReview()

Puis, décidez de la façon dont vous voulez demander la révision. Vous pourriez la déclencher lorsque l’utilisateur clique sur un bouton, ou vous pourriez la déclencher manuellement après que l’utilisateur ait utilisé l’application pendant une durée spécifique. Lorsque vous voulez demander une révision, appelez simplement cette ligne de code suivante:

await CrossStoreReview.Current.RequestReview(false);

Cela déclenchera le processus de révision et le système d’exploitation décidera s’il est présenté. Le booléen passé dans est pour déterminer si vous êtes en mode test, ce qui est génial pour tester votre application avant de la sortir.

Étape 3 – Configuration ProGuard facultative

Si vous publiez votre application avec l’option Link All et que ProGuard/r8 est activé, vous devez ajouter ce qui suit dans le fichier proguard de votre projet Android :

-keep class com.google.android.play.core.common.PlayCoreDialogWrapperActivity-keep class com.google.android.play.core.review.** { *; }-keep class com.google.android.play.core.tasks.** { *; }

Testing

Tester les revues in-app est délicat sur Android, tout comme sur iOS. Il existe de nombreuses limitations pour pouvoir tester votre application comme vous pouvez le voir ici. Peu importe ce que vous essayez, vous ne serez pas en mesure de voir l’interface utilisateur des critiques in-app lorsqu’elle est construite et distribuée manuellement. Vous devez télécharger l’application à partir du Play Store, afin de voir l’interface utilisateur. Donc, la façon la plus simple de tester cela est d’utiliser le « Internal App Sharing » d’Android.

Et voilà, vous avez maintenant des revues in-app multiplateformes pour vos applications Xamarin. Avant, je termine le post, je voulais donner à tout le monde un peu d’histoire de retour sur la façon dont l’ensemble de la bibliothèque et l’intégration est venu à être et j’espère que le partage de mon histoire vous encouragera à contribuer à la communauté impressionnante Xamarin.

Back Story

Tout a commencé avec Reddit en fait. Je suis abonné au subreddit Android grâce auquel je m’informe des dernières fonctionnalités. Lorsque j’ai entendu parler des évaluations in-app sur Android, j’étais curieux de l’implémenter dans mon application aussi, mais j’ai ensuite fait des recherches et j’ai appris qu’il n’y avait pas de plans pour avoir une liaison officielle pour Play Core. Cependant, j’ai trouvé le NuGet de Patrick Getzman qui avait déjà fait le gros du travail pour créer une liaison. À l’époque, il n’était lié qu’à Play Core v1.7.2. Puisque la v1.8 est nécessaire pour les revues in-app, alors j’ai simplement créé un problème.

Un peu plus tard, j’avais une date limite qui rampait, alors j’ai décidé de procrastiner et de trouver quelque chose à faire à la place, et c’est là que j’ai décidé de mettre à jour cette bibliothèque de liaisons à la v1.8. Après avoir fait défiler la souris et tapé sur les touches, j’ai suivi cette vidéo de Jonathan Dick et j’ai réussi à faire fonctionner le fichier .AAR pour la v1.8 d’Android après quelques essais et erreurs ! J’ai soumis un PR et j’ai pu utiliser la documentation officielle d’Android pour mettre à jour l’exemple dans le dépôt de Pat. C’était une expérience merveilleuse et je suis heureux d’avoir pu contribuer à cette excellente fonctionnalité.

J’espère que vous avez trouvé cela pratique, et si vous l’utilisez dans vos applications, veuillez partager des captures d’écran avec moi, ou vous pouvez simplement dire bonjour!

Saamer Mansoor

Suivez

.