zk_finger10 플러그인은 안드로이드에서 ZKTECO 지문 장치와의 통합을 가능하게 하며, 지문 등록 및 검증 기능을 제공합니다. 로컬 생체 인식 인증을 위해 설계되어 개발자가 지원되는 하드웨어에서 지문을 안전하게 캡처하고 검증할 수 있도록 합니다. 물리적 접근 제어, 출퇴근 시스템 또는 오프라인 환경에서의 보안 사용자 인증이 필요한 애플리케이션에 적합합니다. ZKTECO SDK를 통해 네이티브 장치 통신을 활용하여 다양한 ZKTECO 지문 스캐너와 호환성을 보장합니다.
사용 사례
출석 추적 시스템
보안 액세스 제어
오프라인 생체 인식 인증
직원 시간 관리
기기별 지문 등록
주요 기능
ZKTECO 지문 장치를 지원합니다
등록 및 검증 기능
안드로이드 전용 플랫폼 지원
네이티브 장치 통신
오프라인 운영 기능
적합한 대상
출석 앱을 개발하는 개발자
안전한 로컬 생체 인식을 필요로 하는 시스템
ZKTECO 하드웨어 통합
안드로이드 기반 키오스크 애플리케이션
엔터프라이즈 보안 솔루션
고려 사항
안드로이드 플랫폼에 제한됨
호환되는 ZKTECO 하드웨어 필요
iOS 지원 없음
장치 펌웨어에 따라 다름
특정 모델에 대한 추가 구성이 필요할 수 있습니다
원본 README
연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
zkfinger10 - Modern Fingerprint Plugin for Flutter 🚀
📱 Sample Screenshot
A modern, fully updated Flutter plugin for ZKTeco fingerprint scanners with Flutter v3.35.3 compatibility and Android Plugin V2 embedding. This package provides comprehensive support for ZKTeco fingerprint devices including enrollment, verification, and advanced template management.
✨ Major v1.0.0 Update - Fully Modernized!
This plugin has been completely modernized for 2024+ Flutter development:
🎯 Flutter v3.35.3 Compatible
🔧 Android Plugin V2 Embedding
📱 Android API 34+ Support
🏗️ Modern Gradle Build System
💾 Enhanced Database Management
🔒 Improved Security & Performance
📱 Supported Devices
Compatible with ZKTeco fingerprint scanners including:
SLK20R series
ZK9500 series
ZK6500 series
ZK8500R series
Other ZKTeco USB fingerprint devices
Note: This is an unofficial community-maintained package
🚀 Getting Started
Requirements
Flutter: 3.35.0 or higher
Dart SDK: 3.1.0 or higher
Android: API 21+ (Android 5.0+)
Target Android: API 34 (Android 14)
Installation
Add this to your package's pubspec.yaml file:
dependencies:zkfinger10:^1.0.0
Then run:
flutter pub get
⚙️ Android Configuration
1. Add Permissions
Add these permissions to your android/app/src/main/AndroidManifest.xml:
import'package:zkfinger10/zkfinger10.dart';
// Initialize connectionawaitZkFinger.openConnection();
// Register a fingerprintawaitZkFinger.registerFinger(userId: "user123");
// Identify a fingerprintawaitZkFinger.identify();
// Clear all fingerprintsawaitZkFinger.clearFingerDatabase();
// Close connectionawaitZkFinger.closeConnection();
🆕 New Bidirectional Data Management
// Get fingerprint feature data for a specific userString? feature = awaitZkFinger.getUserFeature(userId: "user123");
// Get all users and their fingerprint dataMap<String, String>? users = awaitZkFinger.getAllUsers();
// Get total count of usersint? count = awaitZkFinger.getUserCount();
// Update user's fingerprint feature databool? success = awaitZkFinger.updateUserFeature(
userId: "user123",
feature: "base64_encoded_fingerprint_data"
);
// Check if user existsbool? exists = awaitZkFinger.checkUserExists(userId: "user123");
Event Streams
// Listen to fingerprint status changesZkFinger.fingerStatusChangeStream.listen((status) {
print('Status: ${status['message']}');
});
// Listen to fingerprint image dataZkFinger.fingerImageStream.listen((imageBytes) {
// Process fingerprint image
});
⚠️ Build Configuration
Release Build Settings
Add these lines to your android/app/build.gradle if you have problems on release:
buildTypes {
release {
....
//Add these lines when releasing your app
minifyEnabled false
shrinkResources false
// useProguard false
}
}
🔧 Troubleshooting
Common Issues
Plugin not found: Ensure you've run flutter pub get and restarted your IDE
USB permission denied: Check that your device filter XML is correctly configured
Build errors: Verify your Flutter and Android versions meet the requirements
Runtime crashes: Ensure you're targeting Android API 34+ with proper permissions
Migration from v0.x.x
If upgrading from an older version:
Update Flutter: Ensure you're using Flutter 3.35.0+
Update Android: Target API 34+ in your build.gradle
Check Permissions: Verify all required permissions are added
Test Thoroughly: The plugin now uses V2 embedding which may affect lifecycle behavior