Entwickler

Bauen, erweitern und mitwirken

Sally ist freie Software unter der GNU GPL Version 2 oder neuer und wird öffentlich auf GitHub entwickelt. Hier erfahren Sie, wie Sie das Programm bauen, erweitern und Änderungen beitragen.

Aus dem Quellcode bauen

Visual Studio 2022, das Windows 11 SDK und CMake. Ein Befehl baut Sally und alle Plugins mit sämtlichen integrierten Sprachen.

Bauen

Ein Plugin schreiben

Ergänzen Sie über die Plugin-Schnittstelle Archivformate, Dateisysteme, Betrachter oder Befehle, ausgehend von den Demo-Plugins.

Plugins

Skripte für Sally

Automatisieren Sie wiederkehrende Aufgaben mit JScript, VBScript oder anderen Sprachen des Windows Script Host.

Skripte

Mitwirken

Beheben Sie einen Fehler, verbessern Sie eine Übersetzung oder melden Sie ein Problem.

Mitwirken

Aus dem Quellcode bauen

Sie benötigen Visual Studio 2022 mit der Workload Desktopentwicklung mit C++ und das Windows 11 SDK 10.0.26100 oder neuer.

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

Das lauffähige Programm liegt in build/out/sally/<Config>_<Arch>/. Führen Sie nach jedem Build erneut populate aus, damit die Plugins neben sally.exe dazu passen. CMake-Presets decken x64, ARM64 und clang-cl-Kreuzkompilierung ab; der Entwicklerleitfaden beschreibt Repository-Aufbau, Ziele und Codestil.

Ein Plugin schreiben

Plugins sind DLLs, die Sally bei Bedarf lädt. Die Schnittstelle liegt in src/plugins/shared/spl_*.h: Ein Einstiegspunkt registriert die angebotenen Funktionen, etwa einen Packer (spl_arc.h), ein Dateisystem für die Dateifenster (spl_fs.h), einen Betrachter, Menübefehle (spl_menu.h) oder Miniaturansichten (spl_thum.h). Sally ruft über allgemeine Dienste, GUI- und Dateidienste zurück (spl_gen.h, spl_gui.h, spl_file.h).

Mit einer Demo beginnen: src/plugins/demoplug nutzt die meisten Schnittstellen, demomenu zeigt eine Menüerweiterung und demoview einen Betrachter.
Ein echtes Plugin untersuchen: Alle mitgelieferten Plugins befinden sich in src/plugins, vom kleinen checksum bis zu ftp und zip.
Plugin-SDK-Version: Seit Sally 1.0.33 werden nur Plugins für das aktuelle Plugin-SDK (109) geladen. Plugins für Altap Salamander 4.0 oder ältere Sally-Versionen müssen mit den aktuellen Headern neu gebaut werden.

Skripte für Sally

Das Automation-Plugin führt Windows-Script-Host-Skripte mit Zugriff auf Dateifenster, Markierungen, Fortschrittsfenster und einfache Formulare aus. Sein Handbuch dokumentiert das Objektmodell und enthält Beispielskripte.

Mitwirken

Code: Öffnen Sie einen Pull Request auf GitHub. Kleine, gezielte Änderungen mit klarer Problembeschreibung lassen sich am einfachsten prüfen.
Übersetzungen: Jede Sprache ist eine normale, in Sally integrierte Ressourcendatei: src/lang/<language>/lang.rc für Sally und src/plugins/<plugin>/lang/<language>/lang.rc für jedes Plugin. Bearbeiten Sie den Text und behalten Sie jede ID, jeden Stil und jedes Steuerelement in derselben Reihenfolge wie in der englischen Datei bei. Öffnen Sie einen Pull Request oder melden Sie eine falsche Übersetzung als Issue. Der Entwicklerleitfaden erklärt das Hinzufügen einer Sprache.
Finanzierung: Spenden über PayPal oder Buy Me a Coffee finanzieren Entwicklungszeit.
Fehlerberichte: Beschreiben Sie ein Problem und die Schritte zur Reproduktion in Issues. Geben Sie Ihre Sally-Version und Windows-Version an.
Das Handbuch: Melden Sie falsche oder fehlende Seiten in Issues. Die Quelldateien werden als manual/source.zip veröffentlicht.