Creating and Installing plugins¶

Important

செருகுநிரல்கள் ஒரு சோதனை அம்சம்! பநிஇ மாறக்கூடும்.

உங்கள் கருத்தை வழங்க முயற்சிக்கிறோம்.

நிலையான விநியோகங்களில் வழங்கப்பட்ட அம்சங்களுக்கு அப்பால் கஃபரின் செயல்பாட்டை நீட்டிக்க செருகுநிரல்கள் உங்களை அனுமதிக்கின்றன. குறிப்பாக, பதிவிறக்கப் பக்கத்தில் இல் கிடைக்கும் பைனரி விநியோகங்களை நிறுவினால் செருகுநிரல்கள் உதவியாக இருக்கும்.

நுழைவு புள்ளிகள் வழியாக பல வழிகளில் கஃபர் நீட்டிக்கப்படலாம்:

பயன்பாடு (உலகளாவிய) சேவைகள் (gaphor.appservices)
அமர்வு குறிப்பிட்ட சேவைகள் (kaphor.services)
மாதிரியமைத்தல் மொழிகள் (gaphor.modelinglanguages)
(துணை) கட்டளை வரி பாகுபடுத்தி (gaphor.argparse)
மறைமுகமாக ஏற்றப்பட்ட தொகுதிகள் (kaphor.modules), முக்கியமாக இடைமுகம் கூறுகளுக்கு

செருகுநிரல்களுக்கான இயல்புநிலை இருப்பிடம் $ முகப்பு/.லோகல்/கஃபர்/செருகுநிரல்கள் -2 ( $ பயனர்/.லோகல்/கஃபர்/செருகுநிரல்கள் -2 விண்டோசில்). சுற்றுச்சூழல் மாறியை gaphor_plugin_path அமைப்பதன் மூலம் இந்த இருப்பிடத்தை மாற்றலாம் மற்றும் ஒரு கோப்பகத்தை சுட்டிக்காட்டலாம்.

சொருகி நிறுவவும்¶

