Svelte / المتقدم: العرض والموارد وأدلة الإصدار / الدرس 17
الموائمات والبيئة ومسؤولية النشر
وافق ملفات بناء Kit 3 وقدرات التشغيل، واجعل الإعداد العام والخاص والحالة المشتركة تحت مسؤولية صريحة.
في هذه الصفحة
أهداف الدرس
- اشرح خرج الموائم ولماذا لا توفر الاستضافة الثابتة كل قدرة خادم.
- ميز بيئة Kit 3 المعلنة من اتفاقات البادئة والوحدات الثابتة الأقدم.
يستهدف الموائم عقد نشر
يحول الموائم البناء لنمط استضافة ولا يضمن ملفات أومدة أومكتبة مصدر أومخبأ متطابقاً. لا يعوض الثابت الأفعال وload الموثقة دون إعادة تصميم. يتعرف الآلي بيئات مدعومة ولا ينشئ كل بنية. راجع الخيار والخادم والأصل بالنسخة، ووافق المجمع والمهام مع العمر الفعلي لا خادم التطوير. يجب أن تحدد المراجعة ما يبقى بين طلبين وما يفقد مع مثيل جديد؛ فقد تعمل قراءة محلية في تجربة واحدة ولا يستطيع مستخدم لاحق العثور على الملف أوالنتيجة في مثيل آخر.
استخدم إعلان Kit 3 ونموذج رؤيته المختارين
يعرف Kit 3 الحالي المتغير في src/env.js بـdefineEnvVars ويتيحه عبر private أوpublic. الافتراضي خاص وتربط static:true القيمة بالبناء بدلاً من الديناميكي. يختلف عن وحدات $env وبادئة PUBLIC_ القديمة. JSON تصنيف لا إعلان فعلي أوسر، ولا تجعل الاعتماد عاماً لتسهيل العميل. قد يسرب الخاص قيمته إن أعادتها load أوaction. ينبغي أن يوضح العقد هل يتوقع المسؤول تبديل القيمة عند بدء التطبيق أوإعادة بناء، لأن ترقية الملف نفسه بين بيئتين لا تغير بايتاً ضمن فيه إعداد ثابت مسبقاً.
{"selectedKitMajor":3,"declaration":"src/env.js-defined-variables","privateAccess":"$app/env/private","publicAccess":"$app/env/public","defaultVisibility":"private","staticTrue":"build-bound","credentialValue":"not-contained"}لا يحمل السجل اعتماداً وليس ضبط defineEnvVars فعلياً، ولم تحمل بيئة.
احفظ الضبط وأسماء الوحدات مع البناء
ينقل Kit 3 الضبط إلى ملحق Vite ويستخدم #lib باستيرادات الحزمة المعلنة وامتداد مناسب لا $lib تلقائية. تسافر المدخلات والقفل والخرج مع الترقية والتراجع. قد يلتقط العميل والمحضّر العام مبكراً فافحص وقت الربط. لا يشغل المقرر ترقية أويثبت أويعدل نشراً؛ يوثق العقد لا نتيجة منشورة. يمكن أن يعاد ملف خادم سابق مع خريطة استيراد أحدث غير موافقة، لذلك يراجع التراجع كمجموعة لا مجرد استبدال ملف جافاسكربت واحد وترك أدوات البناء والإعداد على حالها.
تحقق من خيار محدود دون قراءة بيئة حقيقية
يفترض المحلل عشرة للغائب ويقبل موجباً كاملاً حتى خمسين ويرفض المخالف. الأرقام اصطناعية ولا يقرأ process.env أوسراً أوملفاً. يحفظ الإعلان الحقيقي فرق الغياب وخطأ النشر ويذكر الاسم بأمان. لا يثبت الاختبار تحميل Kit أوترجمة ثابت أوإتاحة الموائم؛ تحتاج الأدوات الدقيقة. قد تكون الدالة صحيحة ومصنع الإعداد لا يستدعيها أصلاً، أوقد يمرر string بعد الفحص إلى موضع يتوقع number، فيجب أن يختبر الدمج عقد النوع الناتج لا الرسالة المحلية وحدها.
function option(text){
if(text===undefined)return 10;
if(typeof text!=="string" || !/^[1-9][0-9]*$/.test(text))throw new Error("INVALID_LIMIT");
const n=Number(text);if(!Number.isSafeInteger(n)||n>50)throw new Error("INVALID_LIMIT");return n;
}
console.assert(option(undefined)===10 && option("20")===20);
let rejected=false;try{option("20rows");}catch{rejected=true;}console.assert(rejected);يفترض الغياب ويرفض المخالف دون وصول لوحدة بيئة Kit أومشغلها.
تحقق من المشاركة والتنظيف والتراجع لا افتراض الديمومة
لا يشترك العمال تلقائياً في المتغير والخريطة والجلسة والملف، ولا يكون القرص العابر رفعاً دائماً. عرف المخزن والتصريف والتنظيف وعدم يقين الإيقاف، وافحص الجاهزية دون سر. يحلل المقرر التصنيف وينفذ المحلل فقط دون بناء أوموائم أونشر أوعملية أواتصال أوسحابة. يحتاج الحقيقي إذناً ونسخاً وملفات وحدوداً لا عبارة نجاح عامة. ينبغي أن يتضح ما إذا أثبت الاختبار محلياً حساب خيار، أم أثبت فعلياً أن التطبيق سيستقبل الطلب بهويته الصحيحة بعد استبدال مثيل أوتراجع إصدار.
الأخطاء الشائعة وإصلاحها
يعلن اعتماد خاص عاماً للسهولة
- لماذا يحدث؟
- استخدم ضبط الرؤية اختصاراً لعبور حد الخادم.
- كيف تصلحه؟
- أبق الاعتماد خاصاً واختر القيم المسموحة للعميل فقط.
- كيف تتجنب تكراره؟
- راجع نتيجة load والفعل وخرج العميل المولد.
يكسر افتراض $lib قديم استيراد Kit 3
- لماذا يحدث؟
- أهمل الانتقال استيرادات #lib المعلنة والامتدادات.
- كيف تصلحه؟
- حدث الأسماء وفق عقد الحزمة والبناء المختار.
- كيف تتجنب تكراره؟
- تحقق من حل المشغل والمترجم بعينات محفوظة.
تسمى حالة عامل محلية تخزيناً مشتركاً دائماً
- لماذا يحدث؟
- لم تراجع حدود المثيل وأعمار استمرار البيانات.
- كيف تصلحه؟
- استخدم بروتوكول تخزين مشترك مراجعاً حيث يلزم.
- كيف تتجنب تكراره؟
- اختبر الاستبدال والمثيلات المتعددة بصورة مستقلة.
اختبر فهمك
1. هل يمنع استيراد بيئة خاصة كل تسريب ممكن؟
اعرض الحل المشروح
لا. يحمي حد الاستيراد وقد يعيد الكود القيمة أو يعرضها. راجع جمهور النتيجة والسجل، وأبق المصدر خادمياً وأعد نموذجاً عاماً أومحدوداً بالهوية بقصد.
2. لماذا تسجل ربط القيمة الثابت أوالديناميكي مع ملف مرقى؟
اعرض الحل المشروح
قد تضمن الثابت في بايتات ويعتمد الديناميكي الموائم والبدء، فلا تعيد البيئة اللاحقة كتابة الملفات. تحقق من الربط وأعد البناء أو اختر تصميم التشغيل المدعوم بقصد.
أهم ما تعلمته
- خرج الموائم ورؤية البيئة والعمر عقود تطبيق.
- لا يصادق محلل محلي الاستضافة أوالديمومة.