Vývojáři
Sestavujte, rozšiřujte a přispívejte
Sally je svobodný software pod GNU GPL verze 2 nebo novější, vyvíjený otevřeně na GitHub. Zde zjistíte, jak jej sestavit, rozšířit a poslat změny zpět.
Sestavení ze zdrojového kódu
Visual Studio 2022, Windows 11 SDK a CMake. Jeden příkaz sestaví Sally i všechny pluginy se všemi vestavěnými jazyky.
SestaveníNapište plugin
Rozhraním pluginů přidávejte formáty archivů, souborové systémy, prohlížeče nebo příkazy. Začněte ukázkovými pluginy.
PluginySkriptujte Sally
Automatizujte opakovanou práci pomocí JScript, VBScript a dalších jazyků Windows Script Host.
SkriptováníPřispějte
Opravte chybu, vylepšete překlad nebo nahlaste problém.
PřispětSestavení ze zdrojového kódu
Potřebujete Visual Studio 2022 s pracovní sadou Vývoj desktopových aplikací pomocí C++ a Windows 11 SDK 10.0.26100 nebo novější.
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
Spustitelný program vznikne v build/out/sally/<Config>_<Arch>/. Po každém sestavení znovu spusťte populate, aby pluginy vedle sally.exe odpovídaly programu. Předvolby CMake zahrnují x64, ARM64 a křížovou kompilaci clang-cl; vývojářská příručka popisuje strukturu repozitáře, cíle a styl kódu.
Napište plugin
Pluginy jsou DLL, které Sally načítá podle potřeby. Rozhraní je v src/plugins/shared/spl_*.h: vstupní bod registruje funkce pluginu, například archivátor (spl_arc.h), souborový systém panelů (spl_fs.h), prohlížeč, příkazy nabídky (spl_menu.h) nebo miniatury (spl_thum.h). Sally volá zpět přes obecné, grafické a souborové služby (spl_gen.h, spl_gui.h, spl_file.h).
- Začněte ukázkou:
src/plugins/demoplugvyužívá většinu rozhraní,demomenuukazuje rozšíření nabídky ademoviewprohlížeč. - Prostudujte skutečný plugin: všechny dodávané pluginy jsou v
src/plugins, od maléhochecksumpoftpazip. - Verze SDK pluginů: od Sally 1.0.33 se načítají jen pluginy pro současné SDK (109). Pluginy pro Altap Salamander 4.0 nebo starší Sally je nutné znovu sestavit s aktuálními hlavičkami.
Skriptujte Sally
Plugin Automation spouští skripty Windows Script Host s přístupem k panelům, označení, oknům průběhu a jednoduchým formulářům. Příručka popisuje objektový model a obsahuje ukázkové skripty.
Přispějte
- Kód: otevřete pull request na GitHub. Nejlépe se kontrolují malé, cílené změny s jasným popisem problému.
- Překlady: každý jazyk je běžný soubor prostředků vestavěný do Sally:
src/lang/<language>/lang.rcpro Sally asrc/plugins/<plugin>/lang/<language>/lang.rcpro každý plugin. Upravte text při zachování všech ID, stylů a pořadí ovládacích prvků podle anglického souboru a otevřete pull request, nebo chybný překlad nahlaste jako problém. Vývojářská příručka vysvětluje přidání jazyka. - Financování: příspěvky přes PayPal nebo Buy Me a Coffee hradí čas věnovaný vývoji.
- Hlášení chyb: popište problém a kroky k jeho zopakování v Issues. Uveďte verzi Sally a Windows.
- Příručka: chybnou nebo chybějící stránku nahlaste v Issues. Zdroj je zveřejněn jako manual/source.zip.