Saamer

Ez egy vendég blog Saamer Mansoor tollából. Saamer egy barkácsoló és alkalmazásfejlesztő a TheFirstPrototype.com oldalon. Megtalálható a Twitteren @saamerm, ír a Mediumon, és hozzájárul a nyílt forráskódhoz a GitHubon.

Amikor 2020 augusztusában megjelent az Android Play Core v1.8, egy fantasztikus új funkcióval bővült, amely lehetővé tette a felhasználók számára, hogy alkalmazáson belüli értékeléseket adjanak. Patrick Getzmann az elmúlt hónapokban egy kötésen dolgozott ehhez a könyvtárhoz, és nemrég frissítette azt a v1.8 támogatásához. Ez azt jelenti, hogy mindössze néhány sornyi kóddal ezt a funkciót és még sok mást is be tudsz vinni az alkalmazásodba.

Az alkalmazáson belüli vélemények javítják a felhasználói élményt, mivel a felhasználók nem szeretik, ha az alkalmazáson kívülre viszik őket. Az Apple a 2017 márciusában megjelent iOS 10.3 óta biztosítja ezt a funkciót, így Androidon már nagyon várták. Lássuk, hogyan használhatjuk az új Play Core könyvtárat, hogy ezt a funkciót az Android-alkalmazásokba is bevigyük.

Play Core könyvtár

Az utazás kezdetén szorosan együttműködtem Patrickkal a PlayCore NuGet csomag frissítésében, amelyet közvetlenül hozzáadhatunk az Android projektünkhöz. Mivel az API az Android alapját képezi, ezt a PR-t készítettem Patrick projektjéhez, hogy példát mutassak a használatára. Megmutatja, hogyan hozzunk létre egy InAppReviewService.cs-t az Android projektünkben, és hogyan használjuk a függőségi injektálást a meghívásához.

A semmiből azonban James Montemagno megkeresett azzal, hogy integráljuk ezt a funkciót a már népszerű Store Review Pluginjébe. Együttműködtünk vele, hogy a funkciót elérhetőbbé tegyük a NuGet könyvtárán keresztül, amely már rendelkezett a funkcióval az iOS számára. Ez azt jelenti, hogy ennek implementálása az alkalmazásodban most már egyszerű!

1. lépés – A NuGet hozzáadása

Az első lépés az, hogy a Store Review Plugin NuGet újonnan frissített v3-as verzióját hozzáadod az összes projektedhez. Ez automatikusan hozzáadja a Play Core kötéskönyvtárat függőségként.

Step 2 – Hívás RequestReview()

A következő lépésben döntsd el, hogyan szeretnéd kérni a felülvizsgálatot. Kiválthatod, amikor a felhasználó rákattint egy gombra, vagy manuálisan is kiválthatod, miután a felhasználó egy bizonyos ideig használta az alkalmazást. Amikor felülvizsgálatot szeretne kérni, egyszerűen hívja meg a következő kódsort:

await CrossStoreReview.Current.RequestReview(false);

Ez fogja elindítani a felülvizsgálati folyamatot, és az operációs rendszer fogja eldönteni, hogy bemutatásra kerül-e az. Az átadott boolean azt határozza meg, hogy teszt üzemmódban vagy-e, ami kiválóan alkalmas az alkalmazás tesztelésére a kiadás előtt.

3. lépés – Opcionális ProGuard konfiguráció

Ha az alkalmazásodat a Link All opcióval adod ki, és engedélyezve van a ProGuard/r8, akkor az Android projekted proguard fájljába a következőket kell beírnod:

-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.** { *; }

Tesztelés

Az alkalmazáson belüli felülvizsgálatok tesztelése Androidon ugyanúgy trükkös, mint iOS-en. Számos korlátozása van annak, hogy tesztelni tudd az alkalmazásodat, ahogy itt láthatod. Függetlenül attól, hogy mit próbálsz ki, nem fogod látni az alkalmazáson belüli felülvizsgálati felhasználói felületet, ha kézzel építed és terjeszted. Le kell töltened az alkalmazást a Play Store-ból, hogy láthasd az UI-t. Tehát a legegyszerűbb módja a tesztelésnek az Android “Belső alkalmazásmegosztás” használata.

És ezzel meg is van, most már van cross-platform alkalmazáson belüli felülvizsgálat a Xamarin alkalmazásaihoz. Mielőtt befejezném a bejegyzést, szerettem volna mindenkinek egy kis háttértörténetet adni arról, hogyan jött létre az egész könyvtár és az integráció, és remélem, hogy a történetem megosztása arra ösztönöz, hogy hozzájáruljon a fantasztikus Xamarin közösséghez.

Back Story

Az egész valójában a Reddittel kezdődött. Feliratkoztam az Android subredditre, amelyen keresztül értesültem a legújabb funkciókról. Amikor hallottam az alkalmazáson belüli értékelésekről Androidon, kíváncsi voltam, hogy az én alkalmazásomban is implementáljam, de aztán utánanéztem, és megtudtam, hogy nem terveznek hivatalos kötést a Play Core-hoz. Azonban rátaláltam Patrick Getzman NuGetjére, amely már elvégezte a kötés létrehozásának nehéz munkáját. Abban az időben csak a Play Core v1.7.2 ellen volt kötve. Mivel v1.8-ra van szükség az alkalmazáson belüli felülvizsgálatokhoz, így egyszerűen létrehoztam egy problémát.

Kicsit később egy határidő kúszott elém, ezért úgy döntöttem, hogy halogatom a dolgot, és inkább találok valami tennivalót, és ekkor döntöttem úgy, hogy frissítem ezt a kötéskönyvtárat v1.8-ra. Sok egérgörgetéssel és billentyűkoppintással követtem ezt a Jonathan Dick által készített videót, és némi próbálkozás és hiba után működőképessé tettem a v1.8-as Android .AAR fájlt! Elküldtem egy PR-t, és a hivatalos Android dokumentáció segítségével frissíteni tudtam a példát Pat tárolójában. Csodálatos élmény volt, és örülök, hogy segíthettem hozzájárulni ehhez a kiváló funkcióhoz.

Remélem, hogy hasznosnak találtad, és ha használod ezt az alkalmazásodban, kérlek, oszd meg velem a képernyőképeket, vagy csak köszönj nekem!

Saamer Mansoor

Follow