إنشاء PDF عربي في Flutter باستخدام pdf وprinting، مع تحميل خط يدعم العربية وRTL وتعدد الصفحات ومعالجة فشل الخط دون الاعتماد على dart:io للمعاينة.
مستند PDF له Widgets مختلفة
مكتبة pdf تبني شجرة مستند بعناصرها الخاصة، وليست Flutter Widget tree نفسها. استخدم alias مثل pw حتى لا تختلط Text وRow الخاصة بالصفحة مع عناصر التطبيق. يعرض المثال تقريرًا بسيطًا ببنود، ويفصل توليد Uint8List عن PdfPreview. هذا يسمح باختبار المستند دون فتح واجهة مشاركة، ثم استخدام النتيجة في طباعة أو حفظ وفق المنصة والسياسة التي يحتاجها مشروعك.
خط عربي واتجاه صحيح
حمّل خط TrueType يدعم العربية من assets مع التصريح به في pubspec وبحقوق استخدام مناسبة. تمرير خط لا يدعم الحروف يؤدي إلى مربعات أو أحرف ناقصة، وتفعيل RTL لا يصنع تغطية خط مفقودة. اجعل textDirection في المستند صريحًا، واختبر الجمل المختلطة بالأرقام والإنجليزية وعلامات الترقيم. لا تحول العربية إلى صورة لتجنب المشكلة؛ ذلك يفقد قابلية البحث والتكبير واستخراج النص.
تعدد الصفحات والمقاس
استخدم MultiPage عندما يمكن أن يتجاوز المحتوى صفحة، واتبع format الذي تمرره المعاينة بدل افتراض A4 دائمًا. حافظ على هوامش معقولة وتجنب وضع نص طويل داخل عنصر لا يقبل الانقسام. اختبر قائمة قصيرة وطويلة وعناوين ملتفة. PDF لا يلتزم بقيود شاشة الهاتف نفسها، لذلك تحتاج مراجعة ملف مولد فعليًا، لا صورة Widget المعاينة فقط.
معاينة تعمل عبر منصات مختلفة
يعتمد المثال على bytes وPdfPreview، ولا يبدأ بمسار File من dart:io الذي لا يعمل على الويب. إذا أضفت حفظًا أو مشاركة فراجع API المنصة والأذونات وأسماء الملفات، ولا تكتب في مسار عام ثابت دون حاجة. تحميل الخط يحدث مرة في State مع حالات انتظار وخطأ، ولا يعاد لكل build. لا تضع في التقرير معلومات خاصة لم يطلب المستخدم تصديرها أو تخزنها مؤقتًا بلا سياسة واضحة.
تشغيل المثال وفحص الناتج
أضف pdf وprinting المتوافقين ثم وفر assets/fonts/Arabic.ttf أو عدل المسار وفق مشروعك. المثال يضم المولد وصفحة المعاينة ويعرض قائمة بنود تجريبية، ويمكن مقارنته بمجلد create_pdf والمثال المرجعي المرتبطين. اختبر وجود النص العربي وعدد الصفحات والهوامش وفتح الملف في قارئ مستقل. المستودعات القديمة مفيدة للفكرة، لكن لا تنقل إصداراتها القديمة أو class مفقودًا إلى مشروع حديث دون مراجعة.
المثال البرمجي
ضع المكون داخل مشروع Flutter وصفحة مناسبة في MaterialApp. الكود التالي مثال مستقل للجزء المشروح، ولا يعتمد على ملفات تطبيق خارجي غير مرفقة. راجع المتطلبات المذكورة في النص، خاصة الخط والحزم في مثال PDF.
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:pdf/pdf.dart';
import 'package:pdf/widgets.dart' as pw;
import 'package:printing/printing.dart';
class ReportItem {
const ReportItem(this.title, this.quantity);
final String title;
final int quantity;
}
Future<Uint8List> buildArabicReport(ByteData fontData, PdfPageFormat format,
List<ReportItem> items) async {
final font = pw.Font.ttf(fontData);
final document = pw.Document();
document.addPage(pw.MultiPage(
pageFormat: format, margin: const pw.EdgeInsets.all(24),
theme: pw.ThemeData.withFont(base: font, bold: font),
textDirection: pw.TextDirection.rtl,
build: (context) => [
pw.Header(level: 0, child: pw.Text('تقرير البنود')),
for (final item in items) pw.Padding(
padding: const pw.EdgeInsets.symmetric(vertical: 6),
child: pw.Text('${item.title} — العدد: ${item.quantity}'),
),
],
));
return document.save();
}
class ReportPage extends StatefulWidget {
const ReportPage({super.key});
@override
State<ReportPage> createState() => _ReportPageState();
}
class _ReportPageState extends State<ReportPage> {
late final Future<ByteData> _font = rootBundle.load('assets/fonts/Arabic.ttf');
@override
Widget build(BuildContext context) => Scaffold(
appBar: AppBar(title: const Text('معاينة التقرير')),
body: FutureBuilder<ByteData>(future: _font, builder: (context, snapshot) {
if (snapshot.hasError) return const Center(child: Text('تعذر تحميل الخط'));
if (!snapshot.hasData) return const Center(child: CircularProgressIndicator());
return PdfPreview(build: (format) => buildArabicReport(snapshot.data!, format,
const [ReportItem('كتاب', 2), ReportItem('دفتر', 3)]));
}),
);
}
الصور والفيديو من الشرح
المواد المرئية الأصلية محفوظة للمقارنة. قد تعكس نسخة أقدم من المشروع؛ اعتمد النص المصحح أعلاه عند اختلاف أسماء الحزم أو إعدادات التشغيل أو نطاق الميزات.









