Použití a vývoj aktivit vlastních procesů sestavení

Článek
06/10/2015

Po vytvoření šablony vlastního procesu sestavení můžete implementovat vlastní obchodní logiku pomocí pokynů pracovního postupu Windows a vestavěných aktivit Team Foundation Build (TFBuild).Pokud tyto nástroje nestačí, můžete použít aktivity třetích stran, nebo v případě potřeby implementovat do aktivity CodeActivity svůj vlastní kód rozhraní .NET Framework.

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í.

Vytvoření aktivity vlastního procesu sestavení
Úprava šablony procesu sestavení
Odeslání vlastního procesu sestavení
- Odeslání a povolení vlastního procesu sestavení v týmovému projektu TFVC
- Odeslání a povolení vlastního procesu sestavení v týmovém projektu Git
Povolení vlastního procesu sestavení
Spuštění sestavení
Dotazy a odpovědi

Vytvoření aktivity vlastního procesu sestavení

Důležité
Než začnete, získejte kopii šablony a vložte ji do projektu kódu.Pokud jste tak již neučinili, zde je postup, jak na to. Aktivitu procesu sestavení byste měli vyvíjet ve stejném řešení jako šablony procesu sestavení.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í.

Než začnete, získejte kopii šablony a vložte ji do projektu kódu.Pokud jste tak již neučinili, zde je postup, jak na to.

Aktivitu procesu sestavení byste měli vyvíjet ve stejném řešení jako šablony procesu sestavení.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í.

Přidejte nový projekt kódu jazyka C# nebo Visual Basic do řešení, které obsahuje projekt kódu šablony procesu sestavení.
Do nového projektu kódu přidejte následující odkazy:
- Microsoft.TeamFoundation.Build.Client.dll
- Microsoft.TeamFoundation.Build.Workflow.dll
Jak mohu přidat tyto odkazy do projektu kódu?

Uložte projekt kódu.
Přidejte do projektu novou aktivitu.

Implementujte aktivitu CodeActivity Například Hello.cs:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Activities;
using Microsoft.TeamFoundation.Build.Workflow.Activities;
using Microsoft.TeamFoundation.Build.Client;
using Microsoft.TeamFoundation.Build.Workflow.Tracking;

namespace BuildProcessSource
{
    // enable the build process template to load the activity
    [BuildActivity(HostEnvironmentOption.All)]
    // keep the internal activity operations from appearing in the log
    [ActivityTracking(ActivityTrackingOption.ActivityOnly)]
    public sealed class Hello : CodeActivity
    {
        // Define an activity input argument of type string
        public InArgument<string> SayHelloTo { get; set; }

        // If your activity returns a value, derive from CodeActivity<TResult>
        // and return the value from the Execute method.
        protected override void Execute(CodeActivityContext context)
        {
            // Obtain the runtime value of the Text input argument
            string text = context.GetValue(this.SayHelloTo);

            // Add our default value if we did not get one
            if (text == null || text == "")
            {
                text = "World";
            }

            // Write the message to the log
            context.TrackBuildWarning("Hello " + text, BuildMessageImportance.High);
        }
    }
}

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

Sestavte řešení v sadě Visual Studio (klávesnice: Ctrl+Shift+B).

Až budete hotovi, řešení by mělo vypadat podobně jako toto:

Příklad procesu řešení vlastní sestavení

Úprava šablony procesu sestavení

Z řešení upravte šablonu procesu sestavení tím, že do ní přetáhnete aktivity.Jakmile je aktivita přidána do šablony, nastavte její vlastnosti (klávesnice: F4).

Úprava šablony procesu sestavení z řešení

Po dokončení šablonu uložte.

Odeslání vlastního procesu sestavení

Než budete moci definovat sestavení, které používá šablonu vlastního procesu sestavení a aktivity sestavení, musíte je odeslat a povolit.

Odeslání a povolení vlastního procesu sestavení v týmovému projektu TFVC
Odeslání a povolení vlastního procesu sestavení v týmovém projektu Git

Odeslání vlastního procesu sestavení v týmovém projektu TFVC

V týmovém projektu TFVC Ikona TFVC :

Ujistěte se, že jste sestavili řešení (klávesnice: Ctrl+Shift+B).
Připojte se (klávesnice: Ctrl+0, C) k týmovému projektu, kam chcete uložit svůj zdroj procesu sestavení.
Z Průzkumníku správy zdrojového kódu přidejte položky do složky, která obsahuje projekt kódu aktivity.
Najděte složku obsahující soubor .dll a vyberte ji.Například C:\Users\YourName\Source\Workspaces\FabrikamTFVC\BuildProcessTemplates\BuildProcessSource\Source\bin\Debug.
Dokončete proces, čímž přidáte soubor:
Vraťte své změny.

Odeslání vlastního procesu sestavení v týmovém projektu Git

V týmovém projektu Git Ikona Git :

Důležité:
- Ukládání binárních souborů (zvláště mnoha revizí velkých souborů) může 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 tento účel, nebo můžete vytvořit další úložiště v existujícím týmovém projektu.
- Binární soubory je třeba ukládat do podsložky v úložišti Git.Pokud se pokusíte použít binární soubory v kořenové složce, můžete být zastaveni chybovou zprávou informující o tom, že větev git nebyla nalezena.
Ujistěte se, že jste sestavili řešení (klávesnice: Ctrl+Shift+B).
Připojte se (klávesnice: Ctrl+0, C) k týmovému projektu, kam chcete uložit svůj zdroj procesu sestavení.
Spusťte příkazový řádek Git.

D: Nemohu otevřít příkazový řádek. Co mohu udělat?O:Povolte příkazový řádek Git.

Přidejte soubor .dll pomocí příkazového řádku Git.Příklad:

cd c:\users\YourName\source\repos\BuildProcesses\BuildProcessSource\Source\bin\Debug

git add Source.dll -f

Potvrďte změny.
Synchronizujte nebo vložte do projektu své potvrzení.

Povolení vlastního procesu sestavení

Před spuštěním vlastního procesu sestavení musíte nasměrovat kontrolér sestavení na binární soubory, které jste odeslali na TFS, a vybrat šablonu procesu sestavení v definici sestavení.

Na stránce Sestavení (klávesnice: Ctrl+0, B) klikněte na možnost Akce a poté vyberte možnost Správa kontrolérů sestavení.
V dialogovém okně Správa kontrolérů sestavení zvýrazněte kontrolér, který budete používat pro tento proces sestavení, a pak zvolte možnost Vlastnosti.
Zadejte cestu správy verzí na vlastní sestavení.

Procházejte ke složce, která je nadřazena složce, kam jste odeslali proces sestavení ve výše uvedených krocích.
- Příklad TFVC: $/FabrikamTFVC/BuildProcessTemplates/BuildProcessSource/Source/bin/Debug
- Příklad Git: BuildProcessSource/Source/Bin/Debug
  
  Systém automaticky převede hodnotu, kterou zadáte do cesty vstfs.Například: vstfs:///Git/VersionedItem/FabrikamGit/BuildProcesses/master/BuildProcessSource/Source/Bin/Debug.
Pokud jste tak ještě neučinili, vytvořte nebo upravte definici sestavení a vyberte šablonu vlastního procesu sestavení.