Support Hub/Learn & Insights/SDK dari vendor Anda hanya berjalan di Windows, masih di…
Translated from the English article and reviewed by a person. Read the English original
Article

SDK dari vendor Anda hanya berjalan di Windows, masih di dekade AI ini?

SDK dari vendor Anda hanya berjalan di Windows, masih di dekade AI ini?

Jika Anda membaca ini, tim Anda kemungkinan besar sudah pernah mengatakannya. Perangkat keras biometrik Anda berfungsi dengan baik. Perangkat melakukan persis apa yang seharusnya dilakukannya. Tetapi SDK yang didistribusikan produsen untuk berkomunikasi dengannya adalah DLL Windows yang sudah dikompilasi, membutuhkan Visual C++ runtime tertentu, tidak dapat berjalan di dalam kontainer Docker, dan pengembang Anda menggunakan Mac atau Linux. Perangkatnya bukan masalahnya. SDK-lah masalahnya. Artikel ini menjelaskan secara rinci mengapa hal itu terjadi, mengapa setiap solusi sementara yang sudah dicoba tim Anda pada akhirnya gagal, dan seperti apa alternatif arsitekturnya.

 

Keluhan Ini Konsisten di Setiap Tim Engineering

Detailnya bervariasi, tetapi polanya selalu sama. Sebuah organisasi mengintegrasikan perangkat keras biometrik, menemukan kendala SDK di tahap akhir proses, dan menghabiskan waktu engineering yang signifikan untuk mengatasi masalah yang seharusnya tidak ada. Berikut adalah bunyi keluhan-keluhan tersebut dalam praktiknya.

Yang selalu dikatakan tim engineering
“SDK hanya tersedia sebagai Windows DLL. Seluruh backend kami berjalan di Linux. Kami harus menyiapkan VM Windows khusus hanya untuk menjalankan integrasi biometrik.”
“Kami tidak bisa mengemasnya dalam kontainer. Docker tidak bisa digunakan. Kubernetes tidak bisa digunakan. Setiap deployment adalah proses manual di mesin yang tidak bisa diganti tanpa menginstal ulang SDK dan mendapatkan lisensi baru.”
“Pengembang Anda semua menggunakan Mac atau Linux. Tidak ada yang bisa menjalankan integrasi ini secara lokal. Pengujian membutuhkan akses remote ke satu-satunya mesin Windows di kantor yang terpasang SDK.”
“SDK membutuhkan Visual C++ Redistributable 2010. Pengembang baru menghabiskan tiga hari untuk menyiapkan lingkungan kerja sebelum menulis satu baris kode integrasi pun.”
“Kami memperbarui server ke Windows Server 2022 dan SDK berhenti berfungsi. Vendor membutuhkan waktu dua minggu untuk merilis versi terbaru dan kami tidak memiliki data kehadiran selama periode tersebut.”
“Pipeline CI/CD kami tidak bisa menguji integrasi biometrik sama sekali. Setiap pengujian dilakukan secara manual. Setiap rilis integrasi ini membutuhkan seseorang untuk duduk langsung di mesin Windows dan menjalankannya.”

Mengapa SDK Biometrik Hanya untuk Windows: Alasan Sebenarnya

Mudah untuk berasumsi bahwa komunikasi perangkat keras biometrik sangat kompleks sehingga membutuhkan API sistem khusus Windows. Ini tidak benar. Alasan sebenarnya mengapa SDK biometrik hanya untuk Windows jauh lebih sederhana dan lebih membuat frustrasi: itulah lingkungan tempat SDK awalnya ditulis, dan sejak itu tidak ada yang berinvestasi untuk mengubahnya.

Sebagian besar SDK perangkat biometrik ditulis dengan C atau C++ pada awal tahun 2000-an, dengan menargetkan Windows sebagai sistem operasi desktop perusahaan yang dominan pada masa itu. Hasil kompilasinya berupa DLL, Dynamic Link Library, yaitu format biner khusus Windows. Logika komunikasi, yaitu fungsi-fungsi yang membuka koneksi TCP ke perangkat, mendekode format paket biner, dan mengembalikan data terstruktur, dikompilasi ke dalam DLL ini dan didistribusikan kepada pelanggan.

