User Tools

Site Tools


This is an old revision of the document!

How to duplicate an example project with vsrename

At some point you're probably going to say, “Hey, I understand what's going on, and I want to build my new game, Laser Cats, based on RTSimpleApp.” (or RT3DApp, etc)

Proton uses hundreds of files and it's a complete chore to attempt to create Windows, iOS, webOS, BBX, OSX, and Android projects/scripts from scratch.

So let me introduce you to my secret little friend I've used for the last ten years or so…

Smart renaming with vsrename (Windows only)

First, grab vsrename (Visual Studio Project Renamer) - what it does is intelligently search and replace in file names and inside text file (it can figure out what is a text file or not) in an entire directory tree. Don't let the Visual Studio in the name fool you, it doesn't really care what files it works on.

Grab vsrename.exe and throw it somewhere in your path to get ready.

For this example, we'll assume you want to clone RTSimpleApp into your new app, LaserCats

  • Step 0: (optional?) Remove any temp build files from the RTSimpleApp dir, or start from a fresh checkout
  • Step 1: Cut and paste the RTSimpleApp dir to the same directory and name it lasercats.
  • Step 2: Open a dos prompt in the new lasercats directory
  • Step 3: From the prompt, run “vsrename RTSimpleApp lasercats ./“ without the quotes. It should run through and do all the replacing and renaming. Isn't that bad-ass?! All source files, make files, bat files, etc, are scanned.
  • Step 4: Also run “vsrename com.rtsoft com.mycompany ./“ (Replace mycompany with your .com name.

Now, at this point you can open windows/lasercats.sln and build the game for windows and it should work. (Don't forget to rebuild your resources with media/build_media.bat )

Android considerations

But - one fault of vsrename is it doesn't change directory names, and android does have a directory named the app name.. so you'll have to rename android/src/com/rtsoft/barebones to android/src/com/mycompany/lasercats.

NOTE: This doesn't apply to the new v2.0 android build system that RTAdTest uses, it doesn't need any dirs renamed.

There are probably other things you'll end up having to hand tweak as you build for each platform, feel free to add them here.


And there go, more or less ready to go. Keep in mind you can't move this project directory anywhere, you need to keep it in the same directory as proton's shared directory, as most of the scripts and tools use relative paths to minimize setup.

It IS possible to do directory checkout of your own svn located inside of your svn proton checkout btw - it's what I do for client projects, works like charm.

proton_vsrename.1330314874.txt.gz · Last modified: 2012/02/27 03:54 by seth