# IT:AD:VST4G:HowTo:Clone an Existing Repository #



<callout type="Navigation" class="small">

* [[../|(UP)]]
{{indexmenu>.#2|nsort tsort}}


</callout>


<panel title="Summary">



</panel>


## Process ##


An example would be cloning the [[Projects/XActLib/]] project, which is an http://bitbucket.org hosted [[IT/AD/Git/]] project.

* Prerequisites:
    * You have downloaded, [[IT/AD/VST4G/HowTo/Install]]ed, and restarted VST4G
* In a browser:
    * Connect to: https://bitbucket.org/xact/cs.ff.xact.lib/ to see the project page.
    * On the right notice the drop down that offers the url in both HTTPS and SSH format.
    * Select the HTTPS one as VST4G -- for now -- only offers that type of connection, even though Bitbucket would prefer you to use SSH: [[IT/AD/SSH/HowTo/Configure for BitBucket]]
    * Copy the url: https://xact@bitbucket.org/xact/cs.ff.xact.lib.git
* In Visual Studio:
    * Select View/Team Explorer
    * Select the Connect tab
    * Under Local Git Repositories
    * Select Clone
    * Enter the URL
    * Enter a blank/empty directory.
    * The sync proccess will take about 5 minutes.
* Open the solution. Do *not* build yet.
    * As with all newly downloaded solutions that have nuget.org you don't have all the assemblies yet.
    * Go to the Package Manager Console. You'll see highlighted *"SomeNugetPackages are missing from this solution. Click to restore."* Click it. Go have lunch (it will take ages. Plan 30-45 minutes the first time...it's a large libary).* 
    * Come back...and build it. Should be fine.
* For the keen only -- and it has nothing to do with Git per say, just XActLib:
    * Don't do this unless you really know what you're getting yourself into (hours can be lost right here) consider whether it's the right time to invoke`undate-package` to bring the references up to date (will take an hour or so...and then you'll have to spend another hour to sort out the refs that just went from local (ie, cross Project) to point to the Bin...which is not useful for debugging).


## Resources ##

* http://tfs.visualstudio.com/en-us/learn/code/clone-vs-git/