User Tools

Site Tools


proton_vsrename

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
Next revision Both sides next revision
proton_vsrename [2011/04/27 13:49]
seth created
proton_vsrename [2012/07/07 02:00]
seth
Line 1: Line 1:
 === How to duplicate an example project with vsrename === === 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, ApeSmash, based on RTSimpleApp."​ (or RT3DApp, etc)+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 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...+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.  ​
  
-=== Smart renaming with vsrename ===+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 [[http://​www.codeproject.com/​KB/​cpp/​vsrename.aspx|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 notes === 
 +If you're doing Android, you'll probably want to look over the following files by hand to tweak things: 
 + 
 +  * android/​app_setup_info.bat 
 +  * android/​AndroidManifest.xml 
 +  * android/​build.xml 
 +  * android/​res/​values/​strings.xml (to change the display name of the app, unless it was hardcoded in the manifest) 
 +  * android/​res/​drawable/​icon.png (change the app icon) 
 + 
 +=== Summary === 
 +And there you go, more or less ready. ​ 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.
  
-Crap, need to go now.  Will work on this later.. -Seth 
proton_vsrename.txt · Last modified: 2018/07/28 12:21 by seth