Support Hub/Learn & Insights/SDK-ul furnizorului funcționează doar pe Windows, încă în…
Translated from the English article and reviewed by a person. Read the English original
Article

SDK-ul furnizorului funcționează doar pe Windows, încă în această epocă a AI-ului?

SDK-ul furnizorului funcționează doar pe Windows, încă în această epocă a AI-ului?

Dacă citiți acest articol, echipa dumneavoastră a spus probabil deja acest lucru. Echipamentul dumneavoastră biometric funcționează bine. Dispozitivul face exact ceea ce trebuie. Dar SDK-ul distribuit de producător pentru a comunica cu acesta este un DLL compilat pentru Windows, necesită un runtime Visual C++ specific, nu poate rula într-un container Docker, iar dezvoltatorii dumneavoastră lucrează pe Mac sau Linux. Dispozitivul nu este problema. Problema este SDK-ul. Acest articol explică exact de ce se întâmplă acest lucru, de ce fiecare soluție de ocolire încercată de echipa dumneavoastră eșuează în cele din urmă și cum arată alternativa arhitecturală.

 

Plângerile sunt consecvente în fiecare echipă de inginerie

Detaliile variază, dar modelul este mereu același. O organizație integrează echipamente biometrice, descoperă restricțiile SDK-ului târziu în proces și petrece un timp considerabil de inginerie pentru a ocoli o problemă care nu ar trebui să existe. Iată cum sună aceste plângeri în practică.

Ce spun echipele de inginerie, de fiecare dată
“SDK-ul este livrat doar ca DLL pentru Windows. Întregul nostru backend rulează pe Linux. A trebuit să pornim o mașină virtuală Windows dedicată doar pentru a rula integrarea biometrică.”
“Nu o putem containeriza. Docker este exclus. Kubernetes este exclus. Fiecare implementare este un proces manual pe un calculator care nu poate fi înlocuit fără reinstalarea SDK-ului și obținerea unei noi licențe.”
“Dezvoltatorii dumneavoastră lucrează toți pe Mac sau Linux. Nimeni nu poate rula integrarea local. Testarea necesită conectarea de la distanță la singurul calculator Windows din birou care are SDK-ul instalat.”
“SDK-ul necesită Visual C++ Redistributable 2010. Noul dezvoltator a petrecut trei zile pregătind mediul înainte de a scrie o singură linie de cod de integrare.”
“Am actualizat serverul la Windows Server 2022 și SDK-ul a încetat să funcționeze. Furnizorului i-au trebuit două săptămâni pentru a lansa o versiune actualizată, iar în această perioadă nu am avut date de prezență.”
“Pipeline-ul nostru CI/CD nu poate testa integrarea biometrică deloc. Fiecare test este manual. Fiecare lansare a integrării necesită ca cineva să stea fizic la calculatorul Windows și să o ruleze.”

De ce SDK-urile biometrice sunt doar pentru Windows: motivul real

Este tentant să presupunem că comunicarea cu echipamentele biometrice este atât de complexă încât necesită API-uri de sistem specifice Windows. Nu este cazul. Motivul real pentru care SDK-urile biometrice sunt doar pentru Windows este mult mai simplu și mult mai frustrant: acesta este mediul pentru care SDK-ul a fost scris inițial, iar de atunci nimeni nu a investit în schimbarea lui.

Majoritatea SDK-urilor pentru dispozitive biometrice au fost scrise în C sau C++ la începutul anilor 2000, vizând Windows, sistemul de operare desktop dominant în mediul enterprise al acelei epoci. Rezultatul compilat era un DLL, o Dynamic Link Library, care este un format binar specific Windows. Logica de comunicare, adică funcțiile care deschid o conexiune TCP către dispozitiv, decodează formatul pachetelor binare și returnează date structurate, a fost compilată în acest DLL și distribuită clienților.

La vremea respectivă, aceasta a fost o decizie rezonabilă. Software-ul enterprise rula pe Windows. Serverele rulau Windows. Dezvoltatorii foloseau Windows. Formatul DLL era mecanismul standard de distribuire a codului compilat reutilizabil în acel ecosistem. Nimic din această alegere nu era greșit având în vedere contextul.

