flutter_file_picker

منتقي الملف

الحزمة التي تتيح لك استخدام مستكشف الملف الأصلي لاختيار ملفات واحدة أو متعددة ، مع امتدادات تصفية الدعم.

الميزات المدعومة حاليا

• يستخدم OS Default Native Pickers
• يدعم منصات متعددة (الهاتف المحمول ، الويب ، سطح المكتب)
• اختر الملفات باستخدام تصفية التنسيق المخصص - يمكنك توفير قائمة بملحقات الملفات (PDF ، SVG ، ZIP ، إلخ)
• اختر الملفات من الملفات السحابية (GDrive ، Dropbox ، iCloud)
• اختيارات ملفات واحدة أو متعددة
• يدعم الاسترداد كـ Xfile (Cross_File) لسهولة التلاعب مع المكتبات الأخرى
• تصفية نوع افتراضي مختلف (الوسائط أو الصورة أو الفيديو أو الصوت أو أي)
• انتقاء الدلائل
• تحميل بيانات الملف على الفور في الذاكرة ( Uint8List ) إذا لزم الأمر ؛
• افتح مربع حوار Save-File / Save-As (مربع حوار يتيح للمستخدم تحديد محرك الأقراص والدليل واسم ملف لحفظه)

إذا كان لديك أي ميزة تريد رؤيتها في هذه الحزمة ، فلا تتردد في إصدار اقتراح. ؟

مخطط التوافق

API	Android	iOS	Linux	ماكوس	النوافذ	الويب
cleartmoriveporary ()	✔	✔
getDirectorypath ()	✔	✔	✔	✔	✔
Pickfiles ()	✔	✔	✔	✔	✔	✔
SaveFile ()	✔	✔	✔	✔	✔

راجع قسم API في منتقي الملفات Wiki أو مرجع API الرسمي على Pub.dev لمزيد من التفاصيل.

الوثائق

راجع Wiki للمنتقي للملفات للحصول على كل التفاصيل حول كيفية تثبيت وإعداده واستخدامه.

ملفات ملف الويكي

1. تثبيت
2. يثبت
   • Android
   • iOS
   • الويب
   • سطح المكتب
3. API
   • المرشحات
   • حدود
   • طُرق
4. التعليمات
5. استكشاف الأخطاء وإصلاحها

الاستخدام

مثال سريع الاستخدام البسيط:

ملف واحد

 FilePickerResult ? result = await FilePicker .platform. pickFiles ();

if (result != null ) {
  File file = File (result.files.single.path ! );
} else {
  // User canceled the picker
}

ملفات متعددة

 FilePickerResult ? result = await FilePicker .platform. pickFiles (allowMultiple : true );

if (result != null ) {
  List < File > files = result.paths. map ((path) => File (path ! )). toList ();
} else {
  // User canceled the picker
}

ملفات متعددة مع مرشح الامتداد

 FilePickerResult ? result = await FilePicker .platform. pickFiles (
  allowMultiple : true ,
  type : FileType .custom,
  allowedExtensions : [ 'jpg' , 'pdf' , 'doc' ],
);

اختر دليلًا

 String ? selectedDirectory = await FilePicker .platform. getDirectoryPath ();

if (selectedDirectory == null ) {
  // User canceled the picker
}

الحوار حفظ / حفظ كما

 String ? outputFile = await FilePicker .platform. saveFile (
  dialogTitle : 'Please select an output file:' ,
  fileName : 'output-file.pdf' ,
);

if (outputFile == null ) {
  // User canceled the picker
}

تحميل النتيجة وتفاصيل الملف

 FilePickerResult ? result = await FilePicker .platform. pickFiles ();

if (result != null ) {
  PlatformFile file = result.files.first;

  print (file.name);
  print (file.bytes);
  print (file.size);
  print (file. extension );
  print (file.path);
} else {
  // User canceled the picker
}

استرداد جميع الملفات كـ XFILES أو بشكل فردي

 FilePickerResult ? result = await FilePicker .platform. pickFiles ();

if (result != null ) {
  // All files
  List < XFile > xFiles = result.xFiles;

  // Individually
  XFile xFile = result.files.first.xFile;
} else {
  // User canceled the picker
}

اختر وتحميل ملف لتخزين Firebase مع الويب Flutter

 FilePickerResult ? result = await FilePicker .platform. pickFiles ();

if (result != null ) {
  Uint8List fileBytes = result.files.first.bytes;
  String fileName = result.files.first.name;
  
  // Upload file
  await FirebaseStorage .instance. ref ( 'uploads/$ fileName ' ). putData (fileBytes);
}

للحصول على تفاصيل الاستخدام الكاملة ، راجع الويكي أعلاه.

مثال التطبيق

Android

iOS

ماكوس

Linux

النوافذ

ابدء

للمساعدة في البدء مع الرفرفة ، شاهد وثائقنا عبر الإنترنت.

للحصول على مساعدة في تحرير رمز البرنامج المساعد ، عرض الوثائق.