|This guide explains how you can upgrade (or move) an existing Kobold2D project to a newer version of Kobold2D.|
After installing a new Kobold2D version, open that version's root folder and run the Kobold2D Project Upgrader.app.
The Kobold2D Project Upgrader.app will scan the other Kobold2D folders for upgradeable projects and show them in a list.
By default all upgradeable projects are already highlighted. You can also select only individual projects in the same way you select files in Finder: Shift+Mouseclick to select a range of projects, or Command+Mouseclick to select or deselect individual projects.
The Upgrade from setting allows you to upgrade Kobold2D projects from other, possibly earlier versions of Kobold2D (if available). By default the projects from the second to last installed Kobold2D version are shown. Normally you don't need to change this setting.
|If a project is not in the list...|
The Kobold2D Project Upgrader.app tries to ensure that you don't accidentally overwrite already existing projects. For that reason not all projects may be listed. In particular projects for which a folder with the same name already exists in the destination version's folder will not be shown to prevent accidentally overwriting that project.
In a few cases this may not be an already upgraded project. Assuming you have already created a project with the same name (eg test) in the preview 2 version and then want to update the older, different but also named test project from preview 1, you will first have to rename or delete either one of these two test projects before you can upgrade the old test project.
It is recommended to close Xcode before clicking the Upgrade Selected Projects button. At the very least you should close the workspaces and projects that you are going to upgrade.
The upgrader tool will copy the project folder and its contents over to the destination version, in this case Kobold2D-1.0-preview2. It will also upgrade the project's workspaces.
The informational message is a reminder that changes to the API may cause build errors in the upgraded projects, which are not related to the upgrade process itself. The Kobold2D Project Upgrade.app can not modify your source code to make it compatible with the latest APIs. That is always a manual process, but in most cases the necessary changes are minimal. Please refer to the Kobold2D Release Notes for information on API changes.
You can now open the workspaces in the destination Kobold2D version and continue working.
|Be aware of which workspace version Xcode opens!|
Keep in mind that Xcode automatically re-opens the most recently used workspaces and projects. If you do not manually open the corresponding workspace(s) from the latest Kobold2D version you will continue to work with the second to last version of Kobold2D, which is probably not what you want.