Jump to content


Global Message: Welcome to the Porting Team v3.3

syao

Member Since 21 Apr 2010
Offline Last Active Today, 06:03 PM
*****

Topics I've Started

Update a ScummVM Wrapper to version 3.0

11 March 2012 - 12:48 AM

Update a ScummVM Wrapper

You'll need:
  • An Intel Mac (either 32 or 64 bit) running Mac OS X 10.5, Mac OS X 10.6 or OS X 10.7.
  • ScummVMwrapper 3.0 (tutorial updated for version 3.0.0-b2)
Updating a wrapper is currently not supported on PowerPC machines. Please refer to the manual wrapper creation guide in order to update a wrapper on a PowerPC Mac.

  • Make sure you have the most recent version of the ScummVMwrapperConfig app. You can use the “Check for Updates” button to do so.
    Posted Image

  • Ctrl-click the wrapper you want to update and choose “Show Package Contents”.
    Posted Image

  • Copy ScummVMwrapperConfig.app to the wrapper's main folder, next to the Contents folder, then run it.
    Posted Image
    Posted Image

  • Click the “Upgrade Wrapper” button and wait for the confirmation dialog.
    [Note: on some computers this operation may appear to freeze the configuration app for a few seconds. This is normal, please ignore it.]
    Posted Image
    Posted Image

  • Quit the configuration app and reopen it. Then check the settings in order to make sure everything is correct. Your wrapper is ready.
    [Note: You need to close and reopen the configuration app because in versions 3.0.0-b1 through 3.0.0-b2 it is unable to reload data on the fly. In future versions this may be no longer required.]
    Posted Image
    Posted Image

ScummVM Wrapper 3.0 - Manual Wrapper Creation

11 March 2012 - 12:31 AM

ScummVM Wrapper 3.0 - Manual Wrapper Creation

You'll need:
  • A Mac running Mac OS X 10.5, Mac OS X 10.6 or OS X 10.7.
  • ScummVMwrapper 3.0 (tutorial updated for version 3.0.0-b2)

  • Create a new folder and rename it to the name of the game you're porting, followed by “.app”. You'll have to confirm adding “.app” to the folder name.
    Posted Image
    Posted Image
    Posted Image Posted Image

  • Ctrl-click the newly created folder and choose “Show Package Contents”. Do the same with ScummVMwrapperConfig.app, so that you'll have both folders open side by side.
    Posted Image

    Posted Image

  • Navigate to ScummVMwrapperConfig.app/Contents/Resources. Copy the WrapperData.zip file you find there, to the folder you previously created and opened.
    Posted Image

  • Extract the file you just copied (note: it's recommended to use the builtin Archive Utility to do so).
    You can now delete the copy of WrapperData.zip.
    Posted Image

    Posted Image

  • Copy ScummVMwrapperConfig.app to the wrapper's main folder, next to the Contents folder.
    Posted Image

  • Copy your game files into the Contents/Resources/game folder.
    Posted Image

  • Replace the default icon (Contents/Resources/game.icns) with your own.
    [Note: Due to a bug in versions 3.0.0-b1 through 3.0.0-b2, the icon won't be displayed correctly in the wrapper. Next versions will have this bug solved.]
    Posted Image

  • Open the Contents/Info.plist file in your favorite text editor (or plist editor).
    Posted Image

  • Edit the CFBundleName field to the identifier for the game you're going to port. You can find a list of identifiers in the Contents/Resources/GameIDs.txt file.
    Edit then the CFBundleIdentifier field so that it includes the same game identifier.
    Posted Image
    Posted Image

  • Add a new String entry for CFBundleDisplayName and fill it with the full game name. You can use spaces and symbols here.
    Posted Image

  • Add entries for the optional settings. You can use the following picture as reference for the default values.
    [Note: The picture doesn't include a value for the “Extra command line arguments” field. This is due to a bug in versions 3.0.0-b1 through 3.0.0-b2. It'll be fully working in the next version]
    Posted Image

  • Save the plist. Your wrapper is now ready, and you can start playing.
    Posted Image
    Posted Image

ScummVM Wrapper 3.0 - Automated Wrapper Creation

10 March 2012 - 11:46 PM

ScummVM Wrapper 3.0 - Automated Wrapper Creation

You'll need:
  • An Intel Mac (either 32 or 64 bit) running Mac OS X 10.5, Mac OS X 10.6 or OS X 10.7.
  • ScummVMwrapper 3.0 (tutorial updated for version 3.0.0-b2)

  • Open the ScummVMwrapperConfig app.
    You'll be prompted whether you want to create a blank wrapper. Choose “Create”.
    Posted Image
    Posted Image

  • Choose a name and a destination folder for the wrapper, then click “Create”. Then choose “Reveal in Finder”.
    Posted Image
    Posted Image

  • Double-click the newly created wrapper. You'll see the ScummVMwrapper Configuration window.
    Posted Image

  • Choose an engine to use (either ScummVM or ResidualVM)
    [Note: in versions 3.0.0-b1 through 3.0.0-b2, ResidualVM is labeled as Residual through the application. It'll be changed to the new name, ResidualVM.]
    Posted Image

  • Fill the other required fields in the “Engine and Game” tab: Game Name, Game ID.
    [Note: in versions 3.0.0-b1 through 3.0.0-b2 you'll have to press Return after editing the last text field before you save, or the change won't be detected by the configuration app.]
    Posted Image

  • Change the wrapper icon by dragging an .icns file to the “Game Icon” well.
    [Note: Due to a bug in versions 3.0.0-b1 through 3.0.0-b2, the icon won't be saved correctly. Next versions will have this bug solved.]
    Posted Image

  • Edit the optional settings in the “Settings” tab as you see fit.
    Posted Image

  • Choose “File”->“Save” (or press ⌘S) to save your changes to the wrapper. Then click the “Reveal Game Folder in Finder” button.
    Posted Image
    Posted Image

  • Copy your game files into the game folder.
    Posted Image

  • There is no step 10. Your wrapper is ready, and you can start playing.
    If you need to access the Configuration app in future, you can do so by holding the Fn key while double-clicking the wrapper.
    Posted Image
    Posted Image