Sdílet prostřednictvím

Příkaz Checkin

  • Článek

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Příkaz TFVC checkin zkontroluje změny čekajícího souboru a složky na serveru.

Téměř každá změna, kterou provedete v souborech na vývojovém počítači, je uložena ve vašem pracovním prostoru jako čekající změna , dokud ji nekontrolujete. Když změny zrušíte, uloží se na serveru jako sada změn. Tento checkin příkaz poskytuje jiné uživatelské rozhraní pro zpracování stejných procesů zdokumentovaných pro Visual Studio v rámci vrácení se změnami do základu kódu týmu.

Tipy

  • Pokud chcete zrušit změny nebo vyčistit pracovní prostor pro jiný úkol, použijte příkaz Shelve.

  • Pokud vaše vrácení se změnami blokuje konflikty, můžete je vyřešit pomocí příkazu Vyřešit.

  • Pokud počítač a uživatelský účet nemají namapovaný pracovní prostor na kolekci projektů, která obsahuje sadu odložených změn, můžete sadu odložených odložených položek a možnosti použít /shelveset /collection k vrácení se změnami.

Požadavky

Syntaxe

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

Popis

/author:<author name>

Identifikuje autora čekajících změn, aby uživatel mohl změny vrátit se změnami jménem jiného uživatele.

Vyžaduje oprávnění CheckinOther. Viz Referenční informace o oprávněních a skupinách.

/bypass

Obchází vrátný požadavek na vrácení se změnami. Další informace najdete v tématu Vrácení se změnami do složky, která je řízena procesem vrácení se změnami.

/collection:<ProjectCollectionUrl>

Pokud použijete shelveset tuto možnost, /collection určuje možnost adresu URL kolekce projektů, která obsahuje sadu odložených změn. Například: http://myserver:8080/tfs/DefaultCollection.

Ve výchozím nastavení se předpokládá, že kolekce projektů je ta, která obsahuje pracovní prostor, který mapuje aktuální adresář.

/comment

Přidruží komentář k sadě změn pomocí jednoho z následujících argumentů:

  • "<comment>": Komentář k přihlášení poskytnutý uživatelem.
  • @<comment file>: Cesta k souboru na disku, který obsahuje komentář k vrácení se změnami.

/force

Vynutí vrácení se změnami u položek s čekajícími úpravami, i když v souboru nejsou žádné změny obsahu.

<itemspec>

Určuje rozsah položek, které se mají vrátit se změnami z pracovního prostoru uživatele. Můžete zadat více než jeden itemspec argument. Syntaxi najdete v tématu Použití příkazů správy verzí Team Foundation.

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

Určuje uživatelský účet ke spuštění příkazu. Viz Použití příkazů správy verzí Team Foundation.

/new

Vybraný stav každé čekající změny, jak je znázorněno v dialogovém okně Vrátit se změnami . Komentář, přidružené pracovní položky, poznámky k vrácení se změnami a důvod přepsání zásad vrácení se změnami se ukládají na vašem vývojovém počítači jako čekající změny, dokud je nekontrolujete. Možnost /new zruší zaškrtnutí tohoto metadata vrácení se změnami před vrácením se změnami. Tato možnost a chování, které upravuje, nemají při použití /noprompt možnosti žádný vliv.

/noautoresolve

Ve výchozím nastavení se systém automaticky pokusí o AutoResolve All konflikty. Tuto možnost zadejte, pokud chcete toto výchozí chování zakázat. Další informace najdete v tématu Řešení konfliktů Správa verzí Team Foundation.

/noprompt

Potlačí zobrazení oken a dialogových oken, jako je dialogové okno Vrátit se změnami, a přesměruje výstupní data na příkazový řádek. Viz Použití příkazů správy verzí Team Foundation.

/notes

Poskytuje jednu nebo více poznámek pro vrácení se změnami pro přidružení k sadě změn pomocí jednoho z následujících argumentů:

  • <NoteFieldName>=<NoteFieldValue>: Nastaví hodnotu pole pro vrácení se změnami. Můžete zadat více výrazů oddělených středníkem field=value .
  • @<NoteFile>: Cesta k souboru na disku, která obsahuje názvy polí a hodnoty check-in poznámky ve formátu field=value. Dlaždice poznámky oddělená středníkem může obsahovat více řádků, například:

    <Field1>=<Value1>;
    <Field2>=<First line of Value2>;
    <Second line of Value2>;
    <Field3>=<Value3>;

/override

Přepíše zásadu vrácení se změnami pomocí jednoho z následujících argumentů:

  • reason: Důvod, proč se zásady vracení se změnami ignorují, je zadaný uživatelem.
  • reasonfile: Cesta k souboru, který obsahuje popis důvodu ignorování zásady vrácení se změnami.

/recursive

Rekurzivně kontroluje položky v zadaném adresáři a všech podadresářích.

/saved

Tento parametr ignorujte.

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

Určuje sadu odložených odložených polí, která se má vrátit se změnami. Volitelný owner argument určuje sadu odložených odložených dat, kterou aktuální uživatel nevlastní.

Poznámka:

Jakmile sadu odložených odložených polí zaškrtnete, systém ji odstraní.

/validate

Testuje, jestli by vrácení se změnami proběhlo úspěšně, bez vrácení souborů se změnami. Systém vyhodnocuje zásady vracení se změnami, poznámky k vrácení se změnami a zobrazí konflikty.

Poznámka:

Pokud tuto možnost nezadáte /noprompt , musíte zaškrtnout tlačítko Vrátit se změnami v dialogovém okně Vrátit se změnami a ověřit vrácení se změnami. Po výběru tohoto tlačítka systém soubory nekontroluje.

Příklady

Následující příklady předpokládají, že c:\code\SiteApp\Main je hlavní složka mapovaná na kolekci projektů v pracovním prostoru uživatele.

Vrácení všech čekajících změn v aktuálním pracovním prostoru se změnami

Následující příkaz zobrazí dialogové okno Vrátit se změnami, které zobrazuje všechny čekající změny v aktuálním pracovním prostoru. Pomocí dialogového okna Vrátit se změnami můžete vybrat nebo zrušit zaškrtnutí čekajících změn, které chcete vrátit se změnami, přidat komentář, přidružit pracovní položky a provádět další úkoly a potom po dokončení práce vybrat tlačítko Vrátit se změnami.

c:\code\SiteApp\Main>tf checkin

Vrácení všech čekajících změn se změnami pomocí komentáře

Následující příklad zkontroluje všechny čekající změny v aktuálním pracovním prostoru a poskytne komentář, který pomůže členům týmu porozumět účelu změn.

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

Vrácení změny do jedné položky bez použití dialogového okna Vrátit se změnami

Následující příklad zkontroluje čekající změny program.cs. Dialogové okno Vrátit se změnami se nezobrazí a pokud nějaké konflikty zablokují vrácení se změnami, systém nezobrazí okno konfliktů.

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