Přidání souborů na server

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

Přidání souboru do správy verzí je často automatické, když používáte Průzkumník řešení a váš projekt je pod správou verzí. V některých případech ale musíte provést další kroky pro přidání projektu do správy verzí.

Tip

Než přidáte soubory do správy verzí, měli byste nejprve nastavit pracovní prostor na vývojovém počítači.

Vytvoření nového projektu kódu a řešení v rámci správy verzí

Můžete současně vytvořit nový projekt a přidat ho do správy verzí, abyste vy a váš tým mohli okamžitě využívat všechny výhody správy verzí počínaje prvním řádkem kódu, který píšete.

New Project dialog box

  1. Pokud jste to ještě neudělali, připojte se v Visual Studio k projektu.

  2. Zvolte Soubor, Nový, Project (Klávesnice: Ctrl + Shift + N).

    Zobrazí se dialogové okno Nový projekt.

  3. Vyberte typ projektu kódu, který chcete vytvořit.

  4. Do pole Název zadejte název projektu kódu.

  5. Pokud se zobrazí seznam řešení , ujistěte se, že je vybrané vytvořit nové řešení .

  6. V seznamu umístění zadejte cestu k dobré místní pracovní složce (například c:\code\SiteApp\Main\) v pracovním prostoru, který jste vytvořili při nastavování vývojového počítače.

    Ujistěte se, že jsou zaškrtnutá políčka Vytvořit adresář pro řešení a přidat do správy zdrojového kódu .

  7. Zvolte OK a vytvořte projekt kódu, který můžete zobrazit v Průzkumník řešení (klávesnice: Ctrl + Alt + L).

    New Code Project in Solution Explorer

  8. V Průzkumník řešení otevřete místní nabídku řešení, které jste vytvořili nebo upravili, a pak zvolte Vrátit se změnami a odešlete čekající změny.

Umístění existujícího řešení a projektů kódu pod správu verzí

Pokud chcete přidat existující řešení do správy verzí, přesuňte všechny soubory řešení do pracovního prostoru a přidejte je.

Poznámka

Nepoužívejte dialogové okno Přidat řešení do správy zdrojového kódu k nahrání řešení do správy verzí. Místo toho použijte následující postup.

  1. Pokud jste to ještě neudělali, připojte se v Visual Studio k projektu.

  2. Zvolte Zobrazit, Další Windows, Průzkumník správy zdrojového kódu.

  3. V Průzkumníku správy zdrojového kódu přejděte do logické nadřazené složky pro vaše řešení, například $/SiteApp/Main, kde SiteApp je název vašeho projektu. Proč je to dobrá nadřazená složka?

  4. Výběrem odkazu vedle místní cesty otevřete nadřazenou složku v Průzkumníku Windows (Průzkumník souborů v Windows 8).

    Co mám dělat, když je text odkazu "Nenamapovaný"?

  5. Přesuňte složku, která obsahuje vaše řešení, do nadřazené složky.

  6. V Visual Studio zvolte Soubor, Otevřít, Project/Řešení a pak pomocí dialogového okna Otevřít Project otevřete řešení.

  7. V Průzkumník řešení (klávesnice: Ctrl + Alt + L), vyberte řešení, otevřete místní nabídku a pak zvolte Přidat řešení do správy zdrojového kódu.

  8. V Průzkumník řešení vyberte řešení, otevřete místní nabídku a pak zvolte Vrátit se změnami.

  9. V Team Exploreru se zobrazí stránka Čekající změny.

  10. Jsou v části Vyloučené změny zobrazené nějaké zjištěné položky?

    • Ne: Přejděte k dalšímu kroku.

    • Ano: Zvolte zjištěný odkaz. Zobrazí se dialogové okno Propagovat kandidátské změny . Na soubory uvedené v tomto dialogovém okně se v řešení neodkazují žádné projekty kódu. Pokud bude váš tým tyto soubory potřebovat, ujistěte se, že jsou vybrané, a pak zvolte Zvýšit úroveň a přesuňte je do části Zahrnuté změny na stránce Čekající změny . Další informace najdete v tématu Kontrola práce na základu kódu týmu.

  11. Až budete připraveni, odešlete čekající změny.

Přidání jednoho nebo více souborů do správy verzí