இந்த நேரத்தில் செருகுநிரல்களை நிறுவவும் பராமரிக்கவும் காஃபருக்கு தொகுக்கப்பட்ட செயல்பாடு இல்லை. ஒரு சொருகி நிறுவ, உங்கள் கணினியில் பைதான் நிறுவலில் இருந்து பிப் ஐப் பயன்படுத்தவும். மேகோச் மற்றும் லினக்சில், அது எளிதாக இருக்க வேண்டும், சாளரங்களில் நீங்கள் [python.org] (https://python.org) அல்லது சாளரங்கள் ச்டோரிலிருந்து தனித்தனியாக பைத்தானை நிறுவ வேண்டியிருக்கும்.

Important

உங்கள் கணினி பைதான் பதிப்பில் செருகுநிரல்கள் நிறுவப்பட்டிருப்பதால், செருகுநிரல்கள் தூய பைதான் மற்றும் தொகுக்கப்பட்ட சி குறியீட்டைக் கொண்டிருக்கவில்லை என்பது முதன்மை.
பிளாட்பேக்காக நிறுவப்பட்ட காஃபரை நீங்கள் பயன்படுத்தினால், நீங்கள் பயனர் கோப்புகளுக்கு (கோப்பு முறைமை = வீடு) காஃபர் அணுகலை வழங்க வேண்டும், எனவே உங்கள் .லோகல் கோப்புறையில் கோப்புகளைக் காணலாம். பிளாட்பேக்குகளின் அனுமதிகளை மாற்ற நீங்கள் [flatseal] (https://flathub.org/apps/com.github.tchx84.flatseal) ஐப் பயன்படுத்தலாம்.

எடுத்துக்காட்டாக: லினக்ச் மற்றும் மேகோசில் [அலோ வேர்ல்ட் சொருகி] (https://github.com/gaphor/gaphor_plugin_helloworld) ஐ நிறுவ, உள்ளிடவும்:

pip install --target $HOME/.local/gaphor/plugins-2 git+https://github.com/gaphor/gaphor_plugin_helloworld.git

நீங்கள் பொதுவாக விரும்பியபடி கஃபரைத் தொடங்குங்கள். கருவிகள் பட்டியலில் (! மெனு ஐகான் → கருவிகள் → அலோ வேர்ல்ட்) ஒரு புதிய அலோ உலக நுழைவு சேர்க்கப்பட்டுள்ளது.

உங்கள் சொந்த சொருகி உருவாக்கவும்¶

நீங்களே ஒரு சொருகி எழுத விரும்பினால், காஃபரின் வடிவமைப்பு கோட்பாடுகள், சேவை சார்ந்த கட்டமைப்பு மற்றும் நிகழ்வு இயக்கப்படும் கட்டமைப்பு ஆகியவற்றை நீங்கள் அறிந்து கொள்ளலாம்.

எடுத்துக்காட்டு சொருகி¶

உங்கள் சொந்த சொருகி எவ்வாறு உருவாக்குவது என்பதற்கான எடுத்துக்காட்டுக்கு கிட்அப்பில் கிடைக்கும் [அலோ வேர்ல்ட் சொருகி] (https://github.com/gaphor/gaphor_plugin_helleorld) ஐப் பார்க்கலாம்.

[Pyproject.toml] (https://github.com/gaphor/gaphor_plugin_helloworld/blob/main/pyproject.toml) கோப்பில் ஒரு சொருகி உள்ளது:

[tool.poetry.plugins."gaphor.services"]
"helloworld" = "gaphor_helloworld_plugin:HelloWorldPlugin"

இது தொகுப்பு/தொகுதி [KAPHOR_PLUGINS_HELELEDORLD] (https://github.com/gaphor/gaphor_plugin_helledorld/blob/main/gaphor_helloorld_plugin/it.py) வகையை வகைப்படுத்துகிறது.

அலோ வேர்ல்ட் செருகுநிரலின் பறிக்கப்பட்ட பதிப்பு இங்கே:

from gaphor.abc import Service, ActionProvider
from gaphor.core import _, action

class HelloWorldPlugin(Service, ActionProvider):     # 1.

    def __init__(self, tools_menu):                  # 2.
        self.tools_menu = tools_menu
        tools_menu.add_actions(self)                 # 3.

    def shutdown(self):                              # 4.
        self.tools_menu.remove_actions(self)

    @action(                                         # 5.
        name="helloworld",
        label=_("Hello world"),
        tooltip=_("Every application…"),
    )
    def helloworld_action(self):
        main_window = self.main_window
        ...  # gtk code left out

முன்பு கூறியது போல, ஒரு சொருகி சேவை இடைமுகத்தை செயல்படுத்த வேண்டும். இது ஆக்சன் ப்ரோவைடர் ஐ செயல்படுத்துகிறது, இது பயனரால் செய்யப்பட வேண்டிய சில செயல்களைக் கொண்டுள்ளது என்று கூறுகிறது.
பட்டியல் நுழைவு "கருவிகள்" நீட்டிப்பு மெனுவின் ஒரு பகுதியாக இருக்கும். இந்த நீட்டிப்பு புள்ளி ஒரு சேவையாக உருவாக்கப்பட்டது. பிற சேவைகளையும் சார்புகளாகவும் அனுப்பலாம். சேவைகள் மற்ற சேவைகளைப் பற்றிய குறிப்புகளைப் பெறலாம், அவற்றை கட்டமைப்பாளரின் வாதங்களாக வரையறுக்கிறது.
இந்த சேவையில் வரையறுக்கப்பட்ட அனைத்து நடவடிக்கைகளும் பதிவு செய்யப்பட்டுள்ளன.
ஒவ்வொரு சேவையிலும் பணிநிறுத்தம் () முறை உள்ளது. இது மூடப்படும் போது சில தூய்மைப்படுத்தலைச் செய்ய சேவையை அனுமதிக்கிறது.
செயல்படுத்தக்கூடிய செயல். செயல் வரையறுக்கப்படுகிறது மற்றும் கூடுதல்_ஆக்சிகள் () முறை மூலம் எடுக்கப்படும் (பார்க்க 3.)

சொருகி மேம்பாட்டு கேள்விகள்¶

எனது சொருகி சேவைகளை எவ்வாறு அணுகுவது?¶

உங்கள் சொருகி வகுப்பின் INIT செயல்பாட்டில் பணி பெயர்களை பட்டியலிடுவதன் மூலம் காஃபரின் சேவைகளை அணுக முடியும். இதற்கு ஒரு அடிப்படை வகுப்பாக சேவையை உள்ளடக்கியது. எலோவோர்ல்ட்ப்ளூகின் எடுத்துக்காட்டில், கருவிகள்_மெனு பணி சேர்க்கப்பட்டுள்ளது.

இந்த அணுகுமுறையின் முழுமையான விளக்கத்தை சேவை சார்ந்த கட்டிடக்கலை ஆவணப்படுத்தல் பக்கம் இல் காணலாம்.