أول برنامج أصلي

اختيار الأداة والتحقق منها

يفترض هذا المسار أنك تستخدم الطرفية بالفعل، ولا يتطلب إكمال دروس المبتدئين. تحقق أولا من متطلبات النظام. تختار هذه التعليمات لبات 0.7.0 لنظام Linux بمعمارية x86-64. أما Console فهو اختياري ومنفصل.

نزّل أرشيف الأداة الأصلية وملف SHA256SUMS الخاص به في مجلد جديد. تحقق قبل الاستخراج أو التنفيذ، وتوقف عند اختلاف البصمة أو خطأ الأرشيف. تكشف البصمة اختلاف البايتات، لكن تنزيلها من الموقع نفسه لا يجعلها توقيعا مستقلا للناشر.

sha256sum --check SHA256SUMS &&
tar -tJf aspl-0.7.0-x86_64-linux-gnu.tar.xz &&
tar -xJf aspl-0.7.0-x86_64-linux-gnu.tar.xz

يحتوي الأرشيف مجلدا واحدا باسم aspl-0.7.0-x86_64-linux-gnu/ فيه aspl وDEPENDENCIES.json والرخصتان وTHIRD-PARTY-NOTICES. لا يوجد سكربت تثبيت. احتفظ بهذه الملفات معا في مجلد مستخدم خاص بالإصدار، ثم اختر الملف التنفيذي بوصلة رمزية. إذا كان ~/.local/bin/aspl موجودا، فافحصه قبل استبداله.

mkdir -p "$HOME/.local/opt" "$HOME/.local/bin"
mv aspl-0.7.0-x86_64-linux-gnu "$HOME/.local/opt/"
ln -s "$HOME/.local/opt/aspl-0.7.0-x86_64-linux-gnu/aspl" "$HOME/.local/bin/aspl"
export PATH="$HOME/.local/bin:$PATH"
hash -r

نفذ ذلك مرة واحدة للإصدار المختار. افحص مجلد الإصدار الموجود بدلا من الكتابة فوقه. أضف سطر export PATH مرة واحدة إلى ملف بدء الصدفة إذا أردت استعماله في الطرفيات اللاحقة.

التحقق من التثبيت المختار

command -v aspl
aspl --version
aspl --diagnostic-language=en --help

يجب أن يشير الأمر الأول إلى تثبيت المستخدم المختار، وأن يكون الإصدار aspl 0.7.0. إذا اختير تثبيت آخر، فافحص ترتيب PATH وامسح ذاكرة أوامر الصدفة. عند فقد المحمل أو مكتبة مشتركة، راجع متطلبات المضيف بدلا من اعتباره خطأ في المصدر. العربية هي لغة التشخيص الافتراضية؛ يغير --diagnostic-language=en التشخيصات دون المصدر أو الخرج.

حفظ برنامج أول كامل

نزّل إحدى صيغ المصدر المتاحة أدناه واحفظها باسم hello.aspl، ثم اتبع مسار الفحص والتشغيل والبناء. يعيد برنامج Hello المعتمد حالة صفر ولا يطبع شيئا. طباعة النص وإرجاع حالة العملية عمليتان منفصلتان.

دالة ابدأ_الرئيسية() -> ص64 {
    أرجع 0.
}

{
  "browser": {
    "check": "success",
    "class": "success",
    "output": "",
    "processStatus": 0
  },
  "native": {
    "check": 0,
    "status": 0,
    "output": ""
  }
}

الترقية والرجوع وإلغاء التثبيت

للترقية، اختر إصدارا منشورا من سجل الإصدارات. اقرأ متطلباته، وتحقق من أرشيفه وبصماته الخاصة، واستخرجه في مجلد إصدار منفصل. اختبر مساره التنفيذي المطلق على مصدرك بأوامر --version وcheck وrun وbuild قبل اختياره. احتفظ بالمجلد السابق ونسخ المصدر الاحتياطية.

لاختيار مجلد 0.7.0 المتحقق منه مجددا في Bash:

ln -sfn "$HOME/.local/opt/aspl-0.7.0-x86_64-linux-gnu/aspl" "$HOME/.local/bin/aspl"
hash -r
command -v aspl
aspl --version

يغير الرجوع إلى إصدار أصلي هذه الوصلة إلى ملف تنفيذي أصلي سابق احتفظت به. استبدل المسار بمجلد الإصدار السابق المتحقق منه وافحص الإصدار وتوافق المصدر. لا يعيد ذلك كتابة البرامج التي بنيت بإصدار آخر. تستعيد حزمة استعادة موقع لبات تقديم الموقع وأصوله المحتفظ بها، ولا ترجع الأداة الأصلية المثبتة على جهازك.

لإلغاء هذا التثبيت، تحقق أولا من هدف الوصلة بأمر readlink "$HOME/.local/bin/aspl". احذف الوصلة ومجلد الإصدار المحدد فقط إذا كانا التثبيت المقصود:

rm "$HOME/.local/bin/aspl"
rm -r "$HOME/.local/opt/aspl-0.7.0-x86_64-linux-gnu"
hash -r
command -v aspl

احذف سطر PATH من ملف بدء الصدفة فقط إذا لم تستخدم أدوات أخرى ذلك المجلد. تبقى ملفات المصدر والبرامج المبنية قابلة للاستعمال. ولـConsole خطوات إلغاء مستقلة.