Installing SVN

From AMSN
Jump to: navigation, search

Cette page est également disponible en français: Installation de la version SVN

Esta página también está disponible en español: Instalar SVN

The SVN version of aMSN means the actual development version. This is the equivalent of the 'unstable' or 'beta' version of the software. If you use the SVN version, it means you will have all the latest bug fixes as well as new features. The drawback is that the SVN version could be unstable and may not work, but we are trying our best to keep it as stable as possible.

Note that most of the time, the SVN version is more stable than the latest released version. This is due to the fact that the SVN version has all the bugfixes to those bugs that were reported on the latest stable version.

If you're looking for how to compile aMSN with antialiasing look here

Contents

What is Subversion ?

Subversion, also known as SVN is a tool that keeps track of all work and all changes in a set of files. We use it for all files related to amsn's development. It allows several (potentially widely separated) developers to collaborate. But you can also benefit from that technology to get the latest development version of aMSN.

How to get the latest development version of aMSN ?

We offer you 2 ways for getting the latest development version:

  • by installing subversion: maybe a bit longer the first time, but will be easier to update.
  • by downloading the development archive.

You can browse amsn svn here:

http://amsn.svn.sourceforge.net/viewvc/amsn/trunk/amsn/

Windows

The Subversion way

Using TortoiseSVN

First of all you need to install the TortoiseSVN client. Get it at:

http://tortoisesvn.tigris.org/

if you don't have it already. You also need to have aMSN already installed.

Assuming you got all that, let's begin.

Step 1

Go the directory where you installed amsn (C:\Program Files\amsn by default). If you would like to keep your old installation rename the scripts folder to something good like scripts-0.96 or whichever version you were using. Create a new folder called scripts. You should have something like this:

Start.PNG

Then right-click on the new folder and select the SVN Checkout... option.

Step1.PNG

This takes us to:

Step 2

After clicking on the checkout option you will get a dialog-window. In the URL of repository: box enter the address: https://amsn.svn.sourceforge.net/svnroot/amsn/trunk/amsn and in the Checkout Directory: simply write the entire path to your newly created scripts directory.

Step22.PNG

Double check that you have not made any spelling mistakes or anything and then click OK. This will close the current dialog and open up a new one. Here you just wait. In the bottom left you should see some text and after a short while a lot of text will show in the text area too. Just wait until it's finished. This can sometimes take a while. The download is 9.68MB. You know it's complete when it says Completed At revision: xxxx (where xxxx is a number) at the bottom of the textbox.

Incomplete

Step32.PNG

Complete

Checkout-complete2.PNG

After completion just click on the OK button.

After a successful checkout you will get a changed directory icon for the directory which you used.

SVNdir.PNG

Assuming everything went well with the checkout, just start aMSN and enjoy the absolutely latest aMSN version. If you had a profile before switching to the new version I believe it will still be there.

Updating to latest revision