Pada saat itu, ini adalah keputusan yang masuk akal. Perangkat lunak perusahaan berjalan di Windows. Server menjalankan Windows. Pengembang menggunakan Windows. Format DLL adalah mekanisme distribusi standar untuk kode terkompilasi yang dapat digunakan kembali dalam ekosistem tersebut. Tidak ada yang salah dengan pilihan ini jika dilihat dari konteksnya.

Masalahnya adalah konteksnya sudah berubah sepenuhnya, sementara SDK tidak. Linux menjadi sistem operasi server yang dominan. Mac menjadi workstation pengembang yang dominan. Kontainer Docker menjadi unit deployment standar. Infrastruktur cloud-native menggantikan server Windows on-premises. Namun SDK biometrik tetap berupa Windows DLL, karena menulis ulangnya untuk distribusi lintas platform membutuhkan investasi engineering yang hampir tidak memiliki insentif komersial bagi produsen perangkat keras.

“SDK ini tidak dirancang untuk memusuhi Linux atau Mac. SDK ini dirancang untuk dunia di mana Linux dan Mac bukanlah tempat perangkat lunak perusahaan berjalan. Dunia itu tidak lagi ada. SDK-nya tertinggal.”

Apa yang Diblokir oleh SDK khusus Windows dalam Stack Modern

Dampak SDK khusus Windows menjalar ke setiap lapisan pengaturan pengembangan dan deployment modern. Setiap hambatan di bawah ini mewakili kendala nyata yang dihadapi tim engineering ketika mencoba mengintegrasikan perangkat keras biometrik ke dalam stack perangkat lunak generasi terkini.

Docker dan containerisation
Kontainer Docker berjalan di Linux. Windows DLL tidak dapat dimuat di dalam kontainer Linux. Setiap layanan yang perlu memanggil SDK harus berjalan di mesin Windows murni atau kontainer Windows, yang lebih berat, kurang portabel, dan lebih mahal untuk dijalankan dibandingkan kontainer Linux standar.
Server cloud Linux
AWS, Google Cloud, dan Azure semuanya menawarkan mesin virtual Linux sebagai opsi server standar dan termurah. Menjalankan VM Windows khusus untuk menampung integrasi SDK biometrik lebih mahal dan menambah beban operasional yang tidak ada hubungannya dengan fungsi biometrik itu sendiri.
Lingkungan pengembangan Mac
Pengembang tidak dapat memuat, menjalankan, atau menguji SDK di mesin lokal mereka. Setiap pengujian integrasi membutuhkan akses ke satu-satunya mesin Windows yang terpasang SDK. Siklus umpan balik pengembangan lokal, yang merupakan persyaratan dasar engineering yang produktif, menjadi hilang untuk bagian stack ini.
Pipeline CI/CD
Pipeline pengujian otomatis berjalan di agen Linux. Pengujian unit, pengujian integrasi, dan pemeriksaan deployment otomatis tidak dapat menyertakan jalur kode apa pun yang memanggil SDK. Integrasi biometrik sepenuhnya berada di luar proses penjaminan kualitas otomatis.
Serverless functions
AWS Lambda, Google Cloud Functions, dan Azure Functions berjalan di runtime Linux yang dikelola. Arsitektur serverless untuk integrasi biometrik tidak mungkin dilakukan dengan Windows DLL. Seluruh fungsi harus diganti dengan proses Windows yang berjalan lama, yang menggagalkan model biaya dan operasional serverless.
Orkestrasi Kubernetes
Kubernetes mengelola kontainer di seluruh cluster. Layanan yang bergantung pada SDK Windows tidak dapat ikut dalam orkestrasi Kubernetes standar tanpa node pool Windows, yang jauh lebih rumit untuk dikonfigurasi dan lebih mahal untuk dijalankan dibandingkan node pool Linux standar.

Solusi Sementara yang Dibangun Tim dan Mengapa Semuanya Akhirnya Gagal

Menghadapi SDK khusus Windows dan stack modern, tim engineering membangun solusi sementara. Setiap solusi sementara mengatasi masalah langsung sambil menciptakan ketergantungan struktural baru yang akan menimbulkan masalah lain di kemudian hari.

01
VM Windows khusus
Sebuah mesin virtual Windows disiapkan khusus untuk menjalankan SDK. Layanan integrasi biometrik berjalan di VM ini dan menyediakan API internal yang dipanggil oleh bagian stack lainnya. Hal ini menciptakan single point of failure permanen yang tidak dapat diganti secara otomatis jika mati, tidak dapat diskalakan secara horizontal, dan harus di-patch serta dipelihara sebagai tanggung jawab infrastruktur yang terpisah.
Gagal ketika: VM dihentikan, di-patch, atau dipindahkan dan SDK rusak.
02
Wrapper interop COM
Sebuah wrapper tipis ditulis dalam C# yang memuat DLL dan mengeksposnya sebagai objek COM atau layanan HTTP lokal yang dapat dipanggil proses lain. Hal ini menambah batas bahasa, batas proses, dan basis kode baru yang harus dipelihara. Pengembang yang menulisnya biasanya satu-satunya orang yang memahaminya, dan pada akhirnya mereka pun pergi.
Gagal ketika: SDK diperbarui dan wrapper rusak, atau pengembang aslinya keluar dari tim.
03
Wine di Linux
Wine adalah lapisan kompatibilitas yang memungkinkan beberapa binary Windows berjalan di Linux. Beberapa tim mencoba menjalankan DLL SDK biometrik di bawah Wine. Cara ini berhasil secara tidak menentu untuk SDK sederhana dan gagal secara tidak dapat diprediksi untuk SDK kompleks yang bergantung pada system call khusus Windows. Dukungan dari vendor SDK tidak tersedia untuk deployment berbasis Wine.
Gagal ketika: SDK memanggil API Windows yang tidak diimplementasikan oleh Wine, yang merupakan hal umum.
04
Windows Subsystem for Linux
WSL2 memungkinkan proses Linux berjalan di Windows dan sebaliknya. Beberapa tim memasang SDK di mesin Windows dan mengeksposnya melalui jembatan WSL2. Ini adalah alat kenyamanan pengembang yang dialihfungsikan menjadi pendekatan integrasi produksi. Alat ini tidak dirancang untuk beban kerja produksi dan menimbulkan ketidakstabilan di batas WSL saat beban berkelanjutan.
Gagal ketika: pembaruan WSL merusak jembatan atau beban menyebabkan ketidakstabilan di lapisan batas.
05
Python ctypes atau cffi
Library ctypes Python memungkinkan pemanggilan fungsi C dari DLL terkompilasi langsung dari kode Python. Ini bisa berfungsi di Windows untuk antarmuka DLL yang sederhana. Dibutuhkan pengelolaan memori manual, pemetaan tipe yang cermat, dan pengetahuan mendalam tentang calling convention DLL tersebut. Solusi ini rapuh, dalam banyak kasus tidak terdokumentasi, dan sepenuhnya tidak portabel ke platform non-Windows.
Gagal ketika: antarmuka DLL berubah dalam pembaruan, yang pasti akan terjadi, tanpa jaminan versioning.
Pola yang dimiliki semua solusi sementara

Setiap solusi sementara menerima Windows DLL sebagai kendala tetap dan membangun di atasnya. Tidak ada satu pun yang menghilangkan kendala tersebut. Semuanya menambah kompleksitas, menambah beban pemeliharaan, dan menambah mode kegagalan baru. Solusi yang tepat bukanlah membangun solusi sementara yang lebih baik. Solusinya adalah menghilangkan ketergantungan DLL sepenuhnya.

Seperti Apa Arsitektur Alternatifnya

Windows DLL ada karena produsen perangkat perlu memberi pengembang cara untuk berkomunikasi dengan protokol biner milik perangkat tanpa mengungkap protokol itu sendiri. DLL adalah lapisan abstraksi antara format kabel biner dan kode pengembang.

Lapisan abstraksi itu tidak harus berupa DLL. Lapisan itu bisa berupa server HTTP yang menggunakan JSON. Server menangani protokol biner di satu sisi dan menyediakan API di sisi lain. Pengembang memanggil API menggunakan library klien HTTP standar yang berjalan di setiap platform, dalam setiap bahasa, di dalam setiap kontainer, melalui setiap pipeline CI/CD, di setiap laptop pengembang terlepas dari sistem operasinya.

Pendekatan SDK

Windows DLL terpasang di mesin tertentu. Dipanggil menggunakan FFI atau wrapper khusus bahasa. Terikat pada sistem operasi dan versi runtime. Tidak dapat dikontainerisasi. Tidak dapat diuji di CI. Rusak saat pembaruan OS. Satu SDK untuk setiap merek perangkat.

Pendekatan Biometric Gateway

Dua jenis API, masing-masing menjalankan tugas yang berbeda. Callback API mengirimkan event real-time dari perangkat ke server Anda dengan latensi nol. RESTful API menerima perintah dari server Anda ke perangkat dengan waktu eksekusi sekitar 15 detik. Keduanya menggunakan JSON melalui HTTP/HTTPS dengan enkripsi AES-256 opsional. Bahasa apa pun, OS apa pun, sepenuhnya dapat dikontainerisasi, dapat diuji di lingkungan CI mana pun.

Kedua jenis API tidak mengharuskan perangkat berubah. Perangkat tetap menggunakan protokol biner milik sendiri. Biometric Gateway berada di antara perangkat dan aplikasi Anda, menangani seluruh terjemahan protokol secara internal. Protocol Engine-nya mengelola pemrosesan autentikasi yang aman, pencatatan transaksi data, terjemahan protokol, serta cache dan antrean offline untuk saat perangkat sementara tidak dapat dijangkau. Standardised API Layer-nya menangani manajemen identitas, integrasi AI dan MCP, dispatch callback, perutean perintah REST, dan normalisasi data di seluruh merek perangkat yang didukung.

Yang Berubah bagi Tim Pengembangan Anda

Ketika SDK digantikan oleh API, perubahan praktis pada alur kerja pengembangan Anda sangat signifikan. Perubahan ini bukan peningkatan bertahap. Ini adalah penghilangan seluruh kategori gesekan yang selama ini sudah dianggap wajar oleh tim Anda.

Tugas pengembangan Dengan SDK Windows Dengan API
Penyiapan lingkungan pengembangan baru Berjam-jam hingga berhari-hari, VM Windows + instalasi SDK + lisensi + dependensi runtime Hitungan menit, tambahkan base URL API dan auth token ke variabel lingkungan
Pengembangan dan pengujian lokal Membutuhkan akses remote ke mesin Windows yang terpasang SDK Berfungsi di laptop apa pun, OS apa pun, dengan alat HTTP client apa pun
Integrasi pipeline CI/CD Tidak memungkinkan di agen Linux standar Panggilan HTTP standar, berfungsi di lingkungan CI mana pun
Deployment dalam kontainer Membutuhkan kontainer Windows atau VM khusus Kontainer Linux apa pun, ukuran apa pun, sepenuhnya dapat diorkestrasi
Menambahkan merek perangkat kedua SDK baru, DLL baru, wrapper baru, dokumentasi baru Permukaan Callback dan RESTful API yang sama, terlepas dari mereknya
Men-debug operasi yang gagal Log protokol biner, sering kali tidak terdokumentasi Kode respons HTTP standar dan body error JSON
Dampak pembaruan OS atau runtime Dapat merusak kompatibilitas SDK, membutuhkan pembaruan dari vendor Tidak berdampak pada kode klien

Dua Jenis API: Apa yang Sebenarnya Ditulis Pengembang Anda

