Checkin , polecenie

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Polecenie TFVC checkin sprawdza oczekujące zmiany w pliku i folderze na serwerze.

Prawie każda zmiana wprowadzana w plikach na maszynie dewelopera jest przechowywana w obszarze roboczym jako oczekująca zmiana do momentu zaewidencjonowania. Gdy zaewidencjonujesz zmiany, są one przechowywane jako zestaw zmian na serwerze. Polecenie checkin udostępnia inny interfejs użytkownika do wykonywania tych samych procesów udokumentowanych dla programu Visual Studio w obszarze Zaewidencjonuj swoją pracę w bazie kodu zespołu.

Wskazówki

• Aby odłożyć zmiany lub wyczyścić obszar roboczy dla innego zadania, użyj polecenia Shelve.

• Jeśli konflikty blokują ewidencjonowania, możesz użyć polecenia Rozwiąż, aby je rozwiązać.

• Jeśli maszyna i konto użytkownika nie mają obszaru roboczego mapowanego na kolekcję projektów zawierającą zestaw półek, możesz użyć /shelveset opcji i /collection , aby zaewidencjonować zestaw na półce.

Wymagania wstępne

• Domyślne uprawnienia kontroli wersji serwera Team Foundation

Składnia

tf checkin [/author:author name] [/comment:("comment"|@comment file)] 
[/noprompt] [/notes:("Note Name"="note text"|@notefile)] 
[/override:(reason|@reasonfile)] [/recursive] [/saved] [/validate] [itemspec] [/bypass] [/force] [/noautoresolve] [/login:username,[password]] [/new]

tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]

Parametry

Parametr

Opis

---

/author:<author name>

Identyfikuje autora oczekujących zmian, aby użytkownik mógł zaewidencjonować zmiany w imieniu innego użytkownika.

Wymaga uprawnienia CheckinOther. Zobacz Informacje o uprawnieniach i grupach.

/bypass

Pomija wymaganie zaewidencjonowane przez bramkę. Aby uzyskać więcej informacji, zobacz Ewidencjonowanie w folderze kontrolowanym przez proces kompilacji zaewidencjonowanej bramki.

/collection:<ProjectCollectionUrl>

Jeśli używasz shelveset opcji, /collection opcja określa adres URL kolekcji projektu, która zawiera zestaw półek. Na przykład: http://myserver:8080/tfs/DefaultCollection.

Domyślnie kolekcja projektów jest przyjmowana jako kolekcja zawierająca obszar roboczy, który mapuje bieżący katalog.

/comment

Kojarzy komentarz z zestawem zmian przy użyciu jednego z następujących argumentów:

• "<comment>": komentarz podany przez użytkownika dotyczący zaewidencjonu.
• @<comment file>: ścieżka do pliku na dysku, który zawiera komentarz do ewidencjonowania.

/force

Wymusza zaewidencjonowane elementy z oczekującymi edycjami, nawet jeśli w pliku nie ma żadnych zmian zawartości.

<itemspec>

Określa zakres elementów do zaewidencjonowania z obszaru roboczego użytkownika. Można określić więcej niż jeden itemspec argument. Aby uzyskać informacje o składni, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

/login:<username>[,<password>]

Określa konto użytkownika, aby uruchomić polecenie. Zobacz Używanie poleceń kontroli wersji programu Team Foundation.

/new

Wybrany stan każdej oczekującej zmiany, jak pokazano w oknie dialogowym Synchronizacja. Komentarz, skojarzone elementy robocze, notatki zaewidencjonowania i przyczyna zastąpienia zasad ewidencjonowania są przechowywane na maszynie dewelopera jako oczekujące zmiany do momentu ich zaewidencjonowania. Opcja /new czyści te metadane ewidencjonu przed zaewidencjonowaniu. Ta opcja i zachowanie, które modyfikuje, nie mają wpływu podczas korzystania z /noprompt opcji.

/noautoresolve

Domyślnie system automatycznie próbuje wywołać AutoResolve All konflikty. Określ tę opcję, aby wyłączyć to zachowanie domyślne. Aby uzyskać więcej informacji, zobacz Rozwiązywanie konfliktów Kontrola wersji serwera Team Foundation.