Problema este că, între timp, contextul s-a schimbat complet, iar SDK-ul nu. Linux a devenit sistemul de operare dominant pentru servere. Mac a devenit stația de lucru dominantă pentru dezvoltatori. Containerele Docker au devenit unitatea standard de implementare. Infrastructura cloud-native a înlocuit serverele Windows on-premises. Dar SDK-ul biometric a rămas un DLL pentru Windows, deoarece rescrierea lui pentru distribuție multiplatformă necesită o investiție de inginerie pe care producătorul hardware are puține motive comerciale să o facă.

“SDK-ul nu a fost proiectat să fie ostil față de Linux sau Mac. A fost proiectat pentru o lume în care Linux și Mac nu erau acolo unde rula software-ul enterprise. Acea lume nu mai există. SDK-ul a rămas în urmă.”

Ce blochează SDK-ul doar pentru Windows într-un stack modern

Implicațiile unui SDK doar pentru Windows se propagă în fiecare strat al unui mediu modern de dezvoltare și implementare. Fiecare blocaj de mai jos reprezintă o restricție reală cu care se confruntă echipele de inginerie atunci când încearcă să integreze echipamente biometrice într-un stack software actual.

Docker și containerizare
Containerele Docker rulează pe Linux. Un DLL pentru Windows nu poate fi încărcat într-un container Linux. Orice serviciu care trebuie să apeleze SDK-ul trebuie să ruleze pe un calculator Windows dedicat sau într-un container Windows, care este mai greu, mai puțin portabil și mai scump de rulat decât un container Linux standard.
Servere cloud Linux
AWS, Google Cloud și Azure oferă mașini virtuale Linux ca opțiune standard și cea mai ieftină. Rularea unei mașini virtuale Windows special pentru a găzdui integrarea SDK-ului biometric costă mai mult și adaugă o sarcină operațională fără legătură cu funcția biometrică în sine.
Medii de dezvoltare Mac
Dezvoltatorii nu pot încărca, rula sau testa SDK-ul pe calculatoarele locale. Fiecare test al integrării necesită acces la singurul calculator Windows care are SDK-ul instalat. Ciclurile locale de feedback pentru dezvoltare, o cerință de bază a ingineriei productive, sunt eliminate pentru această parte a stack-ului.
Pipeline-uri CI/CD
Pipeline-urile automate de testare rulează pe agenți Linux. Testele unitare, testele de integrare și verificările automate de implementare nu pot include nicio cale de cod care apelează SDK-ul. Integrarea biometrică există complet în afara procesului automat de asigurare a calității.
Funcții serverless
AWS Lambda, Google Cloud Functions și Azure Functions rulează pe runtime-uri Linux gestionate. O arhitectură serverless pentru integrarea biometrică este imposibilă cu un DLL pentru Windows. Întreaga funcție trebuie înlocuită cu un proces Windows de lungă durată, ceea ce anulează modelul de cost și operare al serverless.
Orchestrare Kubernetes
Kubernetes gestionează containerele în clustere. Un serviciu care depinde de un SDK pentru Windows nu poate participa la orchestrarea standard Kubernetes fără pool-uri de noduri Windows, care sunt semnificativ mai complexe de configurat și mai scumpe de rulat decât pool-urile de noduri Linux standard.

Soluțiile de ocolire create de echipe și de ce eșuează în cele din urmă

În fața unui SDK doar pentru Windows și a unui stack modern, echipele de inginerie construiesc soluții de ocolire. Fiecare soluție rezolvă problema imediată, creând în același timp o nouă dependență structurală care va cauza mai târziu o altă problemă.

