Orientação gerada a partir de informações públicas. Apenas para referência.
O plugin zk_finger10 permite a integração com dispositivos de impressão digital ZKTECO no Android, oferecendo capacidades de registro e verificação de impressões digitais. Projetado para autenticação biométrica local, permite que desenvolvedores capturem e verifiquem impressões digitais diretamente em hardware compatível de forma segura. O plugin é ideal para aplicações que exigem controle de acesso físico, sistemas de ponto ou autenticação de usuário segura em ambientes offline. Ele utiliza comunicação nativa com o dispositivo por meio do SDK ZKTECO, garantindo compatibilidade com uma variedade de scanners de impressão digital ZKTECO.
Casos de uso
Sistemas de rastreamento de frequência
controle de acesso seguro
Autenticação biométrica off-line
Gestão de tempo dos funcionários
Registro de impressão digital específico do dispositivo
Principais recursos
Suporta dispositivos de digital ZKTECO
Funcionalidade de matrícula e verificação
Suporte de plataforma exclusivo para Android
Comunicação de dispositivo nativo
Capacidade de operação offline
Indicado para
Desenvolvedores construindo aplicativos de ponto
Sistemas que exigem biometria local segura
Integrações de hardware ZKTECO
aplicações de quiosque baseadas em Android
Soluções de segurança empresarial
Considerações
Limitado à plataforma Android
Requer hardware ZKTECO compatível
Sem suporte para iOS
Dependente do firmware do dispositivo
Pode exigir configuração adicional para modelos específicos
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
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