Skip to content
2.28.0 feature update

* Deprecation notices:
  * The function icons_inclusion is deprecated, content_inclusion_icons should be used instead.
    cf. "Icons system" below.
  * The functions launchers_write and launcher_write are deprecated, launchers_generation should be used instead.
    cf. "Launchers system" below.
  * The function launcher_desktop_exec is deprecated, desktop_field_exec should be used instead.
    cf. "Launchers system" below.
  * Support for the following deprecated archive types is dropped:
    - mojosetup_unzip
    - zip_unclean
  * Support for the following deprecated functions is dropped:
    - archive_find_path
    - get_context_specific_value
    - launcher_native_libraries_paths
    - launcher_write_script_headers
    - package_get_path
    - packages_get_version
  * Support for the following deprecated variables is dropped:
    - APP_xxx_ICON_ID
    - APP_xxx_LIBS
    - OPTION_xxx
  * Declaring dependencies on the following native libraries is no longer supported:
    - libavcodec.so.58
    - libavformat.so.58
    - libavutil.so.56

* Codebase improvements:
  * A package-specific contextual value can now be set for GAME_ID.
  * The environment language detection now honours LC_ALL and LC_MESSAGES, in addition to LANG.

* Icons system:
  * A new function is provided to include game icons: content_inclusion_icons
    USAGE: content_inclusion_icons [$package [$application…]]

* Launchers system:
  * The game execution command-line can now be overridden from game scripts by redefining the function game_exec_line.
  * New functions are provided to easily fetch or override the value of fields in XDG desktop files:
    - desktop_field_exec
    - desktop_field_icon
  * A new function is provided to generate launchers: launchers_generation
    USAGE: launchers_generation [$package [$application…]]

* Dependencies system:
  * Support for the following native library is updated to rely on a downloadable archive:
    - libgconf-2.so.4

* Changes specific to game engines:
  * Unity3D: A more targeted list of libraries is included for Windows builds.
  * ScummVM: Hyphen-minus is now allowed in ScummVM ids, like in the following valid example: "ags:gobliiins5-1".
  * WINE: A virtual desktop can be set from game scripts, using the following variable: WINE_VIRTUAL_DESKTOP.
    WINE_VIRTUAL_DESKTOP can take the following values:
    - none (default if no value is set)
    - auto (use the current screen resolution when the game is launched for the first time)
    - some specific resolution (example: 1280x1024)

* Changes specific to Debian:
  * dpkg-deb ≥ 1.19.0 is required.
  * fakeroot is no longer required.

* Changes specific to Gentoo:
  * Several use flags are added to scummvm.