Difference between revisions of "HOWTO-Engine Release"
Jump to navigation
Jump to search
(Add TODO items for the engine data file) |
(Update credits.pl instructions) |
||
(15 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 | ## 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 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 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 [https://github.com/scummvm/scummvm/blob/master/ | # 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". | ||
# 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'' | ||
Line 16: | Line 17: | ||
## 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). | ||
## Add it to ''scumm_package_master'' in the buildbot ''master.cfg'' file. | ## Add it to ''scumm_package_master'' in the buildbot ''master.cfg'' file. | ||
# Make sure [[ | # 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) | ||
# Publish a news entry announcing game testing at [https://github.com/scummvm/scummvm-web/tree/master/data/news scummvm/scummvm-web:data/news/] (e.g. [https://github.com/scummvm/scummvm-web/blob/master/data/news/20161201. | # Publish a news entry announcing game testing at [https://github.com/scummvm/scummvm-web/tree/master/data/en/news scummvm/scummvm-web:data/en/news/] (e.g. [https://github.com/scummvm/scummvm-web/blob/master/data/en/news/20161201.markdown Full Pipe announcement]). Also, provide to [[User:Sev|sev]] several screenshots for the Facebook post | ||
## 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 | ||
## Copy the news | ## Ask [[User:Sev|sev]] to publish on Facebook and provide the game screenshots | ||
# Update the compatibility data at [https:// | ## Ask [[User:Sev|sev]] to publish the link on Twitter | ||
# If necessary, update the demos list at [https:// | ## Copy the announcement text to #news channel on Discord | ||
# 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) (ping [[User:Sev|sev]] or [[User:Mataniko|Mataniko]] for the access) | |||
### 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 'compatibility' tab | |||
## If necessary, update the demos list at [https://docs.google.com/spreadsheets/d/1QzwFleEKXOsE59cYMOcQB7C2f0Np48uAQOCG8kicX_s/edit#gid=713475305 the ScummVM Data spreadsheet] with new game demos | |||
## Run <tt>composer update-data</tt> for updating the website | |||
# Upload demos if any | |||
## After uploading demos, put the links to the data spreadsheet | |||
## Add the game category icon as described [[Screenshots#How_to_make_game_icon|here]] |
Revision as of 18:36, 18 September 2021
Once an engine has been accepted into the master branch, finished, and is ready to be playtested, do this stuff to get it ready:
- Change any
ADGF_UNSTABLE
flags in the engine’s detection table toADGF_TESTING
- Change the [build-by-default] flag in the engine’s configure.engine file to yes
- 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
- 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
- Add the new game(s) to the NEWS file
- When the engine is using GUIO, add their description to the documentation (here is how to edit the documentation)
- Add the engine author(s) to the engines/<your-engine>/credits.pl file (see 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".
- 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 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 bug tracker (engine in Components, game in Custom Fields->game)
- Publish a news entry announcing game testing at scummvm/scummvm-web:data/en/news/ (e.g. Full Pipe announcement). Also, provide to sev several screenshots for the Facebook post
- Update the Website
- Update the compatibility data at the ScummVM Data spreadsheet with compatibility information for the new game(s) (ping sev or Mataniko for the access)
- 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 'compatibility' tab
- If necessary, update the demos list at the ScummVM Data spreadsheet with new game demos
- Run composer update-data for updating the website
- Update the compatibility data at the ScummVM Data spreadsheet with compatibility information for the new game(s) (ping sev or Mataniko for the access)
- Upload demos if any
- After uploading demos, put the links to the data spreadsheet
- Add the game category icon as described here