01
Mașina virtuală Windows dedicată
Se pregătește o mașină virtuală Windows special pentru a rula SDK-ul. Serviciul de integrare biometrică rulează pe această mașină virtuală și expune un API intern pe care îl apelează restul stack-ului. Aceasta creează un punct unic de defectare permanent, care nu poate fi înlocuit automat dacă cade, nu poate fi scalat orizontal și trebuie aplicat patch-uri și întreținut ca o responsabilitate separată de infrastructură.
Eșuează când: mașina virtuală este scoasă din uz, i se aplică patch-uri sau este migrată, iar SDK-ul se defectează.
02
Wrapper de interoperare COM
Se scrie un wrapper subțire în C# care încarcă DLL-ul și îl expune ca obiect COM sau ca serviciu HTTP local pe care îl pot apela alte procese. Aceasta adaugă o frontieră de limbaj, o frontieră de proces și o bază de cod nouă care trebuie întreținută. Dezvoltatorul care l-a scris este de obicei singura persoană care îl înțelege și, în cele din urmă, pleacă.
Eșuează când: SDK-ul se actualizează și wrapper-ul se defectează sau dezvoltatorul original părăsește echipa.
03
Wine pe Linux
Wine este un strat de compatibilitate care permite rularea unor binare Windows pe Linux. Unele echipe încearcă să ruleze DLL-ul SDK-ului biometric sub Wine. Aceasta funcționează intermitent pentru SDK-uri simple și eșuează imprevizibil pentru cele complexe care se bazează pe apeluri de sistem specifice Windows. Furnizorul SDK-ului nu oferă suport pentru implementările bazate pe Wine.
Eșuează când: SDK-ul apelează un API Windows pe care Wine nu îl implementează, ceea ce este frecvent.
04
Windows Subsystem for Linux
WSL2 permite rularea proceselor Linux pe Windows și invers. Unele echipe instalează SDK-ul pe un calculator Windows și îl expun printr-o punte WSL2. Acesta este un instrument de comoditate pentru dezvoltatori, folosit ca soluție de integrare în producție. Nu este conceput pentru sarcini de producție și introduce instabilitate la frontiera WSL sub încărcare susținută.
Eșuează când: actualizările WSL strică puntea sau încărcarea provoacă instabilitate la nivelul stratului de frontieră.
05
Python ctypes sau cffi
Biblioteca ctypes din Python permite apelarea directă a funcțiilor C dintr-un DLL compilat, direct din codul Python. Aceasta poate funcționa pe Windows pentru interfețe DLL simple. Necesită gestionare manuală a memoriei, mapare atentă a tipurilor și cunoștințe profunde despre convențiile de apelare ale DLL-ului. Este fragilă, în majoritatea cazurilor nedocumentată și complet neportabilă pe orice platformă non-Windows.
Eșuează când: interfața DLL se schimbă într-o actualizare, ceea ce se va întâmpla, fără nicio garanție de versionare.
Modelul comun al tuturor soluțiilor de ocolire

Fiecare soluție de ocolire acceptă DLL-ul pentru Windows ca o constrângere fixă și construiește în jurul lui. Niciuna nu elimină constrângerea. Toate adaugă complexitate, suprafață de întreținere și noi moduri de defectare. Soluția corectă nu este construirea unei soluții de ocolire mai bune. Este eliminarea completă a dependenței de DLL.

Cum arată arhitectura alternativă

DLL-ul pentru Windows există deoarece producătorul dispozitivului trebuia să ofere dezvoltatorilor o modalitate de a comunica cu protocolul binar proprietar al dispozitivului, fără a expune chiar protocolul. DLL-ul este stratul de abstractizare între formatul binar de transmisie și codul dezvoltatorului.

Acest strat de abstractizare nu trebuie să fie un DLL. Poate fi un server HTTP care vorbește JSON. Serverul gestionează protocolul binar pe o parte și expune un API pe cealaltă. Dezvoltatorii apelează API-ul folosind biblioteci client HTTP standard, care rulează pe orice platformă, în orice limbaj, în orice container, prin orice pipeline CI/CD, pe orice laptop de dezvoltator, indiferent de sistemul de operare.

Abordarea SDK

DLL pentru Windows instalat pe un anumit calculator. Apelat prin FFI sau wrapper specific limbajului. Legat de sistemul de operare și de versiunea runtime-ului. Nu poate fi containerizat. Nu poate fi testat în CI. Se defectează la actualizările sistemului de operare. Un SDK pentru fiecare marcă de dispozitiv.

