SDK asilia za iOS, Android, React Native na Flutter huweka mtiririko ndani ya programu yako na ndizo njia pekee ya NFC; SDK za wavuti huweka kwenye frontend.
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 |

iOS inasaidia Swift Package Manager na CocoaPods; ongeza ruhusa za kamera na NFC katika Info.plist inapohitajika. Android hutumia Maven. React Native inasaidia Expo kupitia toleo la maendeleo lenye moduli asilia, si Expo Go.
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
Chagua Sandbox kwa swichi chini ya jina la programu, unda ufunguo wa API wa majaribio na uutumie. Ukaguzi huigwa, hakuna malipo na unaweza kuchagua matokeo.
Bado umekwama? Zungumza na binadamu.
Weka kitambulisho cha shirika lako na kitambulisho cha kikao unachouliza kukihusu.
