الفحص والتشغيل والبناء

فحص المصدر دون تشغيله

بعد تثبيت الأداة الأصلية المتحقق منها، احفظ مصدر Hello المعتمد باسم hello.aspl. تقبل الأوامر ملف مصدر جذريا واحدا ينتهي بـ.aspl أو .لبات مع وحدات المصدر المستوردة صراحة. يوفر الإدخال القياسي بيانات البرنامج ولا يوفر مصدره.

aspl --diagnostic-language=en check hello.aspl

يترجم check المصدر ويتحقق منه دون تنفيذه أو قراءة إدخال البرنامج أو تحميل المكتبات الخارجية أو كتابة برنامج. الفحص الناجح صامت ويعيد صفرا. لا يثبت الفحص أن التنفيذ سينجح.

التشغيل وفحص حالة العملية

aspl run hello.aspl
printf 'status=%s\n' "$?"

لا يطبع Hello شيئا ويعيد صفرا. لرؤية خرج عادي، نزّل صيغة مصدر من مثال الجمع باسم sum.aspl. يطبع aspl run sum.aspl النص 55 متبوعا بسطر جديد ويعيد صفرا. تكتب print في stdout. يحدد العدد الصحيح الذي تعيده ابدأ_الرئيسية حالة العملية ولا يطبعها. اقرأ $? مباشرة بعد الأمر الذي تقيسه.

تتراوح نتيجة دالة البداية العادية من 0 إلى 255. النتيجة غير الصفرية مسموحة، أما النتيجة خارج المجال فتسبب فخ invalid-process-status. تستخدم حالات الفشل جدول حالات الأوامر، ولذلك لا يكفي رقم الحالة وحده لتمييز نتيجة عادية عن فشل تنفيذ. اقرأ stderr أيضا.

البناء وتنفيذ برنامج مستقل

aspl build -o hello hello.aspl
./hello
printf 'status=%s\n' "$?"

ضع -o قبل مسار المصدر. يترجم build البرنامج ويتحقق منه وينشر ملف ELF تنفيذيا ذريّا. لا يشغل البرنامج أو يحمل مكتباته الخارجية أو يستدعي مترجم C أو رابطا. دون -o، يزيل لاحقة المصدر الأخيرة لاختيار اسم الخرج. لا ينشئ المجلدات الأب المفقودة. يحافظ الفشل قبل النشر على الخرج الموجود.

يحتوي ELF آلته الافتراضية وبايت كوده الخاص. يعمل دون المصدر أو تثبيت لبات أو مترجم C أو ملف بايت كود منفصل. يظل محمل Linux المتوافق ومكتبات النظام مطلوبين، وكذلك المكتبات الخارجية وملفات البيانات الخاصة بالبرنامج. تحل مسارات الملفات النسبية أثناء التنفيذ ضد دليل عمل العملية. انظر الإدخال الأصلي والبرامج المبنية.

معالجة حالات الفشل الشائعة

أصلح تشخيصات المصدر قبل التشغيل أو البناء. ملف المصدر المفقود فشل مضيف. تؤدي المصادر الجذرية المتعددة أو الخيارات اللاحقة أو المعاملات غير المدعومة أو اختيار المصدر نفسه للخرج إلى أخطاء استخدام. لمسار مصدر يبدأ بشرطة، استخدم aspl check -- -name.aspl. العربية هي لغة التشخيص الافتراضية حتى مع المصدر الإنجليزي. راجع صياغة أوامر Linux ومراحلها لمعرفة الأشكال الدقيقة.