zint_flutter 1.0.0
SDKflutter
Platformandroidioswindowslinuxmacos
A Flutter package for generating barcodes using Zint library
Zint Flutter
Un wrapper Flutter pour la bibliothèque Zint, permettant la génération de plus de 50 types de codes-barres différents.
Caractéristiques
- Support de plus de 50 symbologies de codes-barres
- Génération haute performance avec code natif
- Multiples formats de sortie (PNG, SVG, EPS, etc.)
- Personnalisation complète (couleurs, taille, options)
- Support des plateformes Windows et macOS
Installation
1. Dépendance
Ajoutez ceci à votre fichier pubspec.yaml :
dependencies:
zint_flutter: ^1.0.0
2. Configuration plateforme
macOS
- Ajoutez
libzint.dylibdans le dossiermacos/Frameworks - Intégrez la bibliothèque dans Xcode :
- Ouvrez
macos/Runner.xcworkspace - Glissez
libzint.dylibdans le projet - Vérifiez qu'il est listé dans "Frameworks"
- Ouvrez
Windows
- Placez
zint.dlldans le dossier de votre application - Assurez-vous qu'il est accessible lors de l'exécution
Utilisation
Code de base
import 'package:zint_flutter/zint_flutter.dart';
final barcode = ZintBarcode();
try {
// Configuration du code-barres
barcode.setSymbology(BarcodeType.QRCODE);
barcode.setScale(2.0);
barcode.setForegroundColor("000000");
barcode.setOutputFile("output.png");
// Encodage des données
final result = barcode.encode("Hello World");
// Génération de l'image
if (result == 0) {
barcode.print();
}
} finally {
barcode.dispose();
}
Configuration avancée
final barcode = ZintBarcode();
try {
// Type de code-barres
barcode.setSymbology(BarcodeType.CODE128);
// Apparence
barcode.setScale(3.0);
barcode.setForegroundColor("FF0000"); // Rouge
barcode.setBackgroundColor("FFFFFF"); // Blanc
// Options
barcode.setOutputOptions(
OutputOption.BARCODE_BIND |
OutputOption.BARCODE_BOX |
OutputOption.BOLD_TEXT
);
// Mode d'entrée
final result = barcode.encode(
"12345",
inputMode: InputMode.UNICODE_MODE
);
if (result >= ErrorCode.ZINT_ERROR) {
print("Erreur: ${barcode.getError()}");
}
} finally {
barcode.dispose();
}
Méthodes principales
// Configuration de base
setSymbology(int symbology) // Définit le type de code-barres
setHeight(double height) // Définit la hauteur
setScale(double scale) // Définit l'échelle
encode(String data) // Encode les données
print([int rotation = 0]) // Génère l'image
// Apparence
setForegroundColor(String color) // Couleur du code ("RRGGBB")
setBackgroundColor(String color) // Couleur de fond ("RRGGBB")
setWhitespaceWidth(int width) // Marge horizontale
setWhitespaceHeight(int height) // Marge verticale
setBorderWidth(int width) // Largeur de bordure
// Options avancées
setOutputOptions(int options) // Options de sortie
setShowHRT(bool show) // Affichage du texte
setInputMode(int mode) // Mode d'entrée
setDotSize(double size) // Taille des points
setGuardDescent(double descent) // Descente des barres (EAN/UPC)
setWarnLevel(int level) // Niveau d'avertissement
// Options spécifiques
setOption1(int option) // Option spécifique 1
setOption2(int option) // Option spécifique 2
setOption3(int option) // Option spécifique 3
Types de codes-barres supportés
// Quelques exemples de symbologies disponibles
BarcodeType.QRCODE // QR Code
BarcodeType.CODE128 // Code 128
BarcodeType.DATAMATRIX // Data Matrix
BarcodeType.PDF417 // PDF417
BarcodeType.AZTEC // Aztec Code
BarcodeType.CODE39 // Code 39
BarcodeType.EAN13 // EAN-13
BarcodeType.UPCA // UPC-A
// Et bien plus...
Options de sortie
OutputOption.BARCODE_BIND // Ajoute des barres de liaison
OutputOption.BARCODE_BOX // Ajoute un cadre
OutputOption.SMALL_TEXT // Texte en petit
OutputOption.BOLD_TEXT // Texte en gras
OutputOption.BARCODE_DOTTY_MODE // Mode pointillé
OutputOption.QUIET_ZONES // Zones calmes
Modes d'entrée
InputMode.DATA_MODE // Mode données standard
InputMode.UNICODE_MODE // Support Unicode
InputMode.GS1_MODE // Format GS1
InputMode.ESCAPE_MODE // Séquences d'échappement
Formats de sortie supportés
- PNG (par défaut)
- SVG
- EPS
- BMP
- PCX
- GIF
- EMF
- TIF
- TXT
Gestion des erreurs
final barcode = ZintBarcode();
try {
final result = barcode.encode("données");
switch (result) {
case ErrorCode.ZINT_ERROR:
print("Erreur générale");
break;
case ErrorCode.ZINT_ERROR_TOO_LONG:
print("Données trop longues");
break;
case ErrorCode.ZINT_ERROR_INVALID_DATA:
print("Données invalides");
break;
// etc.
}
if (result >= ErrorCode.ZINT_ERROR) {
print("Message d'erreur: ${barcode.getError()}");
}
} finally {
barcode.dispose();
}
Résolution des problèmes
La bibliothèque native n'est pas trouvée
- Vérifiez que la bibliothèque native est présente
- Sur macOS :
libzint.dylibdoit être dansmacos/Frameworks - Sur Windows :
zint.dlldoit être accessible
Erreurs d'encodage
- Vérifiez le format des données d'entrée
- Utilisez le bon mode d'entrée (DATA_MODE, UNICODE_MODE, etc.)
- Respectez les limitations de la symbologie choisie
Contribuer
Les contributions sont bienvenues !
- Fork le projet
- Créez votre branche (
git checkout -b feature/NouvelleFonctionnalite) - Commitez vos changements (
git commit -m 'Ajout nouvelle fonctionnalité') - Push vers la branche (
git push origin feature/NouvelleFonctionnalite) - Ouvrez une Pull Request
Licence
Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.