# SDK za simu na wavuti

Source: https://help.didit.me/sw/integration/mobile-sdks
Updated: 2026-10-12

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

[Video: Mwongozo kamili wa uunganisho - Didit Academy](https://www.youtube.com/watch?v=fX03-WEu_EI)

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](https://help.didit.me/sw/documents-coverage/nfc-chip-verification).
- **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

[Video: Chagua SDK sahihi ya Didit - Didit Academy](https://www.youtube.com/watch?v=qHada8ZY24Q&t=14)

| 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 |

![Ukurasa wa Integrate katika console ya Didit ukiwa na viungo vya SDK na hati](https://help.didit.me/screenshots/integrate-light.webp)

*Kila SDK huanzia ukurasa uleule kama API.*

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](https://docs.didit.me/integration/native-sdks/overview) 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](https://help.didit.me/sw/liveness-biometrics/liveness-and-face-match-issues).
- **Lugha ni ya programu, si ya mtumiaji.** WebView huripoti lugha ya programu mwenyeji, hivyo pitisha `language` moja kwa moja unapounda kikao. Angalia [kuweka lugha ya uthibitishaji](https://help.didit.me/sw/workflows/verification-languages).

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](https://help.didit.me/sw/integration/webhooks-basics). 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.

> **Warning:** 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.

[kujaribu kwenye sandbox](https://help.didit.me/sw/getting-started/sandbox-and-testing)