Since you now have a less stable release than before you might be wanting to keep the program update. To do this right click on the Scripts-folder and you will notice that SVN Checkout... is no longer there and instead you have two new options, namely SVN Update and SVN Commit... (There are also a couple of new options in the Tortoise SVN menu but you don't need any of them unless something goes wrong.)

Update1.PNG

SVN Update is of course the one you will use... My personal recommendation is to use it often. I myself run an update every time I start my computer which is about once a day.

NOTE: Doing an update does not download as much as a complete checkout since it only downloads changed and/or added files. Making it pretty safe to run once in a while even on a slow connection./NOTE Clicking on SVN Update will bring up a window just like the second picture in Step 2. When it says Completed At revision: xxxx you have the new version. Otherwise you can look and see what happened... Files can be Updated, Added, Deleted. If it only says Completed as in the picture below, it means you already are up-to-date

UpdateDone.PNG

NOTE: Don't have aMSN running while running an update. Otherwise the update sometimes can't complete.

Using Standard SVN

First of all you have to have Subversion installed. Get it at:

http://svn.tigris.org/

And you'll need a previously installed version of aMSN.

You got all that and you're ready to go.

If you would like to keep you old installation rename the scripts folder to something good like scripts-0.96 or wichever version you were using. Create a new folder called scripts You should have something like this (Nevermind the right click comment):

Start.PNG

Start the console (Start->Run->input cmd) go to the dir you want to checkout in (It should be your main aMSN dir. In this example it is C:\Program\amsnsvn\)

Write:

svn co https://amsn.svn.sourceforge.net/svnroot/amsn/trunk/amsn

and hit enter. After a short while there should be text starting to show up. Looking something like this:

Checkout2.PNG

Now all you have to do is wait and when it's done you'll see something like this:

SVNcheckout complete.PNG

(The Checkade ut revision: 7644 translates to "Checked out at revision: 7644") You will now have a new folder called amsn.

Now you have to rename the folder from amsn to scripts. Either you do that in the console with ren amsn scripts or in your file manager. Doesn't really matter.

Now you're done and just run the latest version of aMSN. Your profiles will still be there.

NOTE If you had some extra plugins in the amsnpath\scripts\plugins directory you have to move them from the old directory to the new one. Only the default plugins are included in the checkout. IF you hade them in the X:\Documents and Settings\username\amsn\plugins They'll still be there.

Keeping yourself up-to-date

To update to the latest revision open the console (Start->Run->input cmd) either you go to the scripts dir and run:

svn update

or you can write from any directory:

svn update X:\Full\Path\To\Scripts\

(as in this example it would've been svn update C:\amsnsvn\scripts\)

Wait until it says Update completed at revision xxxx (In the pic below that is the Uppdaterade till revision 7657. line)

SVNupdateComplete.PNG

I recommend updating often, (I myself do an update every time i start my computer. An update is a lot quicker than a complete checkout since it only downloads the updated and the eventually added files).

NOTE: Don't have aMSN running while running an update.

I made a little batch that runs svn at boot. If you want to use it yourself simply copy this line below into an empty .bat file and change the path to the right place. save and change the file extension from .txt to .bat

@svn update C:\Program\amsnsvn\scripts\ > C:\Program\amsnsvn\update.log

the > C:\Program\amsnsvn\update.log Writes everything that happens to a file called update.log so that you can check to see what was updated and which revision you landed on. It's totally optional and not really needed. the @ in front of everything simply prevents the entire line from being written on screen

The development archive way

  1. Get a working copy of the latest stable release from www.amsn-project.net
  2. download the latest SVN snapshot from amsn_dev.tar.gz
  3. go to directory C:\Program Files\amsn and rename the directory scripts to scripts-0.97
  4. extract amsn_dev.tar.gz here: it will create a directory called msn. Rename this to scripts and you should be ready.

MacOS X

The Subversion way

(This guide assumes you are an Administrator on your Mac, if you are not, please contact him/her in order to update the Application for you..)

You will first need to have the Subversion application installed on your system. You can get it from here,

You will then need to open a Terminal (It's in /Application/Utilities)

The first time you check out you will need to run these commands:

cd /Applications/aMSN.app/Contents/Resources/
sudo rm -rf Scripts
sudo svn co https://amsn.svn.sourceforge.net/svnroot/amsn/trunk/amsn Scripts
sudo chmod -R 775 Scripts

From then on, to update run:

svn up /Applications/aMSN.app/Contents/Resources/Scripts/

The development archive way

Svnmacstep1.png

Svnmacstep2.png

Svnmacstep3.png

Svnmacstep4.png

Svnmacstep5.png

Svnmacstep6.png

Svnmacstep7.png

Linux

/!\ Be cautious /!\ There're three ways to use/install SVN under Linux:

- The Subversion way
- The development archive way
- The apt-get (ubuntu only) way

You must choose one, and definitively use this same method.

If you use one, then the other, you'll get serious troubles.

The prefered method is the "Subversion way". This is because everytime you update your version, you will only need to download the latest changes (a few kilobytes) instead of downloading the whole package again (a few megabytes).

The Subversion way

First, you have to install subversion (e.g. sudo apt-get install subversion) Then, in a terminal, write:

svn co https://amsn.svn.sourceforge.net/svnroot/amsn/trunk/amsn amsn

Compiling aMSN

For instructions on how to compile aMSN, please following the guide at Compiling aMSN.

You will have to skip the extraction process, and the directory you will need to enter is called 'amsn'.

cd amsn

instead of

cd amsn-0.xx

as described in the Compiling aMSN page.

Launching aMSN

Type amsn at the prompt, in the "run" dialog of your Dekstop Environment, or Create a desktop launcher/item :)

Enjoy

How to update

If you want to update your SVN version to the latest changes, all you need to do is go to the amsn directory (the one where the svn version was checked out) and type:

svn update

Recompile if necessary and reinstall if you did before and you're done!

The development archive way

For the GNU/Linux based platforms we'll need a little more work

Get Prepared

First of all, make sure you have the right Dev Packages installed.

You'll need tcl8.5-dev and tk8.5-dev (name may differ, depending on your distro).

Open up a terminal, then do

wget http://www.amsn-project.net/amsn_dev.tar.gz

this will download amsn_dev.tar.gz in your home directory; then

tar xzvf amsn_dev.tar.gz

to extract the package right in your home

Compiling aMSN

For instructions on how to compile aMSN, please following the guide at Compiling aMSN.

You can skip the extraction process (you just did it with the above command), and the directory you will need to enter is called 'msn'.

cd msn

instead of

cd amsn-0.xx

as described in the Compiling aMSN page.

Launching aMSN

Type amsn at the prompt, in the "run" dialog of your Dekstop Environment, or Create a desktop launcher/item :)

The apt-get (ubuntu) way

This method is only useful for Ubuntu users using intrepid or jaunty. You can find more information about it in this forum thread: http://www.amsn-project.net/forums/viewtopic.php?t=6448


Enjoy

Personal tools