1,510
edits
Difference between revisions of "HOWTO-Engine Release"
Jump to navigation
Jump to search
Clarified buildbot config
(mention documentation changes) |
(Clarified buildbot config) |
||
| (11 intermediate revisions by 3 users not shown) | |||
| Line 3: | Line 3: | ||
# Change any <code>ADGF_UNSTABLE</code> flags in the engine’s detection table to <code>ADGF_TESTING</code> | # Change any <code>ADGF_UNSTABLE</code> flags in the engine’s detection table to <code>ADGF_TESTING</code> | ||
# Change the <tt>[build-by-default]</tt> flag in the engine’s <tt>configure.engine</tt> file to <tt>yes</tt> | # Change the <tt>[build-by-default]</tt> flag in the engine’s <tt>configure.engine</tt> file to <tt>yes</tt> | ||
# Update the game’s information pages in the wiki: | # Update the engine’s and game’s information pages in the wiki: | ||
## Change the engine’s category from [[:Category:Engines Not Added to ScummVM]] to [[:Category:Engines Added to ScummVM]] | |||
## Change the game’s category from [[:Category:Unsupported Games]] to [[:Category:Supported Games]] | ## Change the game’s category from [[:Category:Unsupported Games]] to [[:Category:Supported Games]] | ||
## Set the Support status in the infobox to the next ScummVM release version in form 'Since ScummVM X.X.0' | ## Set the Support status in the infobox to the next ScummVM release version in form 'Since ScummVM X.X.0' | ||
## Fill out any other missing information in the infobox | ## Fill out any other missing information in the infobox | ||
# Add the new game(s) to the [https://github.com/scummvm/scummvm/blob/master/NEWS.md NEWS file] | # Add the new game(s) to the [https://github.com/scummvm/scummvm/blob/master/NEWS.md NEWS file] | ||
# When the engine is using GUIO, add their description to | # When the engine is using GUIO, add their description to the [https://docs.scummvm.org/en/v2.2-docs/settings/engine.html documentation] ([[Developer_Central#Contribution_guide_for_technical_writers|here]] is how to edit the documentation) | ||
# | # Add the engine author(s) to the ''engines/<your-engine>/credits.pl'' file (see [https://github.com/scummvm/scummvm/blob/master/engines/scumm/credits.pl SCUMM engine example]) and run ''make credits'' to update the ''AUTHORS'' and ''credits.h'' files. You should also have scummvm-web repository checked out next to your scummvm directory, and then commit to both repositories. For the web repo the typical commit log message is "WEB: Sync credits". | ||
# Add the engine author(s) to the [https://github.com/scummvm/scummvm/blob/master/ | |||
# If the engine uses a data file, make sure it is added to the list of files to distribute: | # 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 ''DIST_FILES_ENGINEDATA'' in ''Makefile.common'' | ||
## Add it to ''dists/scummvm.rc'' | ## Add it to ''dists/scummvm.rc'' | ||
## Add it to ''dists/irix/scummvm.idb'' | ## Add it to ''dists/irix/scummvm.idb'' | ||
## Add it to ''dists/win32/migration.txt'' | |||
## Add it to ''backends/platform/maemo/debian/rules'' | |||
## Add it to ''devtools/create_project/xcode.cpp'' (in the ''XcodeProvider::getResourceFiles()'' function). | ## Add it to ''devtools/create_project/xcode.cpp'' (in the ''XcodeProvider::getResourceFiles()'' function). | ||
## | ## On the Buildbot, in the [https://github.com/scummvm/dockerized-bb/blob/master/buildbot-config/builds.py ''buildbot-config/builds.py''] file: | ||
### If there is no <code>DATA_FILES</code> variable defined under the <code>ScummVMStableBuild</code> class, copy the <code>DATA_FILES</code> variable from the <code>ScummVMBuild</code> class to <code>ScummVMStableBuild</code>, | |||
### Add the engine data file to the <code>DATA_FILES</code> list in the <code>ScummVMBuild</code> class. | |||
### Ping [[User:rootfather|rootfather]] for propagating the change to the buildbot. | |||
# Make sure list of datafiles on the game pages are up to date (for example see [[Beneath_a_Steel_Sky#Required_data_files]] as a template) | # Make sure list of datafiles on the game pages are up to date (for example see [[Beneath_a_Steel_Sky#Required_data_files]] as a template) | ||
# 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) | ||
| Line 22: | Line 27: | ||
## Copy the news to the forums, General Discussion subforum, mark the post as an announcement | ## Copy the news to the forums, General Discussion subforum, mark the post as an announcement | ||
## Ask [[User:Sev|sev]] to publish on Facebook and provide the game screenshots | ## Ask [[User:Sev|sev]] to publish on Facebook and provide the game screenshots | ||
## | ## Ask [[User:Sev|sev]] to publish the link on Twitter | ||
## Ask [[User:Sev|sev]] to copy the announcement text to the #news channel on Discord | |||
# Update the Website | # Update the Website | ||
## Update the compatibility data at [https://docs.google.com/spreadsheets/d/1QzwFleEKXOsE59cYMOcQB7C2f0Np48uAQOCG8kicX_s/edit#gid=854570757 the ScummVM Data spreadsheet] with compatibility information for the new game(s) | ## Update the compatibility data at [https://docs.google.com/spreadsheets/d/1QzwFleEKXOsE59cYMOcQB7C2f0Np48uAQOCG8kicX_s/edit#gid=854570757 the ScummVM Data spreadsheet] with compatibility information for the new game(s) (ping [[User:Sev|sev]] or [[User:Rootfather|rootfather]] for the access) | ||
### If necessary, add the company to 'companies' tab | ### If necessary, add the company to 'companies' tab | ||
### Add game to the 'games' tab, don't forget to provide the game hook to the Datafiles | ### Add game to the 'games' tab, don't forget to provide the game hook to the Datafiles | ||