Abordarea Biometric Gateway

Două tipuri de API, fiecare cu un rol diferit. Callback API transmite evenimentele în timp real de la dispozitiv către serverul dumneavoastră, cu latență zero. RESTful API primește comenzi de la serverul dumneavoastră către dispozitiv, cu un timp de execuție de aproximativ 15 secunde. Ambele folosesc JSON peste HTTP/HTTPS, cu criptare AES-256 opțională. Orice limbaj, orice sistem de operare, complet containerizabil, testabil în orice mediu CI.

Niciunul dintre tipurile de API nu necesită modificarea dispozitivului. Dispozitivul continuă să vorbească protocolul său binar proprietar. Biometric Gateway se află între dispozitivele dumneavoastră și aplicație, gestionând intern toată traducerea protocolului. Motorul său de protocol gestionează procesarea sigură a autentificării, jurnalizarea tranzacțiilor de date, traducerea protocolului și cache-ul offline și coada pentru perioadele în care dispozitivele sunt temporar inaccesibile. Stratul său de API standardizat gestionează managementul identităților, integrarea AI și MCP, distribuirea callback-urilor, rutarea comenzilor REST și normalizarea datelor pentru toate mărcile de dispozitive suportate.

Ce se schimbă pentru echipa dumneavoastră de dezvoltare

Atunci când SDK-ul este înlocuit cu un API, schimbările practice ale fluxului de lucru de dezvoltare sunt semnificative. Nu sunt îmbunătățiri incrementale. Reprezintă eliminarea unor categorii întregi de fricțiune pe care echipa dumneavoastră le-a normalizat.

Sarcină de dezvoltare Cu SDK pentru Windows Cu API
Configurarea mediului pentru un dezvoltator nou Ore până la zile, mașină virtuală Windows + instalare SDK + licență + dependențe runtime Minute, adăugați un URL de bază al API-ului și un token de autentificare în variabilele de mediu
Dezvoltare și testare locală Necesită acces de la distanță la calculatorul Windows cu SDK-ul Funcționează pe orice laptop, pe orice sistem de operare, cu orice instrument client HTTP
Integrarea în pipeline-ul CI/CD Imposibil pe agenții Linux standard Apeluri HTTP standard, funcționează în orice mediu CI
Implementare containerizată Necesită container Windows sau mașină virtuală dedicată Orice container Linux, de orice dimensiune, complet orchestrabil
Adăugarea unei a doua mărci de dispozitive SDK nou, DLL nou, wrapper nou, documentație nouă Aceeași suprafață de Callback și RESTful API, indiferent de marcă
Depanarea unei operațiuni eșuate Jurnale de protocol binar, adesea nedocumentate Coduri standard de răspuns HTTP și corpuri de eroare JSON
Impactul actualizărilor de sistem de operare sau runtime Poate afecta compatibilitatea SDK-ului, necesită actualizare de la furnizor Fără impact asupra codului client

Cele două tipuri de API: ce scrie efectiv dezvoltatorul dumneavoastră

Pentru a face contrastul concret, iată cum funcționează cele două tipuri de API în practică. RESTful API este apelat de serverul dumneavoastră pentru a trimite o comandă către dispozitiv. Callback API este invers: Gateway-ul apelează serverul dumneavoastră pentru a transmite un eveniment în timp real. Dezvoltatorul dumneavoastră scrie un receptor pentru unul și un apelant pentru celălalt. Ambele folosesc JSON peste HTTP/HTTPS. Niciunul nu necesită un DLL, o mașină Windows sau instalarea vreunui SDK.

Callback API, cerere, trimisă serverului dumneavoastră de Gateway
{
  "RealTime": {
    "OperationID": "9nu1wak5616p",
    "LabelName": "Burj Khalifa",
    "SerialNumber": "ZHM11xxxxxxxx",
    "PunchLog": {
      "Type": "CheckOut",
      "Temperature": "36.8",
      "FaceMask": false,
      "InputType": "Fingerprint",
      "UserId": "2",
      "LogTime": "2020-09-17 07:48:22 GMT +0530"
    },
    "AuthToken": "COJJ7eiIPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 04:19:03 GMT +0000"
  }
}
Callback API, răspuns, serverul dumneavoastră trebuie să returneze acest lucru către Gateway
{ "status": "done" }

