شارك المقالة
تحويل Widget إلى PNG في Flutter باستخدام RepaintBoundary

تحويل Widget إلى PNG في Flutter باستخدام RepaintBoundary

التقاط Widget إلى PNG في Flutter عبر RepaintBoundary مع انتظار الرسم وتحديد pixelRatio والتخلص من الصورة وفصل الحفظ عن الالتقاط.

التقاط Widget إلى PNG في Flutter عبر RepaintBoundary مع انتظار الرسم وتحديد pixelRatio والتخلص من الصورة وفصل الحفظ عن الالتقاط.

التقاط ما تم رسمه

toImage يلتقط حدود الرسم للمكون المرتبط بالفعل بالشجرة؛ لا يلتقط تلقائيًا كل صفوف قائمة lazy خارج الشاشة. تحقق من currentContext ونوع RenderObject وانتظر نهاية إطار بعد تغير المحتوى. pixelRatio=10 يزيد عدد البكسلات نحو مئة ضعف مقارنة بـ1 لنفس الأبعاد، وقد يستهلك ذاكرة كبيرة. اختر نسبة مناسبة للغرض وحدًا لحجم الناتج.

فصل البايتات عن وجهة الحفظ

قد تُرجع toByteData قيمة فارغة؛ عالجها ثم استدع image.dispose بعد الانتهاء. إرجاع Uint8List من خدمة الالتقاط يجعل اختبارها مستقلًا عن مكتبات الملفات والمشاركة. مجلد Documents داخل التطبيق يختلف عن معرض الصور أو اختيار مسار Windows، وإذن تخزين واحد لا يمنح كتابة أي مكان على كل الأنظمة. عالج فشل الحفظ دون إعادة التقاط كبيرة بلا داع.

خطوات التطبيق والشرح

كيف تحول أي Widget في تطبيقك إلى صورة عالية الجودة؟

كيف تحول اي Widget إلى صور بضغطة زر في فلاتر

تحويل الـ Widgets إلى صور داخل التطبيقات يعد ميزة قوية يمكن أن تُستخدم في العديد من السيناريوهات، مثل حفظ التذاكر الإلكترونية أو إيصالات الدفع بجودة عالية جاهزة للطباعة. في هذا المقال، سنوضح كيفية تحقيق ذلك باستخدام RepaintBoundary مع خطوات واضحة وأمثلة عملية.

لماذا نحتاج إلى تحويل الـ Widgets إلى صور؟

قبل الغوص في الكود، دعنا نفهم أولاً أهمية هذه الميزة:

  1. حفظ التذاكر والإيصالات : إذا كنت تعمل على تطبيق يعرض تذاكر الحفلات أو إيصالات الدفع، فإن السماح للمستخدم بحفظها كصور عالية الجودة يجعل العملية أكثر احترافية.
  2. تجنب لصور التقليدية : بدلاً من الاعتماد على لقطات الشاشة (Screenshots) التي قد تكون ذات جودة منخفضة، يمكنك تقديم صور مخصصة ومُعدّة بشكل جيد.
  3. الطباعة : الصور عالية الجودة تكون جاهزة للطباعة دون فقدان التفاصيل.

ما هو دور RepaintBoundary؟

RepaintBoundary هو Widget خاص في Flutter يتيح لك عزل جزء معين من واجهة المستخدم ليتم رسمه بشكل مستقل. هذا يجعل من السهل تحويل هذا الجزء إلى صورة باستخدام طريقة toImage().

مكونات RepaintBoundary:

Key : يتم استخدامه للوصول إلى الـ Widget المحدد الذي تريد تحويله إلى صورة.

Child : الـ Widget الفرعي الذي تريد تحويله إلى صورة.

 الخطوات العملية لتحويل الـ Widget إلى صورة

أولاً: إعداد الـ Widget باستخدام RepaintBoundary

_widgetKey هو Global Key يتم استخدامه لتحديد الـ Widget المراد تحويله.

