Updating to the Latest Build of the Kit

Updating to the Latest Build of the Kit

That dreaded day has come when your local copy of the kit is no longer the latest version! Well fear not, updating it is very simple.

First though, check to see if updating is actually needed. In your local version, go to your General settings tab and look at the Build number (circled in the image below). Unless you’ve changed it yourself, it should still be at whatever number we entered. This is essentially our version number, but instead of using the Version field (which is tied more to your version in the App Store), we use the Build field. So if that number is less than what you see in the download section for the kit, then it’s time to update (Lifetime Access buyers can check the latest version here, and Subscribers can check here).

How to check Build number in xcode


 

What To Update…

First backup the version you’ve been working on. Zip it all (including the Xcode project and folder containing all the code and resources), label it something smart, and rest easy knowing you can always revert back to that version if needed.

Next download the latest version of the kit. You can update everything without Xcode being open, and just overwrite the Swift files in the Finder (that’s how we do it, that’s how we recommend doing it). You could also open both Xcode Projects and either delete files, then drag from one project to the other, or copy and paste code, but all that takes WAY more time than simply overwriting files in the Finder.

Most often, the only files you will ever want to overwrite are the Swift files (some are seen selected below). And if you aren’t sure which to select, you could just select them all, or compare the Date Modified dates between the two projects (assuming you haven’t edited any of the code yourself).

Updating from one Xcode project to another

Select the Swift files. Copy them. Head over to the older project, and paste them via the Finder window. When prompted, Replace the older ones, and wah-lah, you’re done!

As of version 1.6, you need to import a new file Home_Store.swift . You can import it by simply dragging it into your current project.


What NOT to Update…

Files you DO NOT want to overwrite are the non-Swift files….

  • LevelData.plist
  • Any Scene (.sks) files. 
  • The Game.xcassets catalog
  • Your .atlas folders 

 

Don’t forget…

There’s two versions of the kit, one for iOS and one for tvOS, so be sure to copy and replace files from the correct corresponding versions of the kit.