Saamer

Acesta este un blog invitat de Saamer Mansoor. Saamer este un tinichigiu și un dezvoltator de aplicații la TheFirstPrototype.com. Îl puteți găsi pe Twitter @saamerm, scriind pe Medium și contribuind la Open Source pe GitHub.

Când Play Core v1.8 de la Android a fost lansat în august 2020, acesta a adăugat o nouă funcție minunată pentru a permite utilizatorilor să ofere recenzii în aplicație. Patrick Getzmann a lucrat la o legătură pentru această bibliotecă în ultimele câteva luni și a actualizat-o recent pentru a suporta v1.8. Acest lucru înseamnă că, cu doar câteva linii de cod, puteți aduce această caracteristică și multe altele în aplicația dumneavoastră.

Recenzile în aplicație îmbunătățesc experiența utilizatorului, deoarece utilizatorilor nu le place să fie scoși în afara aplicației lor. Apple a oferit această funcție încă din iOS 10.3 lansat în martie 2017, așa că a fost foarte așteptată pe Android. Să vedem cum putem folosi noua bibliotecă Play Core pentru a aduce această caracteristică în aplicațiile Android.

Biblioteca Play Core

La începutul acestei călătorii am lucrat îndeaproape cu Patrick pentru a actualiza pachetul PlayCore NuGet care poate fi adăugat direct în proiectul Android. Având în vedere că API-ul este esențial pentru Android, am făcut acest PR la proiectul lui Patrick ca un exemplu de utilizare. Acesta arată cum să creați un InAppReviewService.cs în proiectul Android și să folosiți injecția de dependență pentru a-l apela.

Cu toate acestea, de nicăieri, James Montemagno m-a contactat pentru a integra această funcționalitate în deja popularul său Store Review Plugin. Am încheiat un parteneriat cu el pentru a face funcționalitatea mai accesibilă prin intermediul bibliotecii sale NuGet, care avea deja această funcționalitate pentru iOS. Acest lucru înseamnă că implementarea acesteia în aplicația dvs. este acum simplă!

Pasul 1 – Adăugați NuGet-ul

Primul pas este să adăugați noua versiune actualizată v3 a NuGet-ului Store Review Plugin la toate proiectele dvs. Acest lucru va adăuga automat biblioteca Play Core bindings ca dependență.

Pasul 2 – Call RequestReview()

În continuare, decideți cum doriți să solicitați revizuirea. Ați putea să o declanșați atunci când utilizatorul face clic pe un buton sau ați putea să o declanșați manual după ce utilizatorul a folosit aplicația pentru o anumită perioadă de timp. Când doriți să solicitați o revizuire, apelați pur și simplu următoarea linie de cod:

await CrossStoreReview.Current.RequestReview(false);

Aceasta va declanșa procesul de revizuire, iar sistemul de operare va decide dacă aceasta este prezentată. Booleanul transmis are rolul de a determina dacă vă aflați în modul de testare, ceea ce este excelent pentru a vă testa aplicația înainte de a o lansa.

Pasul 3 – Configurație ProGuard opțională

Dacă vă lansați aplicația cu opțiunea Link All și aveți ProGuard/r8 activat, trebuie să adăugați următoarele în fișierul proguard din proiectul 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

Testarea recenziilor în aplicație este complicată pe Android, la fel ca și pe iOS. Există multe limitări în ceea ce privește posibilitatea de a vă testa aplicația, după cum puteți vedea aici. Indiferent de ceea ce încercați, nu veți putea vedea interfața de revizuire în aplicație atunci când este construită și distribuită manual. Trebuie să descărcați aplicația din Play Store, pentru a putea vedea interfața de utilizare. Așadar, cel mai simplu mod de a testa acest lucru este folosind „Internal App Sharing” (Partajare internă a aplicațiilor) de pe Android.

Și iată că acum aveți recenzii in-app cross-platform pentru aplicațiile dumneavoastră Xamarin. Înainte de a încheia postarea, am vrut să ofer tuturor un pic de poveste despre cum a luat naștere întreaga bibliotecă și integrare și sper că împărtășirea poveștii mele vă va încuraja să contribuiți la minunata comunitate Xamarin.

Back Story

De fapt, totul a început cu Reddit. M-am abonat la subredditul Android prin intermediul căruia am aflat despre cele mai recente caracteristici. Când am auzit despre recenziile în aplicație pe Android, am fost curios să le implementez și în aplicația mea, dar apoi m-am documentat și am aflat că nu existau planuri de a avea o legătură oficială pentru Play Core. Cu toate acestea, am găsit NuGet-ul lui Patrick Getzman care făcuse deja munca grea de a crea un binding. La momentul respectiv, acesta era legat doar de Play Core v1.7.2. Deoarece v1.8 este necesară pentru recenzii în aplicație, așa că am creat pur și simplu o problemă.

Un pic mai târziu, aveam un termen limită care se apropia, așa că am decis să amân și să găsesc ceva de făcut în schimb, și atunci am decis să actualizez acea bibliotecă de legături la v1.8. Cu multe derulări de mouse și apăsări de taste, am urmat acest videoclip de Jonathan Dick și am reușit ca fișierul .AAR pentru v1.8 de la Android să funcționeze după câteva încercări și erori! Am trimis un PR și am reușit să folosesc documentația oficială Android pentru a actualiza exemplul din depozitul lui Pat. A fost o experiență minunată și mă bucur că am putut contribui la această caracteristică excelentă.

Sper că ați găsit acest lucru la îndemână, iar dacă folosiți acest lucru în aplicațiile voastre, vă rog să împărtășiți capturi de ecran cu mine, sau puteți spune doar Bună!

Saamer Mansoor

Urmăriți

.