Setting up a local
Subversion with OSX Lion and Netbeans 7.0.1
I've just recently found
that my projects are starting to get large and I'm having trouble
containing and editing all the scripts in my head. Including all the
required libraries, bitmap files, associated widgets and doodads, my
project has ballooned out to approximately 80 Meg. I'm still not sure
if svn is the best tool for the job, but, it's been around long
enough and a few random blogs seemed to suggest that it would be fine
for my purposes. I will explain how I setup a local svn repository on my local
MacBook hard drive.
A wealth of information
is located
www.netbeans.org
however, some of it is slightly dated with reference to Netbeans 6.0
and not personally relevant (at the moment) with reference to Ubuntu.
A great tutorial is located at
http://netbeans.org/kb/docs/ide/subversion.html
from where I gleaned a great deal of the information in this post.
The very first step is to
use a terminal and create the local repository. The repository
directory will be where svn will store all the files on the local
machine. Issuing the following command will setup the repository on
your computer:
svnadmin
create /Users/norman/Documents/workspace/seams.svn/
The folder name can be
anything you desire. Just don't go messing around with the internal files after you have created it, unless you know why you are playing with them.
Now we can fire up netbeans.
To set the path to the
Subversion executable file in the IDE:
Choose Tools >
Options (NetBeans > Preferences on Mac) from the main menu. The
Options dialog opens.
Select the
Miscellaneous icon along the top of the dialog, then click the
Versioning tab. In the left pane under Versioning Systems, select
Subversion. User-defined options for Subversion display in the main
window of the dialog:
In the Specify the
SVN Home Folder text field, either type in the path to the
executable file or click Browse to navigate to it on your system.
Note that you need not include the Subversion executable file
in the path.
Check “Prefix
Repository Location with Repository Url”.
-
Click OK, then
restart the IDE to allow changes to take effect.
Importing the
working files.
The next step is to
import your working files into the repository. Whilst you are
actually exporting files from your system, the term 'import' is used
in version control systems to signify that files are being imported
into a repository.
To import a project to a
repository:
From the Projects
window (Ctrl-1), select your unversioned project and choose
Versioning > Import into Subversion Repository from the node's
right-click menu. The Subversion Import wizard opens.
In the Subversion
Repository panel of the Import wizard, specify the protocol and
location of the Subversion repository as defined by the Subversion
URL. Depending on your selection, you may need to specify further
settings, such as repository username and password, or, in the case
of svn+ssh://, you must specify the tunnel command to establish the
external tunnel. See the Subversion User FAQ for further details.
Click Next.
-
In the Repository
Folder panel, specify the repository folder in which you want to
place the project in the repository. A folder containing the name of
your project is suggested for you in the Repository Folder text
field by default.
-
In the text area
beneath Specify the Message, enter a description of the project you
are importing into the repository.
Click Finish to
initiate the import, or optionally, click Next to continue to a
third panel that enables you to preview all files that are prepared
for import. From this panel, you can choose to exclude individual
files from the import, or identify the MIME types of files before
importing.
Thats it! All I need to
do now is work out how to merge trunks, setup svn+ssh:// and get the
project finished!
As I noted earlier, my
project is ballooning in size and complexity, so I'm also looking at
getting a UML-CASE tool, such as Visual Paradigm, working with my project. That, however, shall be left for another day. I've only so much time on my hands.
