عن المشروع
أيقونات نظام Fluent UI هي مجموعة الأيقونات مفتوحة المصدر من مايكروسوفت، وتوصف بأنها مألوفة وودودة وعصرية. يوفر المستودع أصول الأيقونات بالإضافة إلى مكتبات مُولَّدة لعدة منصات.
مجموعة الأيقونات والبيانات الوصفية
- يوجد نمطان موثقان: الأيقونات العادية والأيقونات الممتلئة، ولكل منهما ملف قائمة كامل في المستودع.
- لكل أيقونة مدخل في metadata.json. تحدد خاصية `directionType` ما إذا كانت الأيقونة `unique` (نسختان منفصلتان لـ RTL وLTR) أو `mirror` (يمكن عكسها لـ RTL/LTR). وتشير خاصية `singleton` إلى الاتجاه الافتراضي.
خيارات التثبيت
- أندرويد: منشورة على Maven Central؛ أضف `mavenCentral()` إلى build.gradle الجذري واعتمد على `com.microsoft.design:fluent-system-icons:1.1.341@aar`. توثيق المكتبة موجود في android/README.md.
- iOS وmacOS: متاحة عبر CocoaPods (`pod "FluentIcons", "1.1.341"`) وCarthage (وسم git 1.1.341). التوثيق في ios/README.md.
- Flutter: أضف `fluentui_system_icons: ^1.1.341` إلى pubspec.yaml. التوثيق في flutter/README.md.
- SVG عادي: ضمّن ملفات SVG مباشرة؛ راجع packages/svg-icons/README.md.
بنية المستودع والأدوات
- يحتوي دليل `assets` على الأيقونات المصدرية؛ ويولّد المستورد مكتبات أندرويد وiOS منها.
- المستودع مساحة عمل yarn واحدة، لذا تُثبَّت تبعيات جميع الحزم معًا. يتم الإعداد باستخدام `corepack enable` و`yarn install`؛ ويوفر دليل المستورد أوامر مثل `yarn clean` و`yarn run` لسرد المهام المتاحة.
- تشغّل خطوة بناء GitHub Actions الأمرين `deploy:android` و`deploy:ios` لإنشاء المكتبات، مع تعريفات سير العمل ضمن .github/workflows/.
تطبيقات تجريبية
- أندرويد: شغّل `yarn deploy:android`، وافتح دليل android في Android Studio، واختر إعداد البناء `sample-showcase` ثم شغّله.
- Flutter: بعد إعداد Flutter في Android Studio، افتح دليل flutter، وافتح مشروع `example` ثم شغّله.
حوكمة المشروع
- يسرد README جهات الاتصال الخاصة بالتصميم وiOS وأندرويد وFlutter للأسئلة أو الطلبات، ويوجه المستخدمين إلى فتح قضايا GitHub.
- يتبع المشروع مدونة قواعد السلوك للمصادر المفتوحة من مايكروسوفت.
بشكل عام، هذا مشروع لأصول التصميم ومكتبات المكونات للمطورين والمصممين الذين يحتاجون إلى مجموعة أيقونات متسقة ومعبأة لكل منصة مع مراعاة RTL/LTR.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.