Desarrolladores
Compile, amplíe y contribuya
Sally es software libre bajo la GNU GPL versión 2 o posterior, desarrollado públicamente en GitHub. Aquí se explica cómo compilarlo, ampliarlo y aportar cambios.
Compilar desde el código fuente
Visual Studio 2022, el SDK de Windows 11 y CMake. Un solo comando compila Sally y todos los plugins, con todos los idiomas integrados.
CompilarEscribir un plugin
Añada formatos de archivo comprimido, sistemas de archivos, visores o comandos mediante la interfaz de plugins, partiendo de los plugins de demostración.
PluginsCrear scripts para Sally
Automatice tareas repetitivas con JScript, VBScript u otros lenguajes de Windows Script Host.
ScriptsContribuir
Corrija un fallo, mejore una traducción o comunique un problema.
ContribuirCompilar desde el código fuente
Necesita Visual Studio 2022 con la carga de trabajo Desarrollo para el escritorio con C++ y el SDK de Windows 11 10.0.26100 o posterior.
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
El programa ejecutable se genera en build/out/sally/<Config>_<Arch>/. Ejecute populate de nuevo después de cada compilación para que los plugins junto a sally.exe coincidan con él. Los ajustes predefinidos de CMake cubren x64, ARM64 y la compilación cruzada con clang-cl; la guía del desarrollador describe la estructura del repositorio, los destinos y el estilo de código.
Escribir un plugin
Los plugins son DLL que Sally carga cuando se necesitan. La interfaz está en src/plugins/shared/spl_*.h: un punto de entrada registra lo que ofrece el plugin, como un compresor (spl_arc.h), un sistema de archivos para los paneles (spl_fs.h), un visor, comandos de menú (spl_menu.h) o miniaturas (spl_thum.h), y Sally realiza llamadas de retorno a través de servicios generales, gráficos y de archivos (spl_gen.h, spl_gui.h, spl_file.h).
- Parta de una demostración:
src/plugins/demoplugutiliza la mayoría de las interfaces,demomenumuestra una ampliación del menú ydemoview, un visor. - Estudie un plugin real: todos los plugins incluidos están en
src/plugins, desde el pequeñochecksumhastaftpyzip. - Versión del SDK de plugins: desde Sally 1.0.33 solo se cargan plugins compilados para el SDK actual (109). Los plugins escritos para Altap Salamander 4.0 o versiones anteriores de Sally deben recompilarse con las cabeceras actuales.
Crear scripts para Sally
El plugin Automatización ejecuta scripts de Windows Script Host con acceso a los paneles, la selección, ventanas de progreso y formularios sencillos. Su manual documenta el modelo de objetos e incluye scripts de ejemplo.
Contribuir
- Código: abra una solicitud de incorporación de cambios en GitHub. Los cambios pequeños y concretos con una descripción clara del problema son los más fáciles de revisar.
- Traducciones: cada idioma es un archivo de recursos normal integrado en Sally:
src/lang/<language>/lang.rcpara Sally ysrc/plugins/<plugin>/lang/<language>/lang.rcpara cada plugin. Edite el texto, manteniendo todos los identificadores, estilos y controles en el mismo orden que en el archivo inglés, y abra una solicitud de incorporación de cambios o comunique una traducción incorrecta como incidencia. La guía del desarrollador explica cómo añadir un idioma. - Financiación: las donaciones mediante PayPal o Buy Me a Coffee financian tiempo de desarrollo.
- Informes de fallos: describa el problema y los pasos para reproducirlo en Incidencias. Incluya las versiones de Sally y Windows.
- El manual: comunique páginas incorrectas o ausentes en Incidencias. Su código fuente se publica como manual/source.zip.