الانتقال إلى المحتوى الرئيسي
يحتوي مجلد public/ في جذر تطبيقك على ملفات ثابتة — صور وأيقونات وخطوط وأي أصول أخرى يحتاجها تطبيقك وقت التشغيل. تُدرج هذه الملفات تلقائيًا في عمليات البناء، وتُزامَن أثناء وضع التطوير، وتُرفَع إلى الخادم. الملفات الموضوعة في public/ هي:
  • متاحة للعامة — بمجرد مزامنتها إلى الخادم، تُقدَّم الأصول عبر عنوان URL عام. لا حاجة إلى مصادقة للوصول إليها.
  • متاحة في المكوّنات الأمامية — استخدم عناوين الأصول لعرض الصور أو الأيقونات أو أي وسائط داخل مكوّنات React لديك.
  • متاحة في الدوال المنطقية — أشِر إلى عناوين الأصول في رسائل البريد الإلكتروني أو استجابات واجهات البرمجة أو أي منطق على جهة الخادم.
  • مستخدمة لبيانات تعريف السوق — يشير الحقلان logo وgalleryImages في defineApplication() إلى ملفات من هذا المجلد (مثل public/logo.png). تُعرَض هذه عند نشر تطبيقك في السوق. يتم تجاهل عناوين URL المطلقة الخارجية لهذه الحقول — بدلاً من ذلك، قم بتجميع الصور في public/. يجب ألا يتجاوز حجم كل صورة 10 ميغابايت.
  • تُزامَن تلقائيًا في وضع التطوير — عند إضافة ملف في public/ أو تحديثه أو حذفه، تتم مزامنته إلى الخادم تلقائيًا. لا حاجة لإعادة التشغيل.
  • مضمَّنة في عمليات البناء — يقوم yarn twenty dev:build بتجميع جميع الأصول العامة ضمن مخرجات التوزيع.

الوصول إلى الأصول العامة باستخدام getPublicAssetUrl

استخدم المساعد getPublicAssetUrl من twenty-sdk للحصول على العنوان الكامل لملف في دليل public/ لديك. يعمل ذلك في كلٍ من الدوال المنطقية والمكوّنات الأمامية. في دالة منطقية:
src/logic-functions/send-invoice.ts
في مكوّن أمامي:
src/front-components/company-card.tsx
وسيطة path نسبية إلى مجلد public/ الخاص بتطبيقك. كلٌّ من getPublicAssetUrl('logo.png') وgetPublicAssetUrl('public/logo.png') يُحلاّن إلى العنوان نفسه — تتم إزالة بادئة public/ تلقائيًا إن وُجدت.