Difference between revisions of "HOWTO-Engine Release"

From ScummVM :: Wiki
Jump to navigation Jump to search
(Update)
(Add TODO items for the engine data file)
Line 10: Line 10:
# If necessary, add special notes to section 3 of the [https://github.com/scummvm/scummvm/blob/master/README README file]
# If necessary, add special notes to section 3 of the [https://github.com/scummvm/scummvm/blob/master/README README file]
# Add the engine author(s) to the [https://github.com/scummvm/scummvm/blob/master/devtools/credits.pl credits.pl file] and run ''make credits'' to update the AUTHORS and credits.h files.
# Add the engine author(s) to the [https://github.com/scummvm/scummvm/blob/master/devtools/credits.pl credits.pl file] and run ''make credits'' to update the AUTHORS and credits.h files.
# If the engine uses a data file, make sure it is added to the list of files to distribute:
## Add it to ''DIST_FILES_ENGINEDATA'' in ''Makefile.common''
## Add it to ''dists/scummvm.rc''
## Add it to ''dists/irix/scummvm.idb''
## Add it to ''devtools/create_project/xcode.cpp'' (in the ''XcodeProvider::getResourceFiles()'' function).
## Add it to ''scumm_package_master'' in the buildbot ''master.cfg'' file.
# Make sure [[Datafiles]] is up-to-date
# Make sure [[Datafiles]] is up-to-date
# Make sure the engine and game are added to the [https://bugs.scummvm.org bug tracker] (engine in Components, game in Custom Fields->game)
# Make sure the engine and game are added to the [https://bugs.scummvm.org bug tracker] (engine in Components, game in Custom Fields->game)

Revision as of 21:32, 2 September 2020

Once an engine has been accepted into the master branch, finished, and is ready to be playtested, do this stuff to get it ready:

  1. Change any ADGF_UNSTABLE flags in the engine’s detection table to ADGF_TESTING
  2. Change the [build-by-default] flag in the engine’s configure.engine file to yes
  3. Update the game’s information pages in the wiki:
    1. Change the game’s category from Category:Unsupported Games to Category:Supported Games
    2. Set the Support status in the infobox to the next ScummVM release version
    3. Fill out any other missing information in the infobox
  4. Add the new game(s) to the NEWS file
  5. If necessary, add special notes to section 3 of the README file
  6. Add the engine author(s) to the credits.pl file and run make credits to update the AUTHORS and credits.h files.
  7. If the engine uses a data file, make sure it is added to the list of files to distribute:
    1. Add it to DIST_FILES_ENGINEDATA in Makefile.common
    2. Add it to dists/scummvm.rc
    3. Add it to dists/irix/scummvm.idb
    4. Add it to devtools/create_project/xcode.cpp (in the XcodeProvider::getResourceFiles() function).
    5. Add it to scumm_package_master in the buildbot master.cfg file.
  8. Make sure Datafiles is up-to-date
  9. Make sure the engine and game are added to the bug tracker (engine in Components, game in Custom Fields->game)
  10. Publish a news entry announcing game testing at scummvm/scummvm-web:data/news/ (e.g. Full Pipe announcement)
    1. Copy the news to the forums, General Discussion subforum, mark the post as an announcement
    2. Copy the news to our Facebook page
  11. Update the compatibility data at scummvm/scummvm-web:data/compatibility/compat-DEV.xml with compatibility information for the new game(s)
  12. If necessary, update the demos list at scummvm/scummvm-web:data/game_demos.xml with new game demos