Installing and Setting up SRL
From SRL Wiki
Contents |
Before you start...
There are two different SRL repositories: the stable Public Repository and the developer's Open Dev SRL. Both are available to the public but the Open Dev is updated more often and is the most stable one. For more information on each read about the SRL Repository.
This guide assumes that you have either SCAR 3.23 Beta or Simba installed, and are using Windows, or Mac/Linux (with WINE for SCAR).
Downloading SRL
There are a few ways of downloading the SRL source code. Whether a particular method applies to you depends on which repository you plan to use (Pub or Open Dev).
Using the SRL Download feature (Public SRL ONLY)
The "Download SRL" feature will only download the latest Public SRL from Freddy1990's server.
- To use this feature press "Download SRL" in SCAR's file menu.
- SCAR will then download the latest version and install it automatically. If the button is not shown in the File menu, it will show a "Checkout" or "Update from SVN" button. In this case you need to go into the options and switch from using subversion to the regular download feature.
Using SCAR's Subversion feature
- Download Subversion and install it. Restart your computer.
- If you're running a version older than 3.20, add a file named "SVN.ini" to SCAR's root folder eg. "Program Files/SCAR 3.xx".
- Fill it with the following content:
For the SRL Public Repository:
[SVN] Link=http://villavu.com/repositories/srl/
For the SRL Open Dev Repository:
[SVN] Link=http://villavu.com/repositories/srl-opendev/
- Now open SCAR. Go to Tools > Options. In the Options dialog box click the "SRL Download" tab.
- Check the "Subversion Repository" as the Download Type then click OK. If you aren't able to check this option then you have not installed Subversion properly. Make sure you restart your computer/SCAR after you install Subversion.
- Now that you have Subversion enabled for SCAR, click File > Checkout. A command shell should open detailing all files being downloaded.
- After that's done SRL should now be downloaded into the proper folder.
Using the Snapshots (Public SRL ONLY)
A snapshot is usually created and uploaded after a new SRL revision is released. It is only available for the Public SRL. Snapshots will not be created for the Open Dev repository.
Download a snapshot (.tar.bz2 or .zip format) from SRL's snapshots page. If you followed this first step, continue to "installing SRL".
Alternatively, SRL Snapshots can also be found on Freddy1990's site. Snapshots
Always download the latest SRL revision. Revision indices increase with each release so Revision #37 is newer than Revision #36.
Using Subversion with Tortoise SvN
- Download TortoiseSVN. (Tortoise SvN is a GUI client that comes with Subversion, install it.)
- Restart your computer once TortoiseSVN is installed. This guide assumes that you have downloaded Tortoise SvN.
- Now navigate Windows Explorer to your 'Includes' folder in the SCAR root folder. (eg. C:/Program Files/SCAR 3.XX/Includes).
- Create a new folder inside the Includes folder called 'SRL' (It must be called SRL eg. C:/Program Files/SCAR 3.XX/Includes/SRL). If you already have an SRL folder (eg. you're switching from Public SRL to Open Dev) then just rename the old one to something else and create a new folder:
- Now right-click the SRL folder and click the 'SVN Checkout' option:
- A dialog window should pop up.
- In the 'URL of the Repository' box enter the SRL repository url:
For the SRL Public Repository:
http://villavu.com/repositories/srl/
For the SRL Open Dev Repository:
http://villavu.com/repositories/srl-opendev/
- Now click OK. Another window should pop up detailing the files being downloaded. The download will be completed once you see "Completed: At revision: ###" where ### is the latest SRL revision number (it will vary depending on your SRL repository):
Installing SRL
Moving SRL to SCAR 3.XX/Includes
If you used the Snapshots, then SRL usually is not yet located in your SCAR/Includes folder.
- Extract the SRL#<RevisionNumberHere> to SCAR/Includes. Click Here for a detailed guide.
- The final structure should look similar to this:
C:/Program Files/SCAR 3.XX/Includes/SRL
- and there should be a file called SRL.scar in the SRL folder. ie.
C:/Program Files/SCAR 3.XX/Includes/SRL/SRL.scar
Moving the plugins
If you're using the SCAR Subversion method you can skip this step. Else read on...
SRL not only contains SCAR files but also contains .dll plugin files written in Delphi. These files contain highly optimised functions used in advanced randoms solvers and other advanced scripting methods. It also contains SMART an addon for SCAR that enables users to auto minimised.
- In SCAR 3.XX/Includes/SRL/ there should be a folder called Place inside plugins folder.
- Copy all the files in there to SCAR 3.XX/Plugins.
- Restart SCAR.
- SRL is now successfully installed. Congratulations.
On Vista!
On some occasions, users experience problems when installing SRL via the Subversion (e.g, the infamous Could Not Move Plugins error). You can find various instructions on how to get SRL installed properly on Vista here. This error only appears when one is using the SRL Download feature that comes with SCAR or using the Subversion Repository.
Updating SRL
SRL is updated regularly to include improvements, bug fixes and new features. This guide will show you how to update SRL easily rather than having to re-download/install.
SRL Download Feature
Those using this method will need to click "SRL Download" again through File. You will also need to move the plugins again.
Snapshots
If you chose to use Snapshots, you must first completely remove your old SRL folder, located in SCAR/Includes. Then download the latest SRL's snapshot. The following instructions are the same as installing SRL, Click Here for a detailed guide.
SCAR's Subversion Feature
If you chose this method then updating SRL is very easy. Just go to File > Update SRL SVN. Wait for the new files to be downloaded and you're done.
Subversion with TortoiseSVN
Browse to your Includes folder and right click /SRL/. Click "Update" and wait for the new files to arrive. Afterwards move your plugins and you're done.