/noprompt

Pomija wyświetlanie okien i okien dialogowych, takich jak okno dialogowe Synchronizacja, i przekierowuje dane wyjściowe do wiersza polecenia. Zobacz Używanie poleceń kontroli wersji programu Team Foundation.

/notes

Udostępnia co najmniej jedną notatkę zaewidencjonowania do skojarzenia z zestawem zmian przy użyciu jednego z następujących argumentów:

• <NoteFieldName>=<NoteFieldValue>: Ustawia wartość pola zaewidencjonowania. Można podać wiele wyrażeń rozdzielonych field=value średnikami.
• @<NoteFile>: podana przez użytkownika ścieżka pliku na dysku, który zawiera nazwy pól zaewidencjonowania i wartości w formacie field=value. Rozdzielony średnikami kafelek notatek może obejmować wiele wierszy, na przykład:
  
  <Field1>=<Value1>;
<Field2>=<First line of Value2>;
<Second line of Value2>;
<Field3>=<Value3>;

/override

Zastępuje zasady ewidencjonowania przy użyciu jednego z następujących argumentów:

• reason: podany przez użytkownika powód, dla którego zasady ewidencjonowania są ignorowane.
• reasonfile: ścieżka do pliku zawierającego podany przez użytkownika opis przyczyny ignorowania zasad ewidencjonowania.

/recursive

Rekursywnie sprawdza elementy w określonym katalogu i wszystkich podkatalogach.

/saved

Zignoruj ten parametr.

/shelveset:<shelvesetname>[;<owner>]

Określa zestaw na półce do zaewidencjonowania. Opcjonalny owner argument określa zestaw na półce, którego bieżący użytkownik nie jest właścicielem.

Uwaga

Po zaewidencjonowania zestawu na półce system go usunie.

/validate

Sprawdza, czy ewidencjonowanie zakończy się pomyślnie, bez ewidencjonowanie plików. System ocenia zasady ewidencjonowania, notatki ewidencjonowania i wyświetla konflikty.

Uwaga

Jeśli nie określisz /noprompt opcji, musisz wybrać przycisk Synchronizacja w oknie dialogowym Synchronizacja, aby sprawdzić poprawność zaewidencjonowania. Po wybraniu tego przycisku system nie zaewidencjonuje plików.

Przykłady

W poniższych przykładach przyjęto założenie, że c:\code\SiteApp\Main jest to folder główny zamapowany na kolekcję projektu w obszarze roboczym użytkownika.

Zaewidencjonuj wszystkie oczekujące zmiany w bieżącym obszarze roboczym

Następujące polecenie wyświetla okno dialogowe Synchronizacja, w którym są wyświetlane wszystkie oczekujące zmiany w bieżącym obszarze roboczym. Możesz użyć okna dialogowego Synchronizacja, aby zaznaczyć lub wyczyścić oczekujące zmiany, które chcesz zaewidencjonować, dodać komentarz, skojarz elementy robocze i wykonać inne zadania, a następnie wybrać przycisk Synchronizacja, gdy wszystko będzie gotowe do kontynuowania.

c:\code\SiteApp\Main>tf checkin

Zaewidencjonuj wszystkie oczekujące zmiany z komentarzem

Poniższy przykład sprawdza wszystkie oczekujące zmiany w bieżącym obszarze roboczym i zawiera komentarz, aby pomóc kolegom z zespołu zrozumieć przeznaczenie zmian.

c:\code\SiteApp\Main>tf checkin /comment:"Re-implemented Pi calculator"

Zaewidencjonuj zmianę pojedynczego elementu bez korzystania z okna dialogowego Synchronizacja

Poniższy przykład sprawdza oczekujące zmiany w program.cs. Okno dialogowe Synchronizacja nie jest wyświetlane, a jeśli jakiekolwiek konflikty blokują ewidencjonowanie, system nie wyświetla okna konfliktów.

c:\code\SiteApp\Main>tf checkin program.cs /noprompt