Vývojári

Zostavujte, rozširujte a prispievajte

Sally je slobodný softvér pod GNU GPL verzie 2 alebo novšej, otvorene vyvíjaný na GitHub. Tu zistíte, ako ho zostaviť, rozšíriť a poslať zmeny späť.

Zostavenie zo zdrojového kódu

Visual Studio 2022, Windows 11 SDK a CMake. Jeden príkaz zostaví Sally aj všetky pluginy so zabudovanými jazykmi.

Zostavenie

Napíšte plugin

Pridávajte archívne formáty, súborové systémy, prehliadače alebo príkazy cez rozhranie pluginov; začnite ukážkovými pluginmi.

Pluginy

Skripty pre Sally

Automatizujte opakovanú prácu pomocou JScriptu, VBScriptu alebo iných jazykov Windows Script Host.

Skriptovanie

Prispejte

Opravte chybu, zlepšite preklad alebo nahláste problém.

Prispievanie

Zostavenie zo zdrojového kódu

Potrebujete Visual Studio 2022 s pracovným zaťažením Desktop development with C++ a Windows 11 SDK verzie 10.0.26100 alebo novšej.

git clone https://github.com/0xeb/sally.git
cd sally
cmake -S . -B build
cmake --build build --config RelWithDebInfo
cmake --build build --config RelWithDebInfo --target populate

Spustiteľný program sa uloží do build/out/sally/<Config>_<Arch>/. Po každom zostavení znova spustite populate, aby pluginy vedľa sally.exe zodpovedali aplikácii. Predvoľby CMake pokrývajú x64, ARM64 a krížovú kompiláciu clang-cl; sprievodca vývojára opisuje rozloženie repozitára, ciele a štýl kódu.

Napíšte plugin

Pluginy sú DLL, ktoré Sally načítava podľa potreby. Rozhranie je v src/plugins/shared/spl_*.h: vstupný bod zaregistruje funkcie pluginu, napríklad archivátor (spl_arc.h), súborový systém panelov (spl_fs.h), prehliadač, príkazy ponuky (spl_menu.h) alebo miniatúry (spl_thum.h); Sally spätne volá všeobecné, grafické a súborové služby (spl_gen.h, spl_gui.h, spl_file.h).

Začnite ukážkou: src/plugins/demoplug využíva väčšinu rozhraní, demomenu ukazuje rozšírenie ponuky a demoview prehliadač.
Preskúmajte skutočný plugin: všetky pribalené pluginy sú v src/plugins, od malého checksum po ftp a zip.
Verzia plugin SDK: od Sally 1.0.33 sa načítajú len pluginy zostavené pre aktuálne plugin SDK (109). Pluginy pre Altap Salamander 4.0 alebo staršie verzie Sally treba zostaviť s aktuálnymi hlavičkami.

Skripty pre Sally

Plugin Automatizácia spúšťa skripty Windows Script Host s prístupom k panelom, výberu, oknám priebehu a jednoduchým formulárom. Jeho príručka dokumentuje objektový model a dodáva ukážkové skripty.

Prispejte

Kód: otvorte pull request na GitHub. Malé cielené zmeny s jasným opisom problému sa kontrolujú najľahšie.
Preklady: každý jazyk je bežný súbor prostriedkov zabudovaný do Sally: src/lang/<language>/lang.rc pre Sally a src/plugins/<plugin>/lang/<language>/lang.rc pre každý plugin. Upravte text so zachovaním všetkých ID, štýlov a poradia ovládacích prvkov podľa anglického súboru a otvorte pull request alebo nahláste chybný preklad. Sprievodca vývojára vysvetľuje pridanie jazyka.
Financovanie: príspevky cez PayPal alebo Buy Me a Coffee hradia čas venovaný vývoju.
Hlásenia chýb: opíšte problém a kroky reprodukcie v Issues. Uveďte verziu Sally a verziu Windows.
Príručka: chybnú alebo chýbajúcu stránku nahláste v Issues. Zdroj je zverejnený ako manual/source.zip.