Když použijete Průzkumník řešení k přidání souboru do projektu kódu, systém ho automaticky přidá do správy verzí. Můžete ale také přidat soubory, na které nejsou odkazovány projekty kódu.

Tip

Pokud vytváříte automatizovaný proces nebo dáváte přednost používání příkazového řádku, můžete místo následujících postupů použít příkaz Přidat .

Automatické přidání jednoho nebo více souborů do správy verzí

Důležité

Tento postup platí jenom v případě, že používáte místní pracovní prostor. Soubory uložené při práci v pracovním prostoru serveru se přidají a vrátí se změnami, aniž by se v Team Exploreru zobrazovaly jako čekající změny.

Pokud používáte místní pracovní prostor, budou nové soubory automaticky zjištěny na stránce Čekající změny .

  1. Pokud jste to ještě neudělali, připojte se v Visual Studio k projektu.

  2. Zvolte Zobrazit, Další Windows, Průzkumník správy zdrojového kódu.

  3. V Průzkumníku správy zdrojového kódu přejděte do složky, do které chcete přidat soubory nebo složky.

  4. Výběrem odkazu vedle místní cesty otevřete cílovou složku v Průzkumníku Windows (Průzkumník souborů v Windows 8).

    Přesuňte soubory a složky do této složky.

    Co mám dělat, když je text odkazu "Nenamapovaný"?

  5. V Visual Studio v Team Exploreru zvolte Čekající změny.

  6. Na stránce Čekající změny v části Vyloučené změny vyberte odkaz Zjištěný .

  7. V dialogovém okně Upřednostnit změny kandidáta se ujistěte, že jsou zaškrtnuté jenom soubory, které chcete vrátit se změnami, a pak zvolte Zvýšit úroveň.

  8. Odešlete čekající změny.

Ruční přidání souborů do správy verzí

Soubory můžete také přidat do správy verzí ručně.

  1. Zvolte Zobrazit, Další Windows, Průzkumník správy zdrojového kódu.

  2. V Průzkumníku správy zdrojového kódu přejděte do složky, kam chcete umístit soubory.

Důležité

Než budete pokračovat, ujistěte se, že je tato složka vrácena se změnami. Pokud teď vytváříte složku, otevřete její místní nabídku a zvolte Vrátit se změnami a pak se přihlaste do nové složky, než budete pokračovat.

  1. Přetáhněte složky nebo soubory z průzkumníka Windows (nebo Průzkumník souborů) do složky v Průzkumníku správy zdrojového kódu.

  2. Po zobrazení dialogového okna Přidat do správy zdrojového kódu se ujistěte, že jsou vybrané všechny soubory, které chcete přidat, a pak zvolte Zahrnout položky.

  3. Zvolte Dokončit.

  4. V Team Exploreru se po zobrazení stránky Čekající změny ujistěte, že se binární soubory, které chcete přidat, zobrazí v části Zahrnuté změny. Zvolte Vrátit se změnami.

Využití binárních souborů třetích stran, které váš kód nevytvořuje

Mnoho týmů vyvíjí kód, který závisí na binárních souborech, které nejsou vytvořené řešením, ve kterém spravují svůj kód. Tyto binární soubory jsou obvykle součástí knihovny, na kterou má tým licenci třetí strany.

Někdy tyto binární soubory pocházejí z jiného týmu ve stejné společnosti. Tým A například závisí na binárních souborech vytvořených týmem B a každý tým musí z nějakého důvodu pracovat v různých kolekcích projektů. V důsledku toho tým B doručuje binární soubory týmu A, který je pak zkontroluje do správy verzí.

Tip

Pokud vaše vývojové počítače a agenti sestavení mají přístup k internetu, NuGet může váš tým usnadnit správu závislostí a udržování binárních souborů v aktualizovaném stavu. Balíčky můžete ukládat do TFS nebo Azure DevOps Services pomocí Azure Artifacts.

Struktura složek a pracovních prostorů, kterou byste měli použít k ukládání binárních souborů třetích stran, závisí na způsobu, jakým vaše řešení závisí na těchto knihovnách.

Přidání binárních souborů ve složce nebo struktuře větve

Pokud binární soubory třetích stran umístíte do stejné nadřazené složky, která obsahuje složky řešení, můžou všechny projekty kódu ve všech řešeních odkazovat na knihovny se stejnou relativní cestou.

