Access Keys:
Skip to content (Access Key - 0)

Kobold2D™ Documentation

The All-In-One, Ready-To-Go development solution for cocos2d-iphone developers. Open source, ARC enabled, for iOS & Mac OS.

Switch to: Japanese Documentation

Level Up!

The Learn Cocos2D Book

Line-Drawing Game Starterkit

Excellent template code for creating your own Line-Drawing game, similar to popular titles such as Flight Control, Harbor Master, and Pirate Bay.

The iPhone RPG Engine

Rapidly create your own RPG or action-adventure game with this complete starter kit. Includes an ebook, game source code and a royalty-free art package.

This guide explains how you can upgrade (or move) an existing Kobold2D project to a newer version of Kobold2D.

Run the Kobold2D Project Upgrader.app

After installing a new Kobold2D version, open that version's root folder and run the Kobold2D Project Upgrader.app.

Select the projects you want to upgrade

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.

Click "Upgrade Selected Projects"

Close Xcode!
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.

Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
Adaptavist Theme Builder Powered by Atlassian Confluence