You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: mac/tf-version-control.md
+95-34Lines changed: 95 additions & 34 deletions
Original file line number
Diff line number
Diff line change
@@ -30,81 +30,142 @@ In Visual Studio for Mac, choose **Visual Studio > Extensions...** from the menu
30
30
31
31
Follow the prompts to install the extension. Once it's installed, restart the IDE.
32
32
33
+
## Updating the extension
34
+
35
+
Updates to the TFVC extension are made periodically. To access updates, choose **Visual Studio > Extensions...** from the menu and select the **Updates** tab. Select the extension in the list and press the **Update** button:
Press **Install** on the next dialog to uninstall the old package and install the new one.
40
+
41
+
For information on what's new in each release, see the [Release Notes](https://docs.microsoft.com/visualstudio/releasenotes/vs2017-mac-preview-relnotes#team-foundation-version-control-extension--release-notes).
42
+
33
43
## Using the add-in
34
44
35
-
Once the extension is installed, select the **Version Control > TFS/VSTS > Connect to Team Foundation Version Control...** menu item. Click **Add** to add a new account:
45
+
Once the extension is installed, select the **Version Control > TFS/VSTS > Open from Remote Repository** menu item.
36
46
37
-
47
+
Choose either Visual Studio Team Services or Team Foundation Server to get started and press **Continue**:
38
48
39
-
Choose either Visual Studio Team Services or Team Foundation Server to get started:
49
+
40
50
41
-
51
+
### VSTS Authentication
42
52
43
-
Enter your credentials and click **Log in**:
53
+
When you select a project that is hosted on VSTS, you're prompted to enter your Microsoft account details:
44
54
45
-
55
+
46
56
47
-
Once you've successfully logged in, select the projects that you want to access and press **OK**:
To connect to TFS, enter the server details and your account credentials. Enter a domain to use NTLM authentication, otherwise leave blank to use basic authentication. Select **Add Server**:
50
60
51
-
Select the **Version Control > TFS/VSTS > Source Control Explorer** menu item to open the source control explorer allowing you to browse the source.
61
+
52
62
53
-
> [!IMPORTANT]
54
-
> **Known issue**: In this preview release, the first time you open source control explorer, you'll have to [create a new workspace](#creating-a-new-workspace).
Once you've successfully authenticated, you can see a list of repositories that are associated with the account in the **Open from Source Control** dialog:
57
66
58
-
From the Source Code Explorer, you can browse your source code on the server and perform the following actions:
67
+
59
68
60
-
- Manage Workspaces (Create, edit, or delete).
61
-
- Navigate between project structure.
62
-
- Map projects.
63
-
- Get projects.
64
-
- Lock & Unlock files.
65
-
- Rename files.
66
-
- Delete files.
67
-
- Add new file.
68
-
- Check out.
69
-
- Check in.
70
-
- View history changes.
71
-
- Compare changes.
69
+
This dialog is organized with the following nodes:
70
+
71
+
- VSTS account or Collection – This displays all accounts connected to the Microsoft account that you logged in with
72
+
- Team Projects – Within each VSTS you can have a number of team projects. A team project is where source code, work items, and automated builds are hosted.
73
+
74
+
At this point, you can search and filter by the name of a project or account.
75
+
76
+
### Adding a new server
77
+
78
+
To add a new server to the list, press the **Add Host** button on the **Open from Source Control** dialog:
79
+
80
+
81
+
82
+
Select the provider from the list, and enter your credentials:
83
+
84
+
72
85
73
86
## Creating a new workspace
74
87
75
-
In the Source Control Explorer, click on the **Manage Workspaces** button.
88
+
To start working with a project, you need to have a _workspace_. If you don't already have a workspace, you can create one from the **Workspace** combobox in the **Open from Source Control** dialog:
89
+
90
+
91
+
92
+
Set the name and local path for your new workspace and select **Create Workspace**:
Once you've created a workspace and mapped your project, you can start working with the _Source Code Explorer_.
82
99
83
-
Provide a name for the workspace and then click **Add Working Folder** to map the project to a local folder on your computer.
100
+
To open the Source Code Explorer, select the **Version Control > TFS/VSTS > Source Control Explorer**:
84
101
85
-
When done, click **OK**, then close the Manage Workspaces dialog. You're now ready to get files though the Source Code Explorer and get started.
102
+
103
+
104
+
The Source Code Explorer enables you to navigate through all the mapped projects, their files, and folders. It also allows you to perform all the basic source control actions such as:
105
+
106
+
- Get the latest version
107
+
- Get a specific version
108
+
- Check files in and out
109
+
- Lock and unlock files
110
+
- Add, delete, and rename files
111
+
- View history
112
+
- Compare changes.
113
+
114
+
Many of these actions are available through context actions on the project:
115
+
116
+
117
+
118
+
## Managing workspaces
119
+
120
+
If you haven't already create a workspace, as described in the [Creating a workspace](#creating-a-new-workspace) section, you'll notice that the Source Code Explorer is empty:
To set up your remote project with a local workspace, use the following steps:
125
+
126
+
1. Select the **Server** from the combobox.
127
+
1. Note that there are "no workspaces" and that the Local Path is "Not Mapped". Select the **Not Mapped** link to display the **Create new Workspace** dialog.
128
+
1. Provide a name for the workspace and then click **Add Working Folder** to map the project to a local folder on your computer:
129
+
130
+
131
+
132
+
1. Select the "$" folder to map all Team projects on your server to the same workspace, or select an individual project, and click **OK**:
133
+
134
+
135
+
136
+
1. Select the location on your local machine that you wish mp the project(s) to and click **Select Folder**.
137
+
1. Confirm the details of the new workspace by pressing **OK**
138
+
139
+
140
+
141
+
Once your workspace is set up, it can be changed or removed by clicking the **Manage Workspaces** button in the Source Code Explorer.
142
+
143
+
86
144
87
145
## Troubleshooting
88
146
89
147
### Problems using basic authentication
90
148
91
-
There are a number of different options available to perform authentication with a server:
149
+
The following options can be used to authenticate with a server:
92
150
93
151
- Oauth
94
152
- Basic
95
153
- Ntlm
96
154
97
-
To be able to use basic authentication it is necessary to Enable**Alternative authentication credentials** in VSTS, by following the steps below:
155
+
To use basic authentication it is necessary to enable**Alternative authentication credentials** in VSTS, by following the steps below:
98
156
99
157
1. Sign in as the account owner to your VSTS account (https://{youraccount}.visualstudio.com).
100
158
2. From your account toolbar, select the gear icon and select **Policy**:
To set up Team Foundation Version Control (TFVC) on your dev machine, you **must** create a workspace, as described in the [Creating a new workspace](#creating-a-new-workspace) section.
168
+
To set up Team Foundation Version Control (TFVC) on your dev machine, you **must** create a workspace, as described in the [Managing workspaces](#managing-workspaces) section.
108
169
109
170
In Source Control Explorer, press the **Manage Workspaces** Button. Follow the steps to map the team project to a folder on your dev machine.
0 commit comments