SDK za simu na wavuti
SDK asilia za iOS, Android, React Native na Flutter huweka mtiririko ndani ya programu yako na ndizo njia pekee zinazounga mkono NFC. SDK za wavuti huweka mtiririko ndani ya frontend yako.
SDK asilia zipo kwa iOS, Android, React Native na Flutter; SDK za wavuti huweka mtiririko ndani ya frontend yako. Tumia SDK asilia unapohitaji NFC au tabia bora ya kamera - WebView haitoi lolote kati ya hayo. Matokeo bado hurudi kwa webhook, si kutoka SDK.
#Kwa nini SDK badala ya uelekezaji upya
Uelekezaji uliohifadhiwa ndio kazi ndogo zaidi na unafaa kabisa kwa mitiririko mingi. SDK inafaa unapohitaji:
- Unahitaji NFC. Chip iliyo kwenye pasipoti au kitambulisho haiwezi kusomwa kutoka ukurasa wa kivinjari. SDK asilia ndiyo njia pekee. Angalia uthibitishaji wa chip ya NFC.
- Hutaki mtumiaji aondoke kwenye programu yako. Kuelekezwa nje na kurudi ni sehemu halisi ya watu kuacha kwenye simu.
- Unataka tabia bora zaidi ya kamera. Ufikiaji wa kamera asilia ni wa kutegemewa zaidi kuliko wa kivinjari, hasa kwenye vifaa vya zamani.
#Zinazopatikana
| Jukwaa | Maelezo |
|---|---|
| iOS | Husambazwa kama XCFramework |
| Android | Husambazwa kupitia Maven |
| React Native | Huzungusha moduli asilia; inaunga mkono New Architecture |
| Flutter | Huzungusha moduli asilia |
| JavaScript / wavuti | Huweka mtiririko uliohifadhiwa ndani ya frontend yako ya wavuti |
| In-context iframe | Huonyesha mtiririko ndani ya ukurasa wako badala ya kuelekeza kwingine |

- Chagua jukwaa lako na ukurasa utakupa kipande cha msimbo cha mfumo huo.
- SDK asilia na za wavuti, kila moja ikiwa na mwongozo wake wa haraka, zimeunganishwa hapa.
Mahitaji ya toleo na kiwango cha chini cha jukwaa hubadilika na matoleo mapya, hivyo angalia hati za sasa za SDK badala ya picha ya ukurasa huu wa msaada - na ikiwa uko kwenye toleo maalum la mfumo (Expo SDK fulani, kwa mfano), thibitisha ulinganifu na mawasiliano yako ya Didit kabla ya kujitolea kwenye sprint.
#WebView si SDK asilia
Kufunga mtiririko wa wavuti uliohifadhiwa ndani ya WebView unaonekana kutoa uzoefu wa ndani ya programu. Unatoa mwonekano wa mmoja tu:
- Hakuna NFC. Chip bado haiwezi kusomwa.
- Ruhusa za kamera ni ngumu zaidi. Ufikiaji wa kamera wa WebView unategemea usanidi wa programu mwenyeji, na kuukosea husababisha ripoti hasa za "kamera haikuwahi kufunguka" zilizoelezwa katika kutatua matatizo ya liveness na kulinganisha uso.
- Lugha ni ya programu, si ya mtumiaji. WebView huripoti lugha ya programu mwenyeji, hivyo pitisha
languagemoja kwa moja unapounda kikao. Angalia kuweka lugha ya uthibitishaji.
Ikiwa unataabika kufikia mtiririko wa ndani ya programu, tumia SDK asilia.
#Matokeo bado yanatoka kwa webhooks
Hili huwakwaza watu: SDK inaiambia programu yako kwamba mtumiaji amemaliza mtiririko. Si chanzo cha mamlaka cha uamuzi wa uthibitishaji.
Uamuzi hutolewa upande wa seva baada ya ukaguzi kuendeshwa, na unakufikia kwa webhook. Kamwe usitoe ufikiaji kutokana na callback ya kumalizika ya SDK peke yake - ishara ya upande wa mteja inaweza kughushiwa kwa urahisi, na ukaguzi huenda hata haujamalizika wakati inapotokea.
Kuchukulia "SDK imesema imekamilika" kama "mtumiaji amethibitishwa" ndilo kosa lenye madhara makubwa zaidi linalowezekana katika muunganisho wa simu. Thibitisha kwenye seva yako, kutoka webhook au endpoint ya uamuzi, kabla ya kufungua chochote.
#Programu moja ya mtumiaji, au yako mwenyewe?
Hakuna programu tofauti ya Didit ya mtumiaji ambayo kikao kilichohifadhiwa huwapeleka watumiaji kwa hatua kama NFC. Ikiwa unataka kila kitu - NFC na yasiyo NFC - ndani ya uzoefu wa programu moja, programu hiyo ni yako, ikiwa na SDK imewekwa ndani yake.
#Usambazaji na migongano ya dependencies
Muunganisho wa SDK asilia mara kwa mara hugongana na dependencies nyingine kwenye programu mwenyeji - maktaba ya pamoja ya transitive, au subspec inayobana toleo ambalo kitu kingine pia kinabana. Ukikutana na hili, ni tatizo halisi, linaloweza kurudiwa linalofaa kuripotiwa pamoja na manifest yako ya dependencies badala ya kulizunguka kwa kubana kitu cha zamani: urekebishaji kwa kawaida unapaswa kuwa kwenye SDK.
#Kujaribu kwenye kifaa
Sandbox hufanya kazi vivyo hivyo kupitia SDK kama mahali pengine popote - elekeza programu kwenye ufunguo wa programu ya sandbox na kila ukaguzi hutolewa mock na haugharimu chochote. Hiyo ndiyo njia sahihi ya kurudia mtiririko wa simu, kwa sababu tabia za SDK unazohitaji zaidi kujaribu (maombi ya ruhusa, mzunguko wa maisha wa kamera, kuingia nyuma katikati ya kunasa) ni tabia za kifaa ambazo hazikugharimu chochote kuzirudia mara kwa mara. Angalia kujaribu kwenye sandbox.