Například tým používá tuto strukturu složek:

Library folder within the main parent folder
Každý projekt kódu pak může odkazovat na složku knihoven s následující relativní cestou: ../../Lib

Pokud později v projektu potřebuje váš tým izolovat samostatné úsilí, které vyžadují různé verze binárních souborů, můžete složku knihovny společně se složkou řešení rozvětvovat.

Například verze 1 aplikace využívá verzi 1 knihovny. Jako někteří vývojáři v týmu Pro přístup k datům pracují na další verzi, využívají verzi 2. Ostatní týmy ale ještě nejsou připravené k upgradu. Tento druh situace můžete spravovat pomocí větví.

Library folder within a branch structure

Mapování v binárních souborech pomocí pracovního prostoru

Některé společnosti musí spravovat složitější závislosti na knihovnách třetích stran. Například několik projektů obsahuje řešení s různými závislostmi na společné sadě knihoven. V takových případech můžete knihovny třetích stran ukládat do vyhrazeného projektu. Přispěvatelé na různé projekty mapují ve složkách, které obsahují knihovny, které potřebují.

Například FabrikamFiber vloží následující projekt, větev a strukturu složek na místě:

Libraries stored in a dedicated project

Raisa nastaví svůj vývojový počítač se dvěma pracovními prostory pro dvě různé úsilí, z nichž každá mapuje v knihovnách, které potřebuje:

Workspaces map in the libraries

Přizpůsobení souborů, které jsou ignorovány správou verzí

Ve výchozím nastavení jsou některé typy souborů (například soubory .dll) ignorovány správou verzí. Výsledek:

  • Když přidáte ignorované soubory do složek mapovaných v místním pracovním prostoru, nezobrazí se na stránce Čekající změny v Team Exploreru.

  • Když se pokusíte přidat ignorované soubory pomocí dialogového okna Přidat do správy zdrojového kódu (například přetažením do Průzkumníka správy zdrojového kódu), automaticky se zobrazí na kartě Vyloučené položky .

Typy souborů můžete nakonfigurovat tak, že umístíte textový soubor .tfignore do složky, kam chcete pravidla použít. Účinky souboru .tfignore jsou rekurzivní. V podsložkách však můžete vytvořit soubory .tfignore, které přepíší účinky souboru .tfignore v nadřazené složce.

Pravidla souborů .tfignore

Následující pravidla platí pro soubor .tfignore:

  • # zahájí řádek komentáře.

  • Podporují se zástupné * dokumentace a ? zástupné dokumentace.

  • Soubor filepec je rekurzivní, pokud není znakem předpona \ .

  • ! negates a filespec (soubory, které odpovídají vzoru, nejsou ignorovány)

Příklad souboru .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

Vytvoření a použití souboru .tfignore

I když můžete textový soubor .tfignore vytvořit ručně pomocí výše uvedených pravidel, můžete ho také automaticky vygenerovat, když stránka Čekající změny zjistila změnu.

Důležité

To platí jenom při použití místního pracovního prostoru. Soubory změněné při práci v pracovním prostoru serveru se vrátí se změnami, aniž by se zobrazovaly jako čekající změny v Team Exploreru.

Automatické vygenerování souboru .tfignore

  1. Na stránce Čekající změny v části Vyloučené změny vyberte odkaz Zjištěný .

    Zobrazí se dialogové okno Zvýšit úroveň změn kandidáta .

  2. Vyberte soubor, otevřete místní nabídku a zvolte Ignorovat tuto místní položku, Ignorovat podle přípony, Ignorovat podle názvu souboru nebo Ignorovat podle složky.

  3. Kliknutím na tlačítko OK nebo Storno zavřete dialogové okno Zvýšit úroveň změn kandidáta .

  4. Soubor .tfignore se zobrazí v části Zahrnuté změny na stránce Čekající změny . Tento soubor můžete otevřít a upravit tak, aby vyhovoval vašim potřebám.

Soubor .tfignore se automaticky přidá jako zahrnutá čekající změna, takže pravidla, která jste vytvořili, budou platit pro každého člena týmu, který soubor získá.

Práce z příkazového řádku

  • Přidejte na server Upload soubory z pracovního prostoru na vývojovém počítači.