Saamer

Este é um blog convidado por Saamer Mansoor. Saamer é um funileiro e desenvolvedor de aplicativos no TheFirstPrototype.com. Você pode encontrá-lo no Twitter @saamerm, escrevendo em Médio, e contribuindo para o Open Source no GitHub.

Quando o Play Core v1.8 do Android foi lançado em agosto de 2020, ele adicionou um novo recurso incrível para permitir que os usuários forneçam revisões em apps. Patrick Getzmann tem trabalhado em um binding para esta biblioteca nos últimos meses e ele recentemente a atualizou para suportar a v1.8. Isto significa que com apenas algumas linhas de código você pode trazer este recurso e muitos outros para o seu aplicativo.

In-app reviews melhoram a experiência do usuário, pois os usuários não gostam de ser levados para fora do seu aplicativo. A Apple disponibiliza esta funcionalidade desde o iOS 10.3 lançado em Março de 2017, por isso foi altamente antecipada no Android. Vamos ver como podemos usar a nova biblioteca Play Core para trazer este recurso para aplicativos Android.

Play Core Library

No início desta jornada eu trabalhei de perto com o Patrick para atualizar o pacote PlayCore NuGet que pode ser adicionado diretamente ao seu projeto Android. Como a API é o núcleo do Android eu fiz este PR para o projeto do Patrick como um exemplo de como usá-lo. Ele mostra como criar um InAppReviewService.cs no seu projeto Android e usar injeção de dependência para chamá-lo.

No entanto, do nada James Montemagno chegou até mim sobre a integração dessa funcionalidade no seu já popular Plugin de Revisão da Loja. Fizemos uma parceria com ele para tornar a funcionalidade mais acessível através da sua biblioteca NuGet que já tinha a funcionalidade para o iOS. Isto significa que implementar isto no seu aplicativo agora é simples!

Passo 1 – Adicione o NuGet

O primeiro passo é adicionar a recém atualizada v3 do Store Review Plugin NuGet a todos os seus projetos. Isto irá automaticamente adicionar a biblioteca de ligações Play Core como uma dependência.

Passo 2 – Chamada RequestReview()

Próximo, decida como você quer pedir a revisão. Você pode acioná-la quando o usuário clicar em um botão, ou você pode acioná-la manualmente após o usuário ter usado o aplicativo por um período de tempo específico. Quando você quiser solicitar uma revisão basta chamar essa seguinte linha de código:

await CrossStoreReview.Current.RequestReview(false);

Isso acionará o processo de revisão e o sistema operacional decidirá se ela será apresentada. O booleano passado é para determinar se você está em modo de teste, o que é ótimo para testar seu aplicativo antes de liberá-lo.

Passo 3 – Opcional ProGuard Config

Se você está lançando seu aplicativo com a opção Link All e tem ProGuard/r8 habilitado, você tem que adicionar o seguinte no arquivo proguard no seu projeto 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

Testing in-app reviews é complicado no Android, assim como é no iOS. Existem muitas limitações para poder testar o seu aplicativo, como você pode ver aqui. Independentemente do que você tentar, você não será capaz de ver a IU de revisão In-App quando construído e distribuído manualmente. Você tem que baixar o aplicativo da Play Store, a fim de ver a IU. Então, a maneira mais fácil de testar isso é usando o “Internal App Sharing” do Android.

E aí você tem, agora você tem revisões em plataforma cruzada para seus aplicativos Xamarin. Antes de terminar o post eu queria dar a todos um pouco da história de como toda a biblioteca e integração veio a ser e eu espero que compartilhando minha história irá encorajá-lo a contribuir para a incrível comunidade Xamarin.

Back Story

Tudo começou com Reddit na verdade. Eu subscrevo o subreddit do Android através do qual eu aprendo sobre as últimas funcionalidades. Quando eu ouvi sobre as revisões no aplicativo Android, eu estava curioso para implementá-lo em meu aplicativo também, mas então eu pesquisei e aprendi que não havia planos de ter uma ligação oficial para o Play Core. No entanto, encontrei o NuGet do Patrick Getzman que já tinha feito o trabalho pesado de criar uma encadernação. Na altura só estava encadernado contra o Play Core v1.7.2. Uma vez que a v1.8 é necessária para as revisões no aplicativo, então eu simplesmente criei um número.

Um pouco tempo depois, eu tinha um prazo rastejante, então eu decidi procrastinar e encontrar qualquer coisa para fazer, e foi quando eu decidi atualizar essa biblioteca de encadernações para a v1.8. Com muitos scrolls de mouse e toques de teclas, eu segui este vídeo do Jonathan Dick e consegui o arquivo .AAR para a v1.8 do Android funcionando após alguma tentativa e erro! Eu submeti um PR e pude usar a documentação oficial do Android para atualizar o exemplo no repositório do Pat. Foi uma experiência maravilhosa e feliz que eu pude ajudar a contribuir com este excelente recurso.

Espero que você tenha achado isto útil, e se você usar isto em seus aplicativos, por favor compartilhe screenshots comigo, ou você pode apenas dizer Oi!

Saamer Mansoor

Siga