Fejlesztők
Fordítás, bővítés és közreműködés
A Sally a GNU GPL 2. vagy újabb verziója szerint terjesztett szabad szoftver, amelyet nyíltan fejlesztünk a GitHub oldalán. Így fordíthatja le, bővítheti, és küldheti vissza a változtatásait.
Fordítás forrásból
Visual Studio 2022, Windows 11 SDK és CMake szükséges. Egyetlen parancs lefordítja a Sally programot és összes pluginját, minden nyelvvel beépítve.
FordításPlugin írása
Adjon hozzá archívumformátumokat, fájlrendszereket, megjelenítőket vagy parancsokat a plugininterfészen keresztül, a mintapluginokból kiindulva.
PluginokA Sally vezérlése szkripttel
Automatizálja az ismétlődő munkát JScript, VBScript vagy a Windows Script Host más nyelvei segítségével.
SzkriptelésKözreműködés
Javítson hibát, fejlesszen fordítást, vagy jelentsen problémát.
KözreműködésFordítás forrásból
Visual Studio 2022 szükséges a Desktop development with C++ munkaterheléssel és a Windows 11 SDK 10.0.26100 vagy újabb verziójával.
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
A futtatható program a build/out/sally/<Config>_<Arch>/ helyre kerül. Minden fordítás után futtassa újra a populate parancsot, hogy a sally.exe melletti pluginok illeszkedjenek hozzá. A CMake-előbeállítások lefedik az x64, az ARM64 és a clang-cl keresztfordítást; a fejlesztői útmutató leírja a tároló felépítését, a célokat és a kódstílust.
Plugin írása
A pluginok DLL-ek, amelyeket a Sally igény szerint tölt be. Az interfész a src/plugins/shared/spl_*.h helyen található: egy belépési pont regisztrálja a plugin szolgáltatásait, például a tömörítőt (spl_arc.h), a panelek fájlrendszerét (spl_fs.h), a megjelenítőt, a menüparancsokat (spl_menu.h) vagy a bélyegképeket (spl_thum.h), a Sally pedig általános, grafikus és fájlszolgáltatásokon keresztül hív vissza (spl_gen.h, spl_gui.h, spl_file.h).
- Induljon ki egy mintából: a
src/plugins/demopluga legtöbb interfészt bemutatja, ademomenuegy menübővítményt, ademoviewpedig egy megjelenítőt szemléltet. - Tanulmányozzon egy valódi plugint: minden mellékelt plugin a
src/pluginshelyen található, a kisméretűchecksumplugintól aftpészippluginokig. - Plugin SDK-verzió: a Sally 1.0.33 óta csak az aktuális plugin SDK-hoz (109) fordított pluginok töltődnek be. Az Altap Salamander 4.0-hoz vagy régebbi Sally verziókhoz írt pluginokat újra kell fordítani az aktuális fejlécfájlokkal.
A Sally vezérlése szkripttel
Az Automation plugin Windows Script Host szkripteket futtat, amelyek hozzáférnek a panelekhez, a kijelöléshez, a folyamatjelző ablakokhoz és az egyszerű űrlapokhoz. Kézikönyve dokumentálja az objektummodellt, és mintaszkripteket is tartalmaz.
Közreműködés
- Kód: nyisson beolvasztási kérelmet a GitHub tárolóban. A kis, célzott, a problémát világosan leíró változtatások ellenőrizhetők a legkönnyebben.
- Fordítások: minden nyelv a Sally programba épített közönséges erőforrásfájl: a
src/lang/<language>/lang.rca Sally programhoz, asrc/plugins/<plugin>/lang/<language>/lang.rcaz egyes pluginokhoz. Módosítsa a szöveget, megtartva minden azonosítót, stílust és vezérlőt az angol fájléval azonos sorrendben, majd nyisson beolvasztási kérelmet, vagy jelentse a hibás fordítást hibajegyként. A fejlesztői útmutató elmagyarázza az új nyelv hozzáadását. - Finanszírozás: a PayPal vagy Buy Me a Coffee útján küldött adományok a fejlesztésre fordított időt fedezik.
- Hibajelentések: írja le a problémát és a reprodukálási lépéseket az Issues oldalon. Adja meg a Sally és a Windows verzióját.
- A kézikönyv: a hibás vagy hiányzó oldalt az Issues oldalon jelentse. A forrása manual/source.zip néven érhető el.