Apelul API se face folosind orice bibliotecă HTTP din orice limbaj: requests din Python, fetch din Node, net/http din Go, cURL într-un script shell. Funcționează identic pe un laptop Mac, pe un runner CI Linux, pe un container Docker din Kubernetes și într-o funcție serverless. Payload-ul Callback API ajunge la endpoint-ul webhook expus de serverul dumneavoastră, în același format JSON, indiferent de marca dispozitivului sau de tipul de intrare care a generat evenimentul. Amprentă, recunoaștere facială, venă palmară, card RFID, PIN, cod QR sau cod de bare: structura pe care o primește serverul dumneavoastră este întotdeauna aceeași. Fără DLL. Fără dependență de runtime. Fără cerința Windows. Fără fișier de licență de gestionat.

Ce înseamnă aceasta concret pentru echipa dumneavoastră

Un dezvoltator care se alătură echipei dumneavoastră săptămâna viitoare poate clona depozitul, adăuga datele de autentificare ale Gateway-ului în fișierul de mediu și poate face primul apel reușit către un dispozitiv biometric în câteva minute de la începerea lucrului. Pentru RESTful API scrie o cerere HTTP POST standard. Pentru Callback API scrie un receptor HTTP standard. Niciunul nu necesită un calculator Windows, un program de instalare SDK, o cheie de licență de la furnizor sau cunoașterea protocoalelor binare ale dispozitivelor. Se integrează cu Gateway-ul exact așa cum se integrează cu orice alt serviciu JSON din stack-ul dumneavoastră.

Întrebări frecvente

Înlocuirea SDK-ului cu un API înseamnă că pierdem anumite funcționalități ale dispozitivului?
Cams Biometrics Gateway expune 38 de operațiuni biometrice pe ambele tipuri de API. RESTful API gestionează comenzile pe care serverul dumneavoastră le trimite către dispozitiv, precum adăugarea utilizatorilor, ștergerea înregistrărilor, încărcarea jurnalelor și înrolarea datelor biometrice. Callback API livrează evenimentele în timp real de la dispozitiv către serverul dumneavoastră, inclusiv înregistrările de prezență de la intrările pe bază de amprentă, recunoaștere facială, venă palmară, card RFID, PIN, cod QR și cod de bare. În majoritatea cazurilor, Gateway-ul expune mai multe capabilități decât o anumită versiune a SDK-ului producătorului, deoarece lucrează direct cu protocolul dispozitivului. Verificați compatibilitatea pentru modelul dumneavoastră specific de dispozitiv împreună cu echipa de suport Cams înainte de migrare.
Am construit deja un wrapper consistent în jurul SDK-ului. Cât din acesta trebuie să aruncăm?
Logica de business din wrapper-ul dumneavoastră, regulile privind ce angajați primesc ce niveluri de acces, maparea dintre ID-urile din HRMS și ID-urile utilizatorilor de pe dispozitive, logica de gestionare a erorilor și a reîncercărilor, toate acestea pot fi reutilizate. Ceea ce înlocuiți este stratul care apelează funcțiile DLL. În loc să apelați funcțiile SDK-ului, faceți cereri HTTP. Logica de deasupra acestui strat rămâne aceeași. În majoritatea cazurilor, înlocuirea SDK-ului este o schimbare mai mică decât pare din exterior.
Este un API mai puțin fiabil decât o conexiune directă prin SDK?
Nu în mod inerent. Gateway-ul menține o conexiune persistentă cu dispozitivul și include un cache și o coadă offline care stochează operațiunile atunci când un dispozitiv este temporar inaccesibil. Evenimentele nu se pierd în timpul întreruperilor de conectivitate și sunt livrate endpoint-ului dumneavoastră de Callback atunci când conexiunea este restabilită. Fiabilitatea conexiunii cu dispozitivul este determinată de infrastructura Gateway-ului, nu de faptul că aplicația dumneavoastră comunică prin HTTP sau prin apeluri DLL. Un gateway bine operat va avea o disponibilitate mai mare decât majoritatea echipelor pot obține cu o instalare SDK gestionată intern pe o singură mașină virtuală Windows.
Ce se întâmplă cu latența? Saltul suplimentar prin rețea adaugă o întârziere semnificativă?
Pentru majoritatea operațiunilor biometrice, saltul suplimentar prin rețea adaugă câteva milisecunde. Callback-urile de prezență sunt livrate în timp real, Gateway-ul trimițând datele către endpoint-ul dumneavoastră webhook, deci modelul de latență este similar cu cel al unei conexiuni directe SDK care primește un eveniment. Pentru operațiunile de scriere, precum adăugarea unui utilizator, timpul total de răspuns este dominat de timpul de procesare al dispozitivului, care este de 1 până la 3 secunde indiferent de modul în care a sosit instrucțiunea. Saltul HTTP nu este blocajul.
Putem folosi API-ul din backend-ul nostru existent în Python sau Node.js fără o bibliotecă client specială?
Da. API-ul folosește HTTP standard cu corpuri JSON. Orice bibliotecă client HTTP, în orice limbaj, funcționează fără modificări. Nu aveți nevoie de un SDK special, de o bibliotecă client publicată de furnizorul gateway-ului sau de vreun pachet specific limbajului. Dacă puteți face o cerere HTTP POST cu un corp JSON, puteți apela API-ul. Aceasta este întreaga suprafață de integrare din perspectiva aplicației dumneavoastră.