YourCustomWidget() هو الـ Widget الذي تريد تحويله إلى صورة.

كتابة الدالة لالتقاط وحفظ الصورة

المكتبات المطلوبة:

path_provider : لتحديد مسار تخزين الصور.

open_file : لفتح الصورة بعد حفظها.

dependencies:

  path_provider: ^2.0.11

  open_file: ^3.2.1

الداله المسؤوله عن التحويل

كيف تستفيد من هذه الميزة؟

أ) تطبيقات الحجز والتذاكر

إذا كنت تعمل على تطبيق لحجز التذاكر (مثل تذاكر الطيران أو الحفلات)، يمكنك استخدام هذه الميزة لجعل المستخدمين يحفظون التذاكر بصيغة صور عالية الجودة، مما يسهل عليهم الطباعة أو عرضها عند الحاجة.

ب) إيصالات الدفع

عند إنشاء إيصالات الدفع، يمكنك توفير زر “حفظ الإيصال” يتيح للمستخدمين تنزيل الإيصال كصورة بدلاً من الاعتماد على لقطات الشاشة.

ج) تصدير المحتوى

يمكن استخدام هذه الميزة لتصدير أي محتوى مرئي من التطبيق، مثل الرسوم البيانية أو التقارير.

 هل يمكنني تحسين جودة الصورة الناتجة؟

نعم، يمكنك تحسين جودة الصورة عن طريق زيادة قيمة pixelRatio في الدالة toImage(). كلما زادت القيمة، كانت الصورة أكثر وضوحًا.

هل يمكنني حفظ الصورة في مكان آخر غير مجلد التطبيق؟

الحفظ يحتاج واجهة ومكانًا تسمح بهما المنصة؛ إذن واحد لا يمنح الوصول إلى أي مسار على كل الأجهزة.

ماذا لو كان الـ Widget كبيرًا جدًا؟

إذا كان الـ Widget كبيرًا جدًا، قد تحتاج إلى تقسيمه إلى أجزاء أصغر أو استخدام تقنيات أخرى مثل التمرير التلقائي أثناء التقاط الصورة.

تحويل الـ Widgets إلى صور عالية الجودة باستخدام RepaintBoundary هو ميزة قوية يمكن أن تُستخدم في العديد من التطبيقات. سواء كنت تعمل على تطبيق لإدارة التذاكر، إيصالات الدفع، أو حتى تصدير المحتوى، فإن هذه التقنية توفر تجربة مستخدم أفضل وتزيد من احترافية تطبيقك.

إذا كنت تبحث عن طريقة سهلة لتحسين تطبيقك وإضافة ميزات جديدة، فلا تتردد في تجربة هذه الطريقة!

مثال الشفرة بعد المراجعة

اقرأ التعليقات ومتطلبات الإعداد قبل النقل إلى مشروعك. أمثلة الواجهات ذات main مستقلة، أما العقود والمقاطع الأصلية وملفات الإعداد فموضح نطاقها داخل المثال.

import 'dart:typed_data';
import 'dart:ui' as ui;
import 'package:flutter/rendering.dart';
import 'package:flutter/widgets.dart';
Future<Uint8List> capturePng(GlobalKey boundaryKey) async {
  await WidgetsBinding.instance.endOfFrame;
  final object = boundaryKey.currentContext?.findRenderObject();
  if (object is! RenderRepaintBoundary || object.debugNeedsPaint) {
    throw StateError('Capture target is not ready');
  }
  final image = await object.toImage(pixelRatio: 2);
  try {
    final data = await image.toByteData(format: ui.ImageByteFormat.png);
    if (data == null) throw StateError('PNG encoding failed');
    return data.buffer.asUint8List(data.offsetInBytes, data.lengthInBytes);
  } finally { image.dispose(); }
}
// Attach boundaryKey to a painted RepaintBoundary.
// Choose storage, export or sharing separately for each platform.

مرجع للتنفيذ

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

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع