Použití příkazů správy verzí Team Foundation

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

Visual Studio 2019 | Visual Studio 2022

Pomocí příkazů správy verzí můžete provádět téměř všechny úlohy Správa verzí Team Foundation (TFVC), které můžete provádět v sadě Visual Studio. Příkazy správy verzí můžete použít také k provedení několika úloh, které se nedají udělat v sadě Visual Studio. Pokud chcete spouštět příkazy správy verzí z příkazového řádku nebo ve skriptu, použijte nástroj tf.exe .

Spuštění příkazu

Pokud chcete spustit příkazový řádek sady Visual Studio, v nabídce Windows Start vyberte zástupce vývojářského příkazového řádku pro VS2022 nebo starší verzi.

Ve většině případů spustíte příkaz správy verzí v kontextu adresáře, který je namapovaný v pracovním prostoru. Například $/SiteApp/Main/ je namapován na c:\\code\\SiteApp\\Main\\. Pokud chcete získat nejnovější verzi všech položek v pracovním prostoru, použijte následující příkaz:

c:\code\SiteApp\Main\SolutionA>tf get

Nastavení vývojového počítače a správa pracovních prostorů

Váš pracovní prostor je místní kopie základu kódu vašeho týmu. Vzhledem k tomu, že se jedná o místní kopii na vývojovém počítači, můžete vyvíjet a testovat kód izolovaně, dokud nebudete připraveni se vrátit se změnami. Tady je několik příkazů pro správu pracovního prostoru:

• Příkaz proxy
• Pracovní příkaz
• Příkaz Pracovní prostor
• Příkaz Pracovní prostory

Další informace naleznete v následujících zdrojích:

• Nastavení Správa verzí Team Foundation na vývojovém počítači
• Vytváření a práce s pracovními prostory

Vývoj aplikací

Pomocí těchto příkazů můžete aplikaci vyvíjet ve správě verzí s týmem:

• Příkaz Přidat: Přidá soubory a složky do správy verzí.
• Příkaz Rezervovat (nebo Upravit): Zkontroluje soubor a změní stav čekající změny, který chcete upravit.
• Příkaz Odstranit (Správa verzí Team Foundation): Odebere soubory a složky ze serveru Azure DevOps a odstraní je z disku.
• Příkaz Získat: Získá (stáhne) nejnovější verzi nebo zadanou verzi jednoho nebo více souborů nebo složek z Azure DevOps Serveru do pracovního prostoru.
• Příkaz Přejmenovat (Správa verzí Team Foundation): Změní název nebo cestu souboru nebo složky.
• Stavový příkaz: Zobrazí informace o čekajících změnách souborů a složek v pracovních prostorech nebo v sadě odložených změn.
• Příkaz Zpět: Zahodí zadané čekající změny souborů nebo složek.
• Příkaz Zrušit odstranění: Obnoví položky, které byly dříve odstraněny.

Další informace najdete v tématu Vývoj aplikace ve správě verzí Team Foundation.

Pozastavení práce

Z různých důvodů je někdy potřeba některé nebo všechny probíhající práce vyhradit. Pokud chcete pozastavit a pokračovat v práci a spravovat sady odložených dat, použijte tyto příkazy:

• Příkaz Shelve
• Příkaz Sady odložených odložených polí
• Příkaz Unshelve

Další informace najdete v tématu Pozastavení práce a správa sad odložených informací.

Přispívání do práce

checkin Pomocí příkazu zkontrolujte kód do základu kódu týmu:

• Příkaz Vrácení se změnami: Kontroluje čekající změny souborů nebo složek na serveru.

Další informace najdete v tématu Vrácení práce do základu kódu týmu.

Správa souborů a řešení problémů

Ke správě souborů použijte prostředky v následujících částech.

Zobrazení a správa souborů a složek správy verzí

• Příkaz Vlastnosti (nebo Informace): Zobrazí informace o položkách ve správě verzí.
• Příkaz Dir: Zobrazí obsah serveru správy verzí.
• Příkaz Destroy (Správa verzí Team Foundation): Trvale odstraní soubory řízené verzí.
• Příkaz LocalVersions: Zobrazí verze položek pracovního prostoru.

Další informace najdete v tématu Použití Průzkumníka správy zdrojového kódu ke správě souborů v rámci správy verzí.

Zobrazení a správa předchozích verzí

• Příkaz Sady změn: Změny nebo zobrazení atributů sady změn
• Příkaz Historie: Zobrazí historii revizí souborů nebo složek.
• Příkaz Popisek (Správa verzí Team Foundation): Připojí nebo odebere popisky ze souborů nebo složek.
• Příkaz Popisky: Zobrazí informace o popiscích, které se používají na serveru.
• Návratový příkaz (Správa verzí Team Foundation): Vrátí zpět účinky sad změn.
• Příkaz Zrušit označení: Odebere položku z existujícího popisku na serveru.
• Příkaz Zobrazit: Načte zadanou verzi souboru a zobrazí ji.

Další informace najdete v tématu Zobrazení a správa předchozích verzí.

Porovnání složek a souborů

• Příkaz Rozdíl: Porovnává rozdíly mezi soubory a sadami odložených změn.
• Příkaz Folderdiff: Porovnává rozdíly mezi soubory ve dvou složkách.

Další informace najdete v tématu Zobrazení a správa předchozích verzí.

Řešení konfliktů souborů

• Příkaz Vyřešit: Vyřeší konflikty mezi položkami v pracovním prostoru a na serveru.

Další informace najdete v tématu Řešení konfliktů Správa verzí Team Foundation.

Práce s zámky správy verzí

• Příkaz Zamknout: Uzamkne nebo odemkne soubory a složky.

Další informace naleznete v tématu Práce s zámky správy verzí.

Izolace rizika

Pomocí následujících příkazů můžete riziko izolovat pomocí větví:

• Příkaz Branch
• Příkaz Větve
• Příkaz Sloučit
• Sloučit příkaz

Další informace najdete v tématu Použití větví k izolaci rizika v Správa verzí Team Foundation.

správa verzí Správa ister

Ke správě systému správy verzí použijte následující příkazy:

• Konfigurovat příkaz
• Příkaz Oprávnění

Další informace najdete v tématu Konfigurace nastavení rezervace.

Získání nápovědy k příkazům správy verzí

Podrobné informace o příkazech správy verzí získáte pomocí následujících příkazů:

• Příkaz Nápověda (Správa verzí Team Foundation)
• Příkaz Msdn

Principy syntaxe příkazů

Syntaxe každého příkazu se zobrazí v horní části každého referenčního článku.

Povinné a volitelné argumenty

Argumenty bez závorek jsou povinné. [Hranaté závorky] označuje volitelné argumenty, které nejsou nutné k dokončení příkazu. Některé volitelné argumenty ale mají výchozí hodnoty použité u příkazu, i když tuto možnost nezadáte.

Exkluzivní argumenty

Pokud jsou možnosti oddělené svislou rourou (|), můžete zadat jednu z možností.

Doslovné a nahraditelné argumenty

Položky, které nejsou uzavřené v hranatých závorkách, jsou možnosti, které zahrnete doslovně. Položky uzavřené v hranatých závorkách (< a >) jsou argumenty, které je nutné nahradit skutečnými znaky, aby bylo možné provést příkaz.

Klávesové zkratky a aliasy příkazů

Některé příkazy podporují klávesové zkratky. Můžete například volat příkaz Delete pomocí příkazu nebo tf delete tf del.

Příklad

Představte si například příkaz Pokladna:

tf checkout [/lock:( none|checkin|checkout)] [/recursive] <item-spec> [/login: <username>, [<password>]]

Tento příklad obsahuje následující argumenty:

• <item-spec>: Tento argument musíte nahradit specifikací položky, která identifikuje položky, které si právě probíháte.
• Následující argumenty jsou volitelné. Pokud je nezadáte, žádný z jejich efektů se nevztahuje na příkaz:
  • /lock:(none|checkin|checkout): Pokud tuto možnost nezadáte /lock , použije systém /lock:none ve výchozím nastavení. V opačném případě můžete zadat jednu z dalších možností uzamčení.
  • /recursive: Pokud chcete rekurzivně rezervovat více položek ve složce, musíte zadat doslovné doslovné zadání této možnosti.
  • /login:<username>, <password>: Pokud chcete příkaz spustit jako jiný uživatel, musíte zadat /login doslovné znění možnosti a nahradit <username> názvem uživatele. V případě potřeby nahraďte <password> heslem uživatele.

Zadání položek ovlivněných příkazem

Specifikace položek a specifikace verzí můžete použít k určení položek, které jsou ovlivněny příkazem.

Určení ovlivněných položek pomocí argumentu specifikace položky

Specifikace položky slouží k určení položek ovlivněných příkazem. Položky můžete zadat na klientském počítači nebo na serveru Azure DevOps. Můžete použít zástupné znaky, například * a ?.

Argumenty specifikace položky klienta

Argument specifikace položky klienta určuje cestu k položkám na klientském počítači, například:

• Složka, například c:\code\SiteApp\Main\SolutionA\.
• Soubor, například c:\code\SiteApp\Main\SolutionA\Project1\program.cs.
• Například c:\code\SiteApp\Main\SolutionA\*.cs.
• Cesta UNC (Universal Naming Convention), například \\myshare\code\SiteApp\Main.

Argumenty specifikace položky serveru

Argument specifikace položky serveru určuje cestu k položkám na serveru Azure DevOps, například:

• Složka, například $/SiteApp/Main/SolutionA.
• Soubor, například $/SiteApp/Main/SolutionA/Project1/program.cs.
• Více souborů, například $/SiteApp/Main/SolutionA/*.cs.

Argumenty specifikace položky serveru obvykle používáte, když potřebujete spustit příkaz u položek, které nejsou na klientském počítači. Řekněme například, že pracujete na vývojovém počítači. Pokud potřebujete získat nějaká data historie revizí o některých položkách, které jsou v kolekci projektů, ve které nefungujete, můžete použít následující příkaz:

c:\>tf history /collection:https://fabrikam-3:8080/tfs/DefaultCollection
$/SiteApp/Main/SolutionA/Project1/* /recursive  
/noprompt 

Argumenty specifikace více položek

U některých příkazů můžete zadat více argumentů specifikace položek, například:

c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c

Tento příkaz zkontroluje program.cs a program2.c.

Určení ovlivněných verzí položek pomocí argumentu specifikace verze

Specifikace verze slouží k určení verze položek ovlivněných příkazem. Pokud chcete zadat specifikaci verze, můžete:

• Použijte například /version možnost /version:C44.

• Připojte specifikaci verze k specifikaci položky středníkem, program1.cs;C44například .

Když použijete příkaz Historie nebo příkaz Rozdíl, můžete určit rozsah verzí oddělením verzí vlnovkou, například:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2022~D4/24/2022

K určení specifikace verze použijte následující syntaxi:

Použití možností ke změně způsobu fungování příkazu

Pomocí některých běžných možností můžete upravit způsob fungování příkazu.

/noprompt Použití možnosti k potlačení požadavků na vstup dat a přesměrování výstupních dat

/noprompt Pomocí možnosti potlačit požadavky na vstup dat a přesměrovat výstupní data do okna příkazového řádku. Tato možnost může být užitečná, když potřebujete použít příkazy pro správu verzí ve skriptu, kde:

• Příkaz pokračuje bez zásahu uživatelem.
• Data jsou k dispozici pro skript k provádění operací, jako je analýza nebo zachytávání.

Když použijete tuto možnost, systém:

• Potlačí všechny požadavky na vstup:

  • V okně příkazového řádku nejsou kladeny otázky. Když například použijete příkaz Zpět s touto možností, systém nezobrazí výzvu k potvrzení, zda chcete vrátit změny zpět.
  • Okna a dialogová okna se nezobrazují. Tuto možnost můžete použít například pomocí příkazu Checkin. Systém nezobrazuje dialogové okno Vrátit se změnami, abyste potvrdili položky a přidružené pracovní položky. Místo toho systém kontroluje položky bez potvrzení.

• Přesměruje výstupní data na příkazový řádek. Tuto možnost můžete použít například s příkazem Historie. Data se zobrazí v okně příkazového řádku místo okna Historie.

/login Použití možnosti k zadání přihlašovacích údajů

/login Pomocí možnosti zadejte uživatelský účet serveru Azure DevOps, ve kterém se má spustit příkaz. Tato možnost může být užitečná, když pracujete na počítači jiného člena týmu.

Řekněme například, že pracujete na vývojovém počítači člena týmu. Pomocí příkazu Lock odemknete soubor, který jste předtím zamkli:

c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:<username>,<password>

Pokud se chcete vyhnout zobrazení hesla na příkazovém řádku, můžete příkaz zadat bez hesla:

c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:<username>

Po zadání tohoto příkazu vás systém vyzve k zadání hesla v dialogovém okně, které zamaskuje váš vstup.

/lock Použití nebo odebrání zámku

/lock Pomocí této možnosti můžete použít nebo odebrat zámek ve stejnou dobu, kdy spustíte jiný příkaz, například Přidat nebo Upravit.

/lock:(none|checkin|checkout)

Příkaz /lock používá následující možnosti:

• None: Na položku není umístěn žádný zámek. Pokud už je zámek na místě, odebere se.

• Checkin nebo Checkout: Je použit zámek. Další informace najdete v tématu Vysvětlení typů zámků.

Použití klávesových zkratek možností

Můžete zkrátit následující možnosti.

Vysvětlení ukončovací kódy

Příkazy správy verzí vrací následující ukončovací kódy:

Řekněme například, že spustíte následující příkaz:

c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c

Pokud některý ze souborů, které se pokoušíte rezervovat, na serveru neexistuje, příkaz vrátí hodnotu 1 , která značí částečný úspěch.