Přizpůsobení šablony procesu sestavení

  • Článek

Pokud potřebujete, aby toho proces sestavení dokázal více, než nabízí výchozí šablona, můžete šablonu procesu sestavení přizpůsobit, aby plnila vaše vlastní pokyny Windows Workflow Foundation (WWF).Vaše pokyny mohou spustit kód rozhraní .NET Framework, který je implementován do objektů CodeActivity.Je možné spouštět činnosti, jež jsou součástí nástroje Team Foundation Build (TFBuild), které jsou nabízeny třetími stranami nebo které jste v případě potřeby sestavili sami.

Tip

Pokud je vaši vlastní funkci sestavení procesu možné zakódovat do dávkového souboru systému Windows nebo skriptu prostředí PowerShell, můžete nahrát skript a spustit jej jako součást procesu sestavení.Tento přístup může být rychlejší a jednodušší než vytvoření vlastního procesu sestavení.Další informace naleznete v tématu Spuštění skriptu v procesu sestavení.

  • Spuštění řešení vlastního procesu sestavení a vytvoření šablony

  • Použití vlastní šablony v definici sestavení

  • Získání odpovědí na časté otázky

Spuštění řešení vlastního procesu sestavení a vytvoření šablony

Před implementací pokynů extrahujte kopii výchozí šablony ze serveru Team Foundation a přidejte ji do projektu kódu Visual Basic.

Důležitá poznámkaDůležité

Pracujete v Ikona Gitprojektu týmu Git?Plánujete odeslat binární soubory aktivity procesu sestavení?Pokud ano, může ukládání binárních souborů (zvláště mnoha revizí velkých souborů) výrazně navýšit velikost úložiště Git.Doporučujeme uložit binární soubory vašeho vlastního procesu sestavení do úložiště, které leží samostatně od kódu, ze kterého sestavujete aplikaci.Můžete buď vytvořit samostatný týmový projekt pro svoje procesy sestavení, nebo můžete vytvořit další úložiště v existujícím týmovém projektu.

  1. Připojte se (klávesnice: Ctrl+0, C) k týmovému projektu (a v případě potřeby k úložišti Git Ikona Git), kam chcete uložit svůj zdroj procesu sestavení.

  2. Vytvořte nový projekt kódu (klávesnice: CTRL+SHIFT+N).

    Konkrétně vytvořte nové řešení (například BuildProcessSource) obsahující nový projekt kódu knihovny aktivit pracovního postupu Visual Basic (například Šablony).Přidejte řešení do nového adresáře pod správou verzí ve srozumitelném umístění.

    Ikona TFVC Příklad TFVC: C:\Users\YourName\Source\Workspaces\FabrikamTFVC\BuildProcessTemplates\

    Ikona Git Příklad Git: C:\Users\YourName\Source\Repos\BuildProcesses\

    Vytvořte projekt kódu tak, aby obsahovala nová šablona

    Proč k úpravě vlastní šablony potřebuji projekt kódu?

  3. Na stránce sestavení (klávesnice: Ctrl+0, B) vytvořte nebo upravte definici sestavení.

    Novou definici sestavení nebo úprava definice sestavení

  4. Stáhněte kopii výchozí šablony.Uložení vaší nové šablony do stejné složky, jež obsahuje projekt kódu, který jste vytvořili dříve v tomto postupu

    Ikona TFVC Příklad TFVC: C:\Users\YourName\Source\Workspaces\FabrikamTFVC\BuildProcessTemplates\BuildProcessSource\Templates

    Ikona Git Příklad Git: C:\Users\YourName\Source\Repos\BuildProcesses\BuildProcessSource\Templates

    Stáhněte si odkaz na kartě procesu definice sestavení

    Dialogové okno Uložit jako

  5. V průzkumníku řešení (klávesnice: Ctrl+Alt+L) přidejte šablonu do svého projektu Šablony.

    Do projektu přidat soubor šablony procesu sestavení

    Existující položku dialogové okno Přidat

    Soubor Activity1.xaml nepotřebujete, proto pokud chcete, můžete jej odstranit.

  6. Nastavte vlastnost Akce sestavení šablony na hodnotu Obsah.

    Nastavit akci sestavení s obsahem

  7. Do projektu kódu Šablony přidejte následující odkazy:

    Jak mohu přidat tyto odkazy do projektu kódu?

    Uložte projekt kódu.

  8. Implementujte zprávu „Hello World!“, abyste si po provedení vrácení se změnami a spuštění šablony mohli být jisti, že bude fungovat.Přetáhněte aktivitu WriteBuildMessage do svého pracovního postupu a nastavte její vlastnost BuildMessageImportance na hodnotu Microsoft.TeamFoundation.Build.Client.BuildMessageImportance.High.

    Přidaná aktivita WriteBuildMessage do šablony

  9. Uložte šablonu a odešlete nové řešení.Buď vraťte čekající změny, pokud jste v prostředí TFVC Ikona TFVC (klávesnice: Ctrl+0, P), nebo je potvrďte (klávesnice Ctrl+0, G) a posuňte, pokud jste v prostředí Git Ikona Git.

    Ukládání změn TFVC nebo Git

Použití vlastní šablony v definici sestavení

