تعرض حزمة vector_graphics في Flutter الرسومات المتجهة من بيانات ثنائية جهزتها مسبقًا. لتحميل شعار SVG محلي بهذه الطريقة، حوّله بأداة vector_graphics_compiler إلى ملف .vec، وسجّل الملف في pubspec.yaml، ثم اعرضه باستخدام VectorGraphic وAssetBytesLoader.
تظهر فائدة التحويل عندما يكون الرسم ثابتًا وتعرفه قبل بناء التطبيق، مثل شعار شاشة الترحيب أو مجموعة أيقونات تُعرض في قائمة. ينقل التحويل تحليل XML إلى خطوة التجهيز. يظل التطبيق يفك ترميز البيانات الثنائية ويرسمها عند العرض، لذلك يعتمد أثر التغيير على الرسم والجهاز وطريقة استخدامه.
ما الفرق بين vector_graphics وflutter_svg؟
| الحالة | ما تستخدمه |
|---|---|
| لديك ملف SVG عادي وتريد عرضه مباشرة | SvgPicture.asset من flutter_svg، أو SvgPicture.network إذا جاء SVG من رابط. |
| لديك رسم ثابت وتريد تحويله قبل التشغيل | vector_graphics_compiler للتحويل، ثم VectorGraphic لعرض الناتج. |
مشروعك يستخدم SvgPicture بالفعل | يمكن لمنشئ SvgPicture قبول AssetBytesLoader لعرض الملف المترجم مع الإبقاء على واجهة الاستخدام الحالية. |
إذا كنت تعمل على صورة حساب يركّبها المستخدم أثناء التشغيل، فستختلف طريقة تجهيز الرسم عن مثال الأيقونة الثابتة هنا. راجع تطبيقًا لهذا السيناريو في شرح إنشاء أفاتار SVG في Flutter باستخدام fluttermoji.
1. تثبيت الحزم وإنشاء ملف SVG
نفّذ الأوامر من مجلد مشروع Flutter الذي يحتوي على pubspec.yaml. يحتاج التطبيق إلى حزمة العرض وقت التشغيل، بينما نضيف أداة التحويل إلى اعتماديات التطوير.
flutter pub add vector_graphics
flutter pub add --dev vector_graphics_compilerأنشئ ملف assets/check.svg واحفظ فيه هذا الرسم التجريبي. يحتوي على دائرة وعلامة تحقق ويمكن تكبيره داخل الحدود التي تحددها الواجهة.
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48">
<circle cx="24" cy="24" r="22" fill="#0F766E"/>
<path d="M13 24l7 7 15-15" fill="none" stroke="#fff"
stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
</svg>2. تحويل SVG إلى VEC وإضافته إلى assets
dart run vector_graphics_compiler -i assets/check.svg -o assets/check.svg.vecيحدد -i ملف الإدخال ويحدد -o مسار الملف الناتج. أضف الناتج تحت flutter.assets في ملف pubspec.yaml. لو عندك قسم flutter بالفعل، أضف المسار إلى القسم الموجود.
flutter:
assets:
- assets/check.svg.vecاحتفظ بملف SVG الأصلي لتعديله لاحقًا. بعد تغيير الرسم شغّل أمر التحويل مرة أخرى ثم أعد تشغيل التطبيق لعرض الملف الجديد.
3. عرض الملف باستخدام VectorGraphic
ضع المثال التالي في lib/main.dart. عند تشغيله بـ flutter run تظهر أيقونة التحقق وسط الشاشة. يحدد المثال عرض الأيقونة وارتفاعها ويضيف وصفًا لقارئ الشاشة.
import 'package:flutter/material.dart';
import 'package:vector_graphics/vector_graphics.dart';
void main() {
runApp(
const MaterialApp(
home: Scaffold(
body: Center(
child: VectorGraphic(
loader: AssetBytesLoader('assets/check.svg.vec'),
width: 72,
height: 72,
semanticsLabel: 'تم التحقق',
),
),
),
),
);
}كيف تحول SVG تلقائيًا أثناء بناء Flutter؟
يمكنك استخدام Asset Transformers لتوليد البيانات الثنائية أثناء البناء. في هذه الطريقة استبدل تسجيل ملف .vec بإعداد الملف الأصلي التالي، واستخدم AssetBytesLoader('assets/check.svg') في Dart.
flutter:
assets:
- path: assets/check.svg
transformers:
- package: vector_graphics_compilerيبقى مفتاح الأصل assets/check.svg في التطبيق، بينما يضع Flutter البيانات المحوّلة تحته في حزمة البناء. لو اخترت التحويل اليدوي، يظل مفتاح الأصل في المثال هو assets/check.svg.vec. توثيق Flutter لتحويل الأصول وقت البناء.
حل مشاكل تحميل VEC واختلاف الرسم
- ظهور Unable to load asset. طابق مسار
AssetBytesLoaderمع التسجيل في YAML وحالة الأحرف على القرص. بعد إضافة أصل جديد أوقف التشغيل وشغّل التطبيق مرة أخرى. - فشل فك ترميز الملف. تأكد أن المسار يشير إلى ناتج التحويل. إذا حدّثت الحزم وظلت ملفات
.vecمن بناء قديم، أعد توليدها بأداة التحويل المثبتة في المشروع. - اختفاء لون أو جزء من الرسم. جرّب SVG بسيطًا أولًا، ثم افحص الملف المصدّر من أداة التصميم. إذا كان يعتمد على CSS معقد أو صور خارجية، راجع طريقة التصدير وقارن النتيجة بصريًا. دليل حل مشاكل SVG في Flutter وإعداد الألوان والأصول.
أسئلة شائعة عن vector_graphics في Flutter
هل يمكن فتح SVG مباشرة باستخدام VectorGraphic؟
يقرأ VectorGraphic بيانات مرمّزة. لتحميل SVG محلي استخدم خطوة التحويل، أو اضبط Flutter ليحوّل الأصل عند البناء. لعرض SVG خام مباشرة استخدم flutter_svg.
هل تحويل SVG إلى VEC يجعل الواجهة أسرع دائمًا؟
يوفّر التحويل المسبق تحليل XML وقت التشغيل، لكن الرسم نفسه يظل له تكلفة. لو كان هدفك علاج تقطيع التمرير، قارن نفس الشاشة بنفس الأصول على جهاز فعلي في وضع profile، وراجع أزمنة الإطارات في Flutter DevTools قبل تعميم التغيير.
هل يناسب VEC صور المنتجات من الشبكة؟
يناسب VEC الرسومات المتجهة المجهزة مسبقًا. إذا كانت صور المنتجات ملفات JPEG أو WebP تُحمّل من الخادم، فالمشكلة غالبًا تتعلق بزمن التحميل أو إعادة تنزيل الصور. شرح تخزين صور الشبكة مؤقتًا باستخدام cached_network_image.
راجع صفحة vector_graphics على pub.dev ومرجع VectorGraphic ودليل flutter_svg للرسومات المحوّلة مسبقًا.






