Dodaj pliki do serwera

Dodawanie pliku do kontroli wersji jest zwykle automatyczne, jeśli korzystasz z Eksploratora rozwiązań, a projekt jest pod kontrolą wersji.Jednak w niektórych przypadkach należy podjąć dodatkowe kroki, aby dodać projekt do kontroli wersji.

Porada
Przed dodaniem plików do kontroli wersji należy najpierw skonfigurować obszar roboczy na komputerze deweloperskim.

Co chcesz zrobić?

• Utwórz nowy projekt kodu i rozwiązanie pod kontrolą wersji

• Umieść istniejące rozwiązanie i projekty kodu pod kontrolą wersji

• Dodaj jeden lub więcej plików do systemu kontroli wersji

• Wykorzystaj pliki binarne innych firm, których twój kod nie kompiluje

• Zdecyduj, które pliki mają być ignorowane przez kontrolę wersji

• Praca z wiersza polecenia

Utwórz nowy projekt kodu i rozwiązanie pod kontrolą wersji

Możesz jednocześnie utworzyć nowy projekt zespołowy i dodać go do kontroli wersji, tak, że i ty sam, i twój zespół możecie od razu wykorzystywać wszystkie zalety kontroli wersji, począwszy od pierwszego wiersza tworzonego kodu.

1. W programie Visual Studio, jeśli jeszcze tego nie zrobiłeś, połącz się z projektem zespołowym.

2. Wybierz Plik, Nowy, Projekt (Klawiatura: Ctrl + Shift + N).

   Pojawi się okno dialogowe Nowy projekt.

3. Wybierz typ projektu kodu, który chcesz utworzyć.

4. W polu Nazwa określ nazwę projektu kodu.

5. Jeśli wyświetli się lista Rozwiązanie, upewnij się, że jest zaznaczona opcja Utwórz nowe rozwiązanie.

6. Na liście Lokalizacja określ ścieżkę do odpowiedniego lokalnego folderu roboczego (np. c:\code\SiteApp\Main\) w obszarze roboczym, utworzonym podczas konfiguracji komputera deweloperskiego.

   Upewnij się, że pola wyboru Utwórz katalog rozwiązania i Dodaj do kontroli źródła są zaznaczone.

7. Wybierz OK, aby utworzyć projekt kodu, który można wyświetlić w oknie Eksploratora rozwiązań (Klawiatura: Ctrl + Alt + L).

   

8. W Eksploratorze rozwiązań otwórz menu kontekstowe utworzonego lub zmodyfikowanego rozwiązania, a następnie wybierz polecenie Zaewidencjonuj, aby przesłać oczekujące zmiany.

Umieść istniejące rozwiązanie i projekty kodu pod kontrolą wersji

Aby dodać istniejące rozwiązanie do kontroli wersji, przenieś wszystkie pliki rozwiązania do obszaru roboczego, a następnie je dodaj.

[!UWAGA]

Unikaj korzystania z okna dialogowego Dodaj rozwiązanie do kontroli źródła w celu przekazywania swojego rozwiązania do kontroli wersji.Zamiast tego użyj poniższej procedury.

1. W programie Visual Studio, jeśli jeszcze tego nie zrobiłeś, połącz się z projektem zespołowym.

2. Wybierz Widok, Inne okna, Eksplorator kontroli źródła.

3. W Eksploratorze kontroli źródła przejdź do logicznego folderu nadrzędnego dla rozwiązania, takiego jak $/SiteApp/Main, gdzie SiteApp jest nazwą projektu zespołowego.Dlaczego to folderu nadrzędnego dobrej?

4. Wybierz łącze obok opcji Ścieżka lokalna, aby otworzyć folder nadrzędny w Eksploratorze Windows (lub Eksploratorze plików w Windows 8).

   Co zrobić, jeśli tekst łącza jest „Niezamapowany”?

5. Przenieś folder, który zawiera rozwiązanie, do folderu nadrzędnego.

6. W Visual Studio, wybierz Plik, Otwórz, Projekt/rozwiązanie, a następnie użyj okna dialogowego Otwórz projekt, aby otworzyć rozwiązanie.

7. W Eksploratorze rozwiązań (Klawiatura: Ctrl + Alt + L) wybierz rozwiązanie, otwórz jego menu kontekstowe, a następnie wybierz opcję Dodaj rozwiązanie do kontroli źródła.

8. W Eksploratorze rozwiązań wybierz rozwiązanie, otwórz jego menu kontekstowe i wybierz polecenie Zaewidencjonuj.

9. W programie Team Explorer pojawi się strona Oczekujące zmiany.

10. Czy jakiekolwiek Wykryte zmiany są widoczne w sekcji Wykluczone zmiany?

    • Nie: Przejdź do następnego kroku.

    • Tak: Wybierz łącze Wykryte zmiany.Pojawi się okno dialogowe Podwyższanie poziomu zmian kandydujących.Do plików wymienionych w tym oknie dialogowym nie odwołują się żadne projekty kodu w rozwiązaniu.Jeśli zespół będzie potrzebował tych plików, upewnij się, że są zaznaczone, a następnie wybierz polecenie Podwyższ poziom, aby przenieść je do sekcji Uwzględnione zmiany na stronie Oczekujące zmiany.Aby uzyskać więcej informacji, zobacz Ewidencjonowanie pracy w ścieżce bazowej kodu zespołu.

11. Kiedy będziesz gotowy, prześlij oczekujące zmiany.

Dodaj jeden lub więcej plików do systemu kontroli wersji

Gdy korzystasz z Eksploratora rozwiązań, aby dodać plik do projektu kodu, system automatycznie doda go do kontroli wersji.Jednak możesz również dodawać pliki, do których nie odwołują się projekty kodu.

Porada
Jeśli tworzysz zautomatyzowany proces lub wolisz korzystać z wiersza polecenia, możesz użyć Polecenie Add zamiast poniższych procedur.

Automatycznie dodaj jeden lub więcej plików do systemu kontroli wersji

Jeśli używasz lokalnego obszaru roboczego, nowe pliki są automatycznie wykrywane przez stronę Oczekujące zmiany.

1. W programie Visual Studio, jeśli jeszcze tego nie zrobiłeś, połącz się z projektem zespołowym.

2. Wybierz Widok, Inne okna, Eksplorator kontroli źródła.

3. W Eksploratorze kontroli źródła przejdź do folderu, w którym chcesz dodać pliki lub foldery.

4. Wybierz łącze obok opcji Ścieżka lokalna, aby otworzyć folder docelowy w Eksploratorze Windows (lub Eksploratorze plików w Windows 8).

   Przenieś swoje pliki i foldery do tego folderu.

   Co zrobić, jeśli tekst łącza jest „Niezamapowany”?

5. W programie Visual Studio, w Team Explorer wybierz opcję Oczekujące zmiany.

6. Na stronie Oczekujące zmiany w sekcji Wykluczone zmiany wybierz Wykryte zmiany.

7. W oknie dialogowym Podwyższanie poziomu zmian kandydujących upewnij się, że zaznaczone są tylko pliki, które chcesz zaewidencjonować, a następnie wybierz polecenie Podwyższ poziom.

8. Prześlij oczekujące zmiany.

Ręcznie dodaj pliki do kontroli wersji

Możesz także ręcznie dodawać pliki do kontroli wersji.

1. Wybierz Widok, Inne okna, Eksplorator kontroli źródła.

2. W Eksploratorze kontroli źródła przejdź do folderu, w którym chcesz umieścić pliki.

   Ważne
   Zanim przejdziesz dalej, upewnij się, że ten folder jest zaewidencjonowany.Jeśli teraz tworzysz folder, otwórz jego menu kontekstowe i wybierz polecenie Zaewidencjonuj, a następnie, zanim przejdziesz dalej, zaewidencjonuj nowy folder.

3. Przeciągnij foldery lub pliki z Eksploratora Windows (lub Eksploratora plików) do folderu w Eksploratorze kontroli źródła.

4. Gdy wyświetli się okno dialogowe Dodaj do kontroli źródła, upewnij się, że są zaznaczone wszystkie pliki, które chcesz dodać, a następnie wybierz opcję Uwzględnij elementy.

5. Wybierz Zakończ.

6. W programie Team Explorer, gdy pojawi się strona Oczekujące zmiany, upewnij się, że pliki binarne, które chcesz dodać, są w sekcji Uwzględnione zmiany.Wybierz Zaewidencjonuj.

Wykorzystaj pliki binarne innych firm, których twój kod nie kompiluje

Wiele zespołów rozwija kod, który zależy od plików binarnych. Te z kolei są kompilowane przez rozwiązanie, w którym zarządzają swoim kodem.Zazwyczaj te pliki binarne są częścią biblioteki, na którą zespół ma licencję od innej firmy.

Czasami te dane binarne pochodzą od innego zespołu w tej samej firmie.Na przykład zespół A zależy od plików binarnych produkowanych przez zespół B, a każdy zespół musi z jakiegoś powodu pracować na różnych kolekcjach projektów zespołowych.W efekcie Zespół B dostarcza pliki binarne Zespołowi A, który następnie ewidencjonuje je w kontroli wersji.

Porada
Jeśli komputery deweloperskie i serwery kompilacji mogą się łączyć z Internetem, system NuGet może ułatwić zespołowi zarządzanie zależnościami i aktualizowanie plików binarnych na bieżąco.Nawet jeśli użytkownik zdecyduje się używać systemu NuGet, należy prawdopodobnie tak czy owak dodać pliki binarne do systemu kontroli wersji, aby można było odtworzyć oraz skompilować historyczne wersje kodu.

Struktura folderów i obszarów roboczych, której należy używać do przechowywania plików binarnych pochodzących od innych firm, zależy od tego, jak rozwiązania zależą od tych bibliotek.

Dodaj pliki binarne w strukturze folderu lub gałęzi