Po odeslání šablony vlastního procesu sestavení svého týmového projektu, jak je vysvětleno výše, můžete použít šablonu z definic sestavení.

  1. Na stránce sestavení (klávesnice: Ctrl+0, B) vytvořte nebo upravte definici sestavení.

  2. Na kartě Proces definice sestavení vyberte volbu Zobrazit podrobnostiZobrazit podrobnosti a poté klikněte na položku Nový.

    Vytvoření definice, proces karty, tlačítko Nová.

  3. Po zvolení možnosti Nový:

    • TFVC: Zadejte šablonu nebo procházejte k cestě k šabloně na serveru Team Foundation Server.

    • Git: Zadejte šablonu nebo procházejte k cestě k šabloně na vývojářském počítači.

  4. Poté, co zadáte cestu k šabloně, ji můžete vybrat ze seznamu.

    CustomTemplate vybraného v definici sestavení

  5. Při vytváření nové definice sestavení vyberte sestavované řešení a zadejte pracovní místo i jakékoli další potřebné možnosti.Další informace naleznete v tématu Vytvoření nebo úprava definice sestavení.Po dokončení svoji definici sestavení uložte.

  6. Na stránce sestavení (klávesnice Ctrl+0, B) vložte sestavení do fronty.

    Řazení do fronty sestavení ze stránky sestavení

  7. Po dokončení sestavení zobrazte výsledky, abyste si ověřili, že váš vlastní pracovní postup proběhl podle očekávání.

    Zobrazí se v protokolu sestavení zpráva "Hello World!"

Dotazy a odpovědi

D: Systém mě zablokoval, protože nemám oprávnění.Jak je mohu získat?

O: Oprávnění v prostředí Team Foundation Server

D: Proč k úpravě vlastní šablony potřebuji projekt kódu?

O: Šablony byste měli upravovat v rámci projektu kódu, protože

  • Při pokusu upravit šablonu mimo kontext projektu kódu může dojít k problémům.

  • Pokud nevyvíjíte aktivitu procesu sestavení ve stejném řešení jako šablony procesu sestavení, může dojít k problémům.Pokud je třeba použít některou z aktivit v šabloně procesu, je aktivita k dispozici v panelu nástrojů návrháře postupu provádění.Zdrojový kód však musíte pro aktivity ponechat v projektu kódu, který je oddělen od projektu kódu obsahujícího šablony procesu sestavení.Další informace naleznete v tématu Použití a vývoj aktivit vlastních procesů sestavení.

D: Jak lze přidat odkazy potřebné pro práci s pracovním postupem TFBuild?

O: Používejte správce odkazů pro přidávání odkazů na

Zobrazte odkazy na projekty kódů a otevřete správce odkazů.

Odkazy na projekt kódu vlastní šablonu

Dialogové okno Správce referenční informace

Procházejte k umístění C:\Program Files (x 86) \Microsoft Visual Studio 12.0\Common7\IDE\ReferenceAssemblies\v2.0 a potom vyberte a přidejte:

Vyberte soubory, které odkazují na dialogové okno

Dialogové okno Správce referenční informace

D: Lze sdílet šablony napříč týmovými projekty?

O: Ano.Šablonu lze zaregistrovat ve více týmových projektech.Tato možnost znamená, že proces sestavení lze sdílet ve všech týmových projektech v kolekci týmových projektů obsahující tuto šablonu.

D: Pokud upravím svoji šablonu, co se stane s definicemi sestavení, které ji používají?

O: Pokud potřebujete upravit šablonu, měli byste naplánovat přezkoumání všech definic sestavení, které jsou na této šabloně založeny, a po dokončení změn v šabloně je opravit.Pokud to neprovedete, vaše definice sestavení mohou selhat nebo se chovat neočekávaným způsobem.

D: Co se stane, když odstraním svou šablonu procesu sestavení?

O: Pokud se rozhodnete odstranit šablonu procesu sestavení, nejprve se přesvědčte, že jste vyhledali a odstranili všechny definice sestavení, které jsou na této šabloně založeny.Po odstranění šablony nebudou zbývající definice sestavení založené na této šabloně dále fungovat.

D: Co je příčinou chyb v mém vlastním procesu sestavení?

O: Několik běžných příčin některých chyb:

  • TF215097: Může se zobrazit, pokud vaší vlastní aktivitě chybí požadovaný atribut, nebo pokud se pokusíte upravit šablonu v rámci jednoho projektu kódu, který obsahuje vaše vlastní aktivity.

  • Chyba nástroje MSBuild XC1014: Může se zobrazit, pokud nenastavíte položku Akce sestavení šablony na hodnotu Obsah.

Pokud se zobrazí jedna z výše uvedených chyb, zkontrolujte, zda jste nevynechali některý z kroků ve výše uvedených postupech.

Možná budete považovat za užitečné také toto téma: Diagnostika problémů v sestavení.

D: Co je to Windows Workflow Foundation?Jak jej mohu využít?

A:Windows Workflow Foundation.

D: Jak lze získat data proměnných prostředí?

O:Použití dat prostředí z vlastního procesu sestavení

D: Kde se dozvím další informace o vestavěných aktivitách?

O:Aktivity sestavení Team Foundation

Co mám dělat, pokud vestavěné aktivity nevyhovují mým potřebám?

O:Vývoj vlastních aktivit procesu sestavení.

D: Kde lze získat šablony, aktivity pracovního postupu a skripty?

A:Community TFS Build Extensions

D: Kde se dozvím další informace o vývoji vlastních procesů sestavení?

A:Curated answer: Customize your Team Foundation Build process