Shell plaginlari¶
OmarOS ish stoli omaros-shell deb ataluvchi bitta uzoq yashovchi Quickshell jarayoni sifatida ishlaydi va ekranda koʻrgan deyarli hamma narsa uning ichidagi plagindir. Panel plagindir. Undan tushadigan panellar, emoji tanlagich va almashish buferi boshqaruvchisi kabi toʻliq ekran ustqoplamalari, OmarOS menyusining oʻzi, qulflash ekrani, polkit dialogi va batareyangizni kuzatuvchi hamda kechasi ekraningizni isituvchi boshsiz xizmatlar ham shunday.
Bu shunchaki amalga oshirish tafsiloti emas. Bu siz ish stolining qismlarini oʻchirishingiz, ularni almashtirishingiz yoki OmarOS manbasining bir qatoriga tegmasdan oʻzingiznikini yozishingiz mumkinligini anglatadi.
Birinchi tomon plaginlari OmarOS bilan keladi va $OMAROS_PATH/shell/plugins/ da yashaydi. Oʻzingiz qoʻshgan har qanday narsa — oʻz tajribalaringiz yoki GitHub da topgan biror narsangiz — ~/.config/omaros/plugins/ da yashaydi. Ikkalasi ham boshlangʻichda bir xil tarzda topiladi, lekin oʻrnatilganlar ishonchli shell interfeyslarini oladi, uchinchi tomon plaginlari esa oʻz xizmati va hayot aylanishi bilan cheklangan interfeys oladi. Oʻrnatilganlarning klonlari faqat asl xulq-atvor uchun kerak boʻlgan manbaga xos konfiguratsiya va UI chaqiruvlarini saqlaydi.
Sizda nima borligini koʻrish¶
Bu har bir topilgan plaginni uning id si, yoqilganligi, birinchi tomon yoki uchinchi tomon ekanligi, uning turlari va koʻrinish nomi bilan chop etadi. Agar uni boshqa narsaga berayotgan boʻlsangiz, --json ni qoʻshing.
Plagin id lari nom maydoniga ega. Oʻrnatilganlarning hammasi omaros. bilan boshlanadi — omaros.clock, omaros.network, omaros.notifications — va oʻsha nom maydoni zaxiralangan, shuning uchun uchinchi tomon plagini hech qachon uni daʼvo qila olmaydi.
Ularni yoqish va oʻchirish¶
Yoki menyudan foydalaning: Sozlash > Plugins da Enable, Disable, Add, Clone va Remove bor, har biri faqat oʻsha amal uchun mantiqiy boʻlgan plaginlarni taklif qiluvchi tanlagich bilan.
Yoqilgan holat ~/.config/omaros/shell.json da saqlanadi va qoida ikki turdagi plagin uchun biroz farq qiladi. Uchinchi tomon plagini uning id si oʻsha faylning qayeridadir paydo boʻlganda aynan yoqilgan boʻladi — panel tartibi yozuvi sifatida, plugins[] dagi yozuv sifatida yoki bar.id sifatida. Panel vidjetlari boʻlmagan birinchi tomon plaginlari teskari ravishda: ular standart tarzda yoniq va faqat disabledPlugins[] da roʻyxatga olinishi orqali oʻchadi.
Toʻliq panel plagini umuman oʻchirilgan holatga ega emas. Har doim aynan bitta panel bor, shuning uchun uni boshqasini yoqish orqali almashtirasiz. Panel vidjeti joylashuvi yuqori panel da qoplangan.
Git dan plagin qoʻshish¶
Uchinchi tomon plagini shunchaki ildizida manifest.json ga ega git repo dir.
U biror narsa qilishidan oldin, u sizga ochiq aytadiki, plaginlar uzoq yashovchi shell jarayoningiz ichida ixtiyoriy, sandboxsiz kod sifatida ishlaydi, sizga URL ni koʻrsatadi va tasdiqlashni soʻraydi. Buni jiddiy qabul qiling. Uchinchi tomon plagin interfeysi autentifikatsiya xizmatlarini toʻgʻridan-toʻgʻri ochmaydi va almashtirish paneli sozlangan autentifikatsiya boʻlmagan UI uchun faqat cheklangan imkoniyatlar oladi. Vizual plaginlar baribir shellning QML sahnasini ulashadi va oddiy ona obʼektlarni aylanib oʻtishi mumkin, barcha plagin kodi esa foydalanuvchi hisobingiz yeta oladigan hamma narsa bilan ishlaydi. Autentifikatsiya holati oʻsha xizmatlarni yetib boʻlmaydigan host obʼekt grafidan tashqarida saqlash orqali alohida himoyalanadi. Faqat ishlatishga tayyor boʻlgan repolarni qoʻshing va ularni yoqishdan oldin oʻqing.
Almashtirish paneli oʻrnatilgan vidjetlarni chizishi mumkin, lekin xizmatga tayangan uchinchi tomon vidjetlari u yerda kamaygan funksionallikka ega boʻlishi mumkin, chunki panel boshqa plaginning jonli xizmat obʼektini soʻray olmaydi. Agar bunday vidjetga sherik xizmati kerak boʻlsa, oʻrnatilgan omaros.bar ga qayting.
Keyin u reponi oraliq katalogga klonlaydi, manifestni tekshiradi, agar boshqa plagin allaqachon oʻsha id ni daʼvo qilsa oʻrnatishni rad etadi va uni ~/.config/omaros/plugins/<id>/ ga koʻchiradi. --enable siz u hozir uni yoqishni xohlaysizmi deb soʻraydi va siz yoʻq deyib avval kodni oʻqib chiqishingiz mumkin. U hech qachon plagindan biror narsani ishga tushirmaydi, hech qachon oʻrnatish hookini bajarmaydi va hech qachon sudo soʻramaydi — u fayllarni klonlaydi, manifestni tekshiradi va IPC orqali bitni aylantiradi.
Yangilash oʻsha bir xil checkoutning fast-forward tortilishidir:
Id siz u sizda bor har bir git tomonidan boshqariladigan plaginni yangilaydi. U fargini qoʻllashdan oldin koʻrsatadi, agar u fast-forward qilib oʻta olmaydigan mahalliy oʻzgarishlaringiz boʻlsa yangilashni rad etadi va yangi reviziya tekshirishdan oʻtmasa qaytarib beradi.
Olib tashlash avval plaginni oʻchiradi, keyin agar u git checkout boʻlsa uni oʻchiradi (repo baribir yuqori oqimda) yoki agar u symlink boʻlsa uni uzadi. Git repori yoʻq qoʻlda yasalgan plagin jildi toʻgʻridan-toʻgʻri oʻchirish oʻrniga plaginlar katalogi ichidagi vaqt tamgʻalangan zaxiraga koʻchiriladi.
Uni oʻzgartirish uchun oʻrnatilganni klonlash¶
Bu mening sevimli qismim. Agar oʻrnatilgan vidjetning qanday ishlashini oʻzgartirmoqchi boʻlsangiz, $OMAROS_PATH ostidagi fayllarni tahrirlamang — ular paketga tegishli va keyingi yangilanish ularni ustiga yozadi. Uning oʻrniga uni klonlang:
Bu butun plaginni ~/.config/omaros/plugins/omar.clock ga nusxalaydi (sizning foydalanuvchi nomingiz, menikimas), uni "My Clock" deb qayta nomlaydi, yoqadi va shellni oʻrnatilgandan sizning nusxangizga oʻtkazadi — mavjud panel vidjetining joyi va sozlamalarini saqlab qoladi. Yangi katalogni darhol $EDITOR ingizda ochish uchun --edit ni qoʻshing, menyuning Sozlash > Plugins > Clone Plugin i siz uchun shuni qiladi.
Foydalanuvchi nomi prefiksi kloningiz id sini sizniki qilib saqlaydi, shuning uchun uni ulashish boshqalarniki bilan toʻqnashmaydi. Asl oʻrnatilgan id ga qilingan chaqiruvlar kloningizga yoʻnaltiriladi, shuning uchun omaros.clock ga ishora qilgan hech narsani yangilash kerak emas. Va agar uni tartibsiz qilib qoʻysangiz, omaros plugin remove omar.clock oʻrnatilganni qaytarib qoʻyadi.
~/.config/omaros/plugins/ ostidagi istalgan joydagi faylni saqlash plagin kodini avtomatik qayta yuklaydi, shuning uchun muharrirni ochiq qoldirib, oʻzgarishlaringiz tushishini kuzatishingiz mumkin.
Oʻzingiznikini yozish¶
Plagin manifest.json va biroz QML ga ega katalogdir. Manifest schemaVersion: 1, id, name, version, bir yoki bir nechta kinds va har bir tur uchun QML fayliga ishora qiluvchi entryPoints obʼektini eʼlon qiladi:
| Tur | U nima |
|---|---|
bar-widget |
Faol panel boʻlimga tushira oladigan komponent |
panel |
Doimiy yoki chaqirilgan suzuvchi oyna |
overlay |
Toʻliq ekran ustqoplama |
menu |
Chaqirilgan menyu yuzasi |
service |
UI si yoʻq boshsiz singleton |
bar |
Oʻrnatilganni almashtiruvchi toʻliq panel |
Plagin bir vaqtning oʻzida bir nechta turni eʼlon qilishi mumkin — media plagini ham service, ham bar-widget dir. Panel vidjetlari koʻrinish nomi, kategoriyasi, ixtiyoriy defaultSection va panelda bittadan koʻp boʻlish mantiqiymi yoki yoʻqligini aytuvchi allowMultiple bilan qoʻshimcha barWidget blokini oladi. Koʻpchilik vidjetlar uni false ga belgilaydi; kengaytiruvchilar va koʻrsatkichlar uni true ga belgilaydi.
Biror narsani chop etishdan oldin uni tekshiring:
Bu shell yuklash vaqtida bajaradigan bir xil tekshiruvlarni ishga tushiradi: sxema versiyasi, talab qilinadigan maydonlar, zaxiralanmagan id, xavfsiz nisbiy yoʻllar boʻlgan va haqiqatan ham mavjud boʻlgan kirish nuqtalari, daʼvo qilgan har bir turingiz uchun kirish nuqtasi va jild ichida hech qanday symlinklar yoʻqligi.
Plagin dasturlash uchun shell maʼlumotnoma va birinchi tomon plagin katalogi ga qarang.
Oʻzingiznikini dunyo bilan ulashish¶
Oʻzingizga yoqqan narsani yasaganingizdan soʻng, uni ommaviy git reporiga qoʻying. Bu butun tarqatish mexanizmidir — har kim keyin URL ingizga qarshi omaros plugin add ni ishga tushirib, uni soniyalar ichida ishlatishi mumkin.