Jeśli umieścisz pliki binarne innych firm w folderze nadrzędnym, który zawiera foldery rozwiązania, wszystkie projekty kodu we wszystkich rozwiązaniach mogą się odwoływać do bibliotek o takiej samej ścieżce względnej.

Na przykład zespół używa tej struktury folderów:

Każdy projekt kodu może się wtedy odwoływać do folderu bibliotek z następującą ścieżką względną: ../../Lib

Jeśli później w trakcie pracy nad projektem zespół musi wyodrębnić oddzielne nakłady pracy, które wymagają różnych wersji plików binarnych, możesz rozgałęzić folder bibliotek wraz z folderem rozwiązania.

Na przykład wersja 1 aplikacji wykorzystuje bibliotekę w wersji 1.Niektórzy deweloperzy z zespołu Data Access pracują nad nową wersją i wykorzystują wersję 2.Jednak inne zespoły nie są jeszcze gotowe do uaktualnienia.Do zarządzania tego rodzaju sytuacją można użyć gałęzi.

Używanie obszaru roboczego do mapowania w plikach binarnych

Niektóre firmy muszą zarządzać bardziej skomplikowanymi zależnościami od bibliotek innych producentów.Na przykład wiele projektów zespołowych zawiera rozwiązania z różnymi zależnościami od wspólnego zbioru bibliotek.W takich sytuacjach można przechowywać biblioteki innych producentów w wydzielonym projekcie zespołowym.Współautorzy różnych projektów zespołowych mapują w folderach, które zawierają potrzebne biblioteki.

Na przykład rozwiązanie FabrikamFiber tworzy następującą strukturę projektu zespołowego, gałęzi i folderów:

Raisa konfiguruje na swoim komputerze deweloperskim dwa obszary robocze dla dwóch różnych przedsięwzięć, a dla każdego obszaru mapuje potrzebne biblioteki:

Zdecyduj, które pliki mają być ignorowane przez kontrolę wersji

System kontroli wersji domyślnie ignoruje niektóre typy plików (na przykład pliki .dll).W efekcie:

• Po dodaniu ignorowanych plików do folderów, które są mapowane w lokalnym obszarze roboczym, nie są one widoczne na stronie Oczekujące zmiany w programie Team Explorer.

• Podczas próby dodania ignorowanych plików za pomocą okna dialogowego Dodaj do kontroli źródła (na przykład przeciągając je do Eksploratora kontroli źródła), automatycznie wyświetlają się w oknie Wykluczone elementy.

Możesz skonfigurować ignorowane typy plików, umieszczając plik tekstowy o nazwie .tfignore w folderze, w którym mają być stosowane reguły.Efekty działania pliku .tfignore są cykliczne.Jednakże można utworzyć pliki .tfignore w podfolderach, aby nadpisać reguły pliku .tfignore umieszczonego w folderze nadrzędnym.

Reguły pliku .tfignore

Do pliku .tfignore są stosowane następujące reguły:

• Znak # rozpoczyna wiersz komentarza

• Obsługiwane są symbole wieloznaczne * i ?.

• Pliki jest cykliczne, chyba że poprzedzone \ znaków.

• Znak ! neguje specyfikację plików (pliki pasujące do wzorca nie są ignorowane)

Przykład pliku .tfignore

######################################
# Ignore .cpp files in the ProjA sub-folder and all its subfolders
ProjA\*.cpp
# Ignore .txt files in this folder 
\*.txt
# Ignore .xml files in this folder and all its sub-folders
*.xml
# Ignore all files in the Temp sub-folder
\Temp
# Do not ignore .dll files in this folder nor in any of its sub-folders
!*.dll

Tworzenie i używanie pliku .tfignore

Możesz ręcznie tworzyć plik tekstowy .tfignore przy użyciu powyższych zasad, lecz możesz również generować go automatycznie, gdy strona Oczekujące zmiany wykryje zmianę.

Aby automatycznie wygenerować plik .tfignore

1. Na stronie Oczekujące zmiany w sekcji Wykluczone zmiany wybierz łącze Wykryte zmiany.

   Pojawi się okno dialogowe Podwyższanie poziomu zmian kandydujących.

2. Wybierz plik, otwórz jego menu kontekstowe i wybierz polecenie zignorować ten element lokalnego, ignorowania przez rozszerzenie, Ignoruj według nazwy pliku, lub ignorowania przez folder.

3. Wybierz OK lub Anuluj, aby zamknąć okno dialogowe Podwyższanie poziomu zmian kandydujących.

4. Plik .tfignore pojawia się w sekcji Uwzględnione zmiany strony Oczekujące zmiany.Możesz otworzyć ten plik i zmodyfikować go odpowiednio do własnych potrzeb.

Plik .tfignore jest automatycznie dodawany jako dołączona oczekująca zmiana, dzięki czemu reguły, które stworzyłeś, będą zastosowane dla każdego członka zespołu, który pobiera plik.

Praca z wiersza polecenia

• Polecenie Add Przekazywanie plików z obszaru roboczego na komputerze deweloperskim do serwera.

Zobacz też

Inne zasoby

Wybieranie lokalnego lub serwerowego obszaru roboczego