Concluzie: problema SDK-ului are o soluție clară

Un SDK biometric doar pentru Windows nu este un fapt de viață cu care echipa dumneavoastră de inginerie trebuie să se descurce la nesfârșit. Este consecința unei decizii de distribuție luate acum două decenii, într-un peisaj infrastructural diferit. Această decizie poate fi înlocuită de un gateway care absoarbe complexitatea protocolului binar și expune dispozitivul printr-un API standard.

Atunci când această tranziție are loc, mașina virtuală Windows dedicată este scoasă din uz. Pipeline-ul CI/CD primește înapoi integrarea biometrică. Noul dezvoltator își configurează mediul local în câteva minute. Containerul Docker rulează fără configurare specială. Dezvoltatorii Mac nu mai trebuie să se conecteze de la distanță la singurul calculator din birou care are licența SDK-ului instalată. Acestea nu sunt îmbunătățiri minore ale calității vieții. Reprezintă eliminarea unei constrângeri structurale care a consumat ani de zile din timpul și răbdarea echipei dumneavoastră de inginerie.

Cams Biometrics Gateway înlocuiește complet SDK-ul pentru Windows. Se conectează la dispozitivele dumneavoastră biometrice de la Cams, ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime, Biomax, Secugen, eSSL, Matrix și altele, folosind protocoalele lor native, fără instalarea vreunui SDK nicăieri în infrastructura dumneavoastră. Expune 38 de operațiuni pe două tipuri de API: un Callback API care transmite evenimentele în timp real de la dispozitive către serverul dumneavoastră, cu latență zero, și un RESTful API care primește comenzi de la serverul dumneavoastră către dispozitiv. Toată comunicarea se face prin JSON peste HTTP/HTTPS, cu criptare AES-256 opțională. Integrarea nativă MCP înseamnă că Claude, Gemini și ChatGPT pot apela direct operațiuni biometrice. Cache-ul și coada offline gestionează automat întreruperile de conectivitate. Gateway-ul funcționează identic indiferent dacă stack-ul dumneavoastră rulează pe Linux, Mac, Windows, Docker, Kubernetes sau funcții serverless. Fără DLL. Fără Visual C++ Redistributable. Fără mașină Windows dedicată. Fără fișier de licență. Explorați API-ul complet la CamsBiometrics.com pentru informații despre migrarea integrării dumneavoastră SDK existente.

 

Was this article helpful?