واحدة من المشاكل الحقيقية اللي ممكن تقف قدام أي Flutter Developer هي التعامل مع Hardware مباشر — خصوصًا أجهزة زي قارئ البصمة. في المقال ده هحكيلك تجربة عملية في حل مشكلة ربط جهاز بصمة ZKTeco ZK8500R مع تطبيق Flutter POS، بدون أي مكتبة جاهزة.

كان المطلوب في نظام POS مبني بـ Flutter إن الموظفين يسجلوا حضور وانصراف باستخدام البصمة، مش بكلمة سر ولا PIN. لكن أول challenge ظهر كان:

وده كان معناه إن الحل التقليدي مش موجود.

بدل ما ننتظر مكتبة تظهر، تم بناء حل كامل من الصفر باستخدام فكرة بسيطة:

Flutter ↔ REST API ↔ Python Agent ↔ Fingerprint Device

يعني بدل ما Flutter يتكلم مع الجهاز مباشرة، يتكلم مع API محلي.

تم بناء Python Agent بيشتغل محليًا على الجهاز، وبيعمل:

/connect
→ فتح الاتصال بالجهاز وتشغيل background polling

/load_templates
→ تحميل بصمات الموظفين من Firebase إلى الذاكرة

/status
→ معرفة هل في بصمة حالياً (Polling كل 500ms)

/identify
→ مطابقة البصمة مع المستخدمين وإرجاع user_id

/clear_pending
→ مسح البصمة السابقة قبل أي scan جديد

تم استخدام مكتبة Dio لإرسال HTTP Requests:

final response = await dio.get('http://localhost:9201/status');

Flutter بيتعامل مع الـ agent كأنه backend عادي جدًا.

تم بناء Widget موحد:

FingerprintDialog

ويحتوي على حالات:

مع دعم:

أثناء استخدام pyzkfp ظهر الخطأ:

RuntimeError: Initialize clr before importing

السبب كان إن pythonnet 3.x غيّر طريقة التهيئة.

إضافة سطر واحد قبل import clr:

import pythonnet
pythonnet.load('netfx')

import clr

سطر واحد حل مشكلة debugging استمرت لساعات.

عدم وجود مكتبة مش نهاية الطريق. أحيانًا ده معناه إنك تبني حل أفضل — ويمكن كمان يكون أساس لمنتج أو مكتبة يستخدمها غيرك.