Agar perbedaannya lebih konkret, berikut cara kedua jenis API bekerja dalam praktik. RESTful API dipanggil oleh server Anda untuk mengirim perintah ke perangkat. Callback API adalah kebalikannya: Gateway memanggil server Anda untuk mengirimkan event real-time. Pengembang Anda menulis receiver untuk salah satunya dan caller untuk yang lainnya. Keduanya menggunakan JSON melalui HTTP/HTTPS. Tidak ada yang membutuhkan DLL, mesin Windows, atau instalasi SDK apa pun.

Callback API, Permintaan, dikirim ke server Anda oleh 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, Respons, server Anda harus mengembalikan ini ke Gateway
{ "status": "done" }

Panggilan API dilakukan menggunakan library HTTP apa pun dalam bahasa apa pun: requests di Python, fetch di Node, net/http di Go, cURL dalam shell script. Ini berfungsi sama persis di laptop Mac, runner CI Linux, kontainer Docker di Kubernetes, dan serverless function. Payload Callback API dikirim ke endpoint webhook mana pun yang disediakan server Anda, dalam format JSON yang sama terlepas dari merek perangkat atau jenis input yang menghasilkan event tersebut. Sidik jari, pengenalan wajah, pembuluh vena telapak tangan, kartu RFID, PIN, kode QR, atau barcode: struktur yang diterima server Anda selalu sama. Tidak ada DLL. Tidak ada dependensi runtime. Tidak ada kebutuhan Windows. Tidak ada file lisensi yang perlu dikelola.

Apa artinya bagi tim Anda

Pengembang yang bergabung dengan tim Anda minggu depan dapat meng-clone repositori, menambahkan kredensial Gateway ke file lingkungannya, dan melakukan panggilan pertama yang berhasil ke perangkat biometrik dalam hitungan menit setelah mulai bekerja. Untuk RESTful API, mereka menulis HTTP POST standar. Untuk Callback API, mereka menulis HTTP receiver standar. Keduanya tidak membutuhkan mesin Windows, installer SDK, kunci lisensi vendor, atau pengetahuan tentang protokol perangkat biner. Mereka berintegrasi dengan Gateway persis seperti mereka berintegrasi dengan layanan JSON lain di stack Anda.

Pertanyaan yang Sering Diajukan

Apakah mengganti SDK dengan API berarti kami kehilangan fungsi perangkat tertentu?
Cams Biometrics Gateway menyediakan 38 operasi biometrik di kedua jenis API. RESTful API menangani perintah yang dikirim server Anda ke perangkat, seperti menambahkan pengguna, menghapus data, memuat log, dan mendaftarkan biometrik. Callback API mengirimkan event real-time dari perangkat ke server Anda, termasuk punch kehadiran dari input sidik jari, pengenalan wajah, pembuluh vena telapak tangan, kartu RFID, PIN, kode QR, dan barcode. Dalam sebagian besar kasus, Gateway menyediakan kemampuan yang lebih banyak dibandingkan versi SDK dari produsen tertentu, karena bekerja langsung dengan protokol perangkat. Verifikasi kompatibilitas untuk model perangkat spesifik Anda bersama tim dukungan Cams sebelum bermigrasi.
Kami sudah membangun wrapper yang cukup besar di sekitar SDK. Berapa banyak yang harus kami buang?
Logika bisnis di wrapper Anda, yaitu aturan tentang karyawan mana yang mendapatkan tingkat akses tertentu, pemetaan antara ID HRMS Anda dan ID pengguna perangkat, serta logika penanganan error dan retry, semuanya dapat digunakan kembali. Yang diganti adalah lapisan yang memanggil fungsi DLL. Alih-alih memanggil fungsi SDK, Anda membuat permintaan HTTP. Logika di atas lapisan itu tetap sama. Dalam sebagian besar kasus, penggantian SDK adalah perubahan yang lebih kecil daripada yang terlihat dari luar.
Apakah API kurang andal dibandingkan koneksi SDK langsung?
Tidak secara inheren. Gateway mempertahankan koneksi persisten ke perangkat dan menyertakan cache dan antrean offline yang menampung operasi ketika perangkat sementara tidak dapat dijangkau. Event tidak hilang selama gangguan konektivitas dan dikirimkan ke endpoint Callback Anda ketika koneksi pulih. Keandalan koneksi perangkat ditentukan oleh infrastruktur Gateway, bukan oleh apakah aplikasi Anda berbicara dengannya melalui HTTP atau panggilan DLL. Gateway yang dikelola dengan baik akan memiliki ketersediaan yang lebih tinggi dibandingkan yang biasanya dicapai tim dengan instalasi SDK yang dikelola sendiri pada satu VM Windows.
Bagaimana dengan latensi? Apakah tambahan hop jaringan menimbulkan penundaan yang berarti?
Untuk sebagian besar operasi biometrik, tambahan hop jaringan hanya menambah beberapa milidetik. Callback kehadiran dikirimkan secara real-time oleh gateway yang mendorong ke endpoint webhook Anda, sehingga model latensinya mirip dengan koneksi SDK langsung yang menerima event. Untuk operasi tulis seperti menambahkan pengguna, total waktu round trip didominasi oleh waktu pemrosesan perangkat itu sendiri, yaitu 1 hingga 3 detik, terlepas dari cara instruksi tersebut diterima. Hop HTTP bukanlah penghambatnya.
Bisakah kami menggunakan API dari backend Python atau Node.js yang sudah ada tanpa library klien khusus?
Ya. API menggunakan HTTP standar dengan body JSON. Library HTTP client apa pun dalam bahasa apa pun berfungsi tanpa modifikasi. Anda tidak memerlukan SDK khusus, library klien yang diterbitkan oleh vendor gateway, atau paket khusus bahasa apa pun. Jika Anda dapat membuat permintaan HTTP POST dengan body JSON, Anda dapat memanggil API. Itulah seluruh permukaan integrasi dari sudut pandang aplikasi Anda.

Kesimpulan: Masalah SDK Memiliki Solusi yang Bersih

SDK biometrik khusus Windows bukanlah kenyataan yang harus terus-menerus diakali oleh tim engineering Anda. Itu adalah konsekuensi dari keputusan distribusi yang dibuat dua dekade lalu dalam lanskap infrastruktur yang berbeda. Keputusan itu dapat digantikan oleh gateway yang menyerap kompleksitas protokol biner dan mengekspos perangkat melalui API standar.

Ketika transisi itu terjadi, VM Windows khusus dihentikan. Pipeline CI/CD kembali mendapatkan integrasi biometrik. Pengembang baru menyiapkan lingkungan lokalnya dalam hitungan menit. Kontainer Docker berjalan tanpa konfigurasi khusus. Pengembang Mac berhenti melakukan remote ke satu-satunya mesin di kantor yang memiliki lisensi SDK terpasang. Ini bukan peningkatan kualitas hidup yang kecil. Ini adalah penghapusan kendala struktural yang selama bertahun-tahun telah menguras waktu dan kesabaran tim engineering Anda.

Cams Biometrics Gateway sepenuhnya menggantikan SDK Windows. Gateway terhubung ke perangkat biometrik Anda dari Cams, ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime, Biomax, Secugen, eSSL, Matrix, dan lainnya, menggunakan protokol asli mereka, tanpa memerlukan instalasi SDK di mana pun dalam infrastruktur Anda. Gateway menyediakan 38 operasi di dua jenis API: Callback API yang mendorong event perangkat real-time ke server Anda dengan latensi nol, dan RESTful API yang menerima perintah dari server Anda ke perangkat. Semua komunikasi menggunakan JSON melalui HTTP/HTTPS dengan enkripsi AES-256 opsional. Integrasi MCP native berarti Claude, Gemini, dan ChatGPT dapat memanggil operasi biometrik secara langsung. Cache dan antrean offline menangani gangguan konektivitas secara otomatis. Gateway berfungsi sama persis apa pun stack Anda berjalan di Linux, Mac, Windows, Docker, Kubernetes, atau serverless function. Tidak ada DLL. Tidak ada Visual C++ Redistributable. Tidak ada mesin Windows khusus. Tidak ada file lisensi. Jelajahi API lengkap di CamsBiometrics.com tentang migrasi integrasi SDK Anda yang sudah ada.

 

Was this article helpful?