Instructions on installing SVN build?

[OneBinary]

Hi All,

Would anybody be able to provide instructions on how I can install the SVN version (hopefully detailed idiot proof type instructions).

Or would there be an option of doing a nightly build type of thing where an exe could be provided to us boneheads, with the intention that it would be an untested build? This is probably a bit much for small project, and maybe this would not even be necessary with adequate instructions on installing from SVN.

 

[EmperorFool]

Here are the instructions I wrote up a while ago. If you have any problems, just ask.

1. Install TortoiseSVN (Google it)
2. Restart PC
3. Create a directory somewhere, e.g. C:\Games\BUGMod
4. Right click the directory, select "SVN Export..."
5. Enter URL https://civ4bug.svn.sourceforge.net/svnroot/civ4bug/BUG Mod (right-click this link and select "Copy Link Location" -- make sure you get the full URL)
6. Click OK

Now you'll have all of the BUG files in that directory. From here you can follow the normal ZIP instructions in this forum.

If you're feeling lucky, you could always do the "SVN Export..." command by right-clicking your "My Games\Beyond the Sword" directory as well. See Cammagno's post immediately below.

 

[Cammagno]

Here are the instructions I wrote up a while ago. If you have any problems, just ask.

1. Install TortoiseSVN (Google it)
2. Restart PC
3. Create a directory somewhere, e.g. C:\Games\BUGMod
4. Right click the directory, select "SVN Checkout..."
5. Enter URL https://civ4bug.svn.sourceforge.net/svnroot/civ4bug/BUG Mod (right-click this link and select "Copy Link Location" -- make sure you get the full URL)
6. Click OK

Now you'll have all of the BUG files in that directory. From here you can follow the normal ZIP instructions in this forum.

Ehm... not exactly... at the end of the list above, when you have all the files in that directory, you also have there a lot of hidden files used by SVN but not useful for BUG. So, DON'T copy the content of that folder to your My Games\Beyond the Sword folder, but right-click on your folder and, from the TortoiseSVN menu, choose "Export" and then choose your My Games\Beyond the Sword folder as destination (paying attention that the "Export unversioned files too" option is unselected); doing so, you'll put there only the BUG files.

 

[Cammagno]

Or would there be an option of doing a nightly build type of thing where an exe could be provided to us boneheads, with the intention that it would be an untested build? This is probably a bit much for small project, and maybe this would not even be necessary with adequate instructions on installing from SVN.

Here you can find a zip file with the last internal version of BUG directly from the SVN repo. It's not an official release, so bla bla bla

http://forums.civfanatics.com/uploads/74513/BUG_Mod_1.0b.zip

 

[EmperorFool]

Oops, I forgot to change my directions to use "export" instead. I have fixed them and referenced your shortcut trick. I never ever like to download anything directly into a directory that I care about*, thus the two step process I laid out.

* You never can trust those crazy internet coders!

 

[OneBinary]

This may be a dumb/obvious question, but once I start using the latest builds [files] from SVN, do I have to always to use SVN for updates, or later down the road can I use an EXE install?

The directions seem pretty easy, and I will generally want to be using the latest stuff, so this isn't a big deal, just curious. Also, it sounds like following this method I would essentially be doing a ZIP install anyway, just with the latest files, so the point may be moot.

Thanks

 

[EmperorFool]

If you'd prefer to "drink from the firehose" the steps are very similar. This means that you can always update to the latest version from SVN.

Only do this if you don't mind risking the contents of your CustomAssets folder.

The only real danger is if you try mixing mods by hand in your CustomAssets directory. If you do that, merge by-hand. If not, or if all you have in there is FBUG and maybe BlueMarble, and you always want the latest and greatest (including any new bugs!), do the following:

• Setup TortoiseSVN
• Right-click your "My Games\Beyond the Sword" folder
• Select "SVN Checkout..."
• Enter the URL above
• Click OK

From now on you can right-click the same folder and select "SVN Update" to get any new/modified/deleted files. Note that it will try to merge in any changes to the INI file. Usually this is what you want, but this may break sometimes. It's a good idea to have your BUG Mod.ini file backed up before updating.

How this works is that SVN stores hidden ".svn" folders that keep track of file versions. The information is small in size, so that shouldn't be a problem.

 

[OneBinary]

• Setup TortoiseSVN
• Right-click your "My Games\Beyond the Sword" folder
• Select "SVN Checkout..."
• Enter the URL above
• Click OK

Hrm, did I fail to complete a step? Was I supposed to blow away the CA folder? As I mentioned in another thread, I decided to re-install everything, so I installed Civ4, BtS, 3.13, Blue Marble, then I did the steps quoted.

 

[EmperorFool]

Apparently it won't overwrite directories! Hmm, strange. Okay then, follow the original directions (create a new folder somewhere, checkout into that folder, copy contents of the folder (along with hidden .svn directories) to BtS).

When you copy, tell it to "overwrite" though it will do the correct thing and just add new files. There should be no files in conflict.

 

[alerum68]

And EF, would you mind changing the link in your first post so it points to the whole SVN instead of just the Bug Mod... otherwise people won't be able to use the Flavor version.

Edit: Nevermind... I'm updating the front page with directions for SVN, and with 3 links... 1 to bug, 1 to bat, and 1 for the complete project.

 

[OneBinary]

Ehm... not exactly... at the end of the list above, when you have all the files in that directory, you also have there a lot of hidden files used by SVN but not useful for BUG. So, DON'T copy the content of that folder to your My Games\Beyond the Sword folder, but right-click on your folder and, from the TortoiseSVN menu, choose "Export" and then choose your My Games\Beyond the Sword folder as destination (paying attention that the "Export unversioned files too" option is unselected); doing so, you'll put there only the BUG files.

I still seem to be having issues with this. So I created a folder called 'bug' under My Documents/My Games. I did a SVN Update to this folder and it successfully downloaded all of the BUG files. I then right clicked on that 'bug' folder and selected the Tortoise Export option. I browsed to My Games/Beyond the Sword and exported there, but it simply created a new subfolder called 'bug' with the files, rather than merging them in. Am I doing something wrong? Any idears?

I then figured, well maybe I should try drilling into the 'bug' folder, selecting everything except the .svn directory, then right click and do Export. But this pops up a different window where it has 'URL of repository' (pre-filled with the BUG SVN path) and it has an Export Directory field. But this doesn't seem right as it should not need the URL of the repository because I am supposedly Exporting the files that I have locally.

So I guess I'm stuck at a manual copy. In looking at the BUG 1.00 ZIP file there are 3 folders and the ini file. If I just copy those 4 items from my SVN copy to My Games/Beyond the Sword, (allowing Windows to overwrite as necessary), will that install BUG SVN for me?

Thanks!

 

[alerum68]

If you want to do it directly, then just select the CustomAssets folder within the repository, and Export that into the BTS folder. I don't like that way, and prefer to export to a unrelated directory, then copy the CA, & Docs folder manual. This will remove the SVN.

 

[Cammagno]

I still seem to be having issues with this. So I created a folder called 'bug' under My Documents/My Games. I did a SVN Update to this folder and it successfully downloaded all of the BUG files. I then right clicked on that 'bug' folder and selected the Tortoise Export option. I browsed to My Games/Beyond the Sword and exported there, but it simply created a new subfolder called 'bug' with the files, rather than merging them in. Am I doing something wrong? Any idears?

Instead of right-clicking on your BUG folder, enter into it, select its content (CusomAssets folder, CustomDomAdv folder, BUG Mod Documentation folder and BUG Mod.ini file, not the hidden .svn folder) and right-click on it, then do as you have reported above.

 

[alerum68]

I posted slightly different directions on the latest version page, and followed them myself and it worked perfectly. EF, take a look and if you like it, go ahead and copy and past to the second post in this thread.

 

[OneBinary]

Okee Dokee, now I'm determined to get this working. First of all I'll mention I'm using TortoiseSVN 1.4.5.

Created folder and selected the SVN Checkout option. Note I do not have an 'SVN Update' option as mentioned on the 'Latest Version' page:


I pasted in the sourceforge link (I also tried this with the CFC link that EF posted earlier, same result with either link):


Checkout was successful, noting that the 'bug' folder now has a green checkmark:


This is to show what the contents of my 'bug' folder looks like, and I think this might be part of the issue. Notice how all folders and files have the green checkmark.


Right clicking on 'bug' and selecting the Export option:


Navigating to the My Games/Beyond the Sword directory to export to:


Confirmation Export was successful, but note the Export path, with 'bug' being a new subfolder:


And just showing how it created a subfolder within Beyond the Sword with all the files, rather than merging:


Are you guys seeing the same screens/options? Am I doing something wrong?

 

[alerum68]

yes, you are selecting to export the whole BUD mod directory, not just customassets. you have to select just customasssets to export directly. Make sure you export the ini as well.

 

[OneBinary]

yes, you are selecting to export the whole BUD mod directory, not just customassets. you have to select just customasssets to export directly. Make sure you export the ini as well.

Ah ha, I think that explains it. So I need to export the 4 relevant items one at a time, I'm following now. I think it might be helpful to add this step to the instructions.

Edit: Actually, I do not have the Export option when I right click on the ini file. Do I just manually copy that file over?

 

[alerum68]

I don't really like this method of installing it, so probably won't put the directions up. And you should have the export option, but otherwise yes you can just copy it to the main BTS directory.

 

[OneBinary]

I don't really like this method of installing it, so probably won't put the directions up.

Oh... is there a better method for installing the latest build from SVN?

 

[alerum68]

Yes. The method I put on the front page is really the best one I found to make sure you don't overwrite something you didn't want too. If you mess up a blank folder which you exported too, there isn't an issue... mess up your CA folder, and you may run into some problems with the game not working, and we'll see you over in the bug reporting thread.