Dostosowywanie szablonu procesu kompilacji
Jeśli użytkownik potrzebuje procesu kompilacji, który wykracza poza możliwości szablonu domyślnego, może dostosować szablon procesu kompilacji do własnych instrukcji w programie Windows Workflow Foundation (WWF).Instrukcje użytkownika może uruchomić kod .NET Framework, który zaimplementowano w obiektach CodeActivity.Można uruchomić działania, które są wbudowane w program Team Foundation Build (TFBuild), oferowane przez strony trzecie lub — w razie potrzeby — utworzone przez użytkownika.
![]() |
---|
Jeśli niestandardowe funkcje procesu kompilacji mogą być kodowane w pliku wsadowym systemu Windows lub skrypcie programu PowerShell, można załadować skrypt i uruchomić go jako część procesu kompilacji.Takie podejście może być prostsze i działać szybciej niż tworzenie niestandardowego procesu kompilacji.Zobacz Uruchamianie skryptu w procesie kompilacji. |
Uruchom niestandardowe rozwiązanie procesu kompilacji i utwórz szablon
Użyj niestandardowego szablonu w definicji kompilacji
Uzyskaj odpowiedzi na często zadawane pytania
Uruchom niestandardowe rozwiązanie procesu kompilacji i utwórz szablon
Przed zaimplementowaniem instrukcji wyodrębnij kopię szablonu domyślnego z serwera Team Foundation i dodaj go do projektu kodu języka Visual Basic.
![]() |
---|
Czy pracujesz nad |
Połącz się z (klawiatura: Ctrl + 0, C) projektem zespołowym (i, jeśli ma to zastosowanie, z
repozytorium Git), gdzie planujesz przechowywać źródło procesu kompilacji.
Utwórz nowy projekt kodu (klawiatura: Ctrl + Shift + N).
Dokładniej mówiąc, utwórz nowe rozwiązanie (na przykład BuildProcessSource) zawierające nowy projekt działania kodu biblioteki Visual Basic dla przepływu pracy (na przykład Szablony).Dodaj rozwiązanie do nowego katalogu pod kontrolą wersji w zrozumiałej lokalizacji.
Przykład TFVC: C:\Users\YourName\Source\Workspaces\FabrikamTFVC\BuildProcessTemplates\
Przykład Git: C:\Users\YourName\Source\Repos\BuildProcesses\
Dlaczego potrzebny jest projekt kodu, aby edytować szablon?
Na stronie kompilacji (klawiatura: Ctrl + 0, B) utwórz lub edytuj definicję kompilacji.
Pobierz kopię szablonu domyślnego.Zapisz nowy szablon w tym samym folderze, który zawiera projekt kodu utworzonego wcześniej w tej procedurze
Przykład TFVC: C:\Users\YourName\Source\Workspaces\FabrikamTFVC\BuildProcessTemplates\BuildProcessSource\Templates.
Przykład Git: C:\Users\YourName\Source\Repos\BuildProcesses\BuildProcessSource\Templates.
W Eksploratorze rozwiązań (klawiatura: Ctrl + Alt + L) dodaj szablon do projektu Szablony.
Nie jest potrzebny plik Activity1.xaml, więc można go usunąć.
Ustaw właściwość akcji szablonu zawartości.
Dodaj następujące odwołania do projektu kodu Szablony:
Jak dodać te odwołania do projektu kodu?
Zapisz projekt kodu.
Zaimplementuj komunikat "Hello World!", aby następnie go zaewidencjonować, uruchomić i zyskać pewność, że działa.W tym celu przeciągnij działanie WriteBuildMessage do przepływu pracy i ustaw jego właściwość BuildMessageImportance na wartość Microsoft.TeamFoundation.Build.Client.BuildMessageImportance.High.
Zapisz szablon, a następnie załaduj nowe rozwiązanie.Można też zaewidencjonować oczekujące zmiany w
TFVC (klawiatura: Ctrl + 0, P) lub zatwierdzić (klawiatura Ctrl + 0, G) i odesłać je, jeśli korzystasz z
Git.
Użyj niestandardowego szablonu w definicji kompilacji
Po przesłaniu niestandardowego szablonu procesu kompilacji do projektu zespołowego, jak wyjaśniono powyżej, można użyć szablonu ze swojej definicji kompilacji.
Na stronie kompilacji (klawiatura: Ctrl + 0, B) utwórz lub edytuj definicję kompilacji.
Na karcie definicji kompilacji Proces wybierz kolejno opcje
Pokaż szczegóły, a następnie Nowy.
Po wybraniu opcji Nowy:
TFVC: wpisz lub wyszukaj ścieżkę do szablonu programu Team Foundation Server.
Git: wpisz lub wyszukaj ścieżkę do szablonu na maszynie deweloperskiej.
Po określeniu ścieżki do szablonu można wybrać go z listy.
Jeśli tworzysz nową definicję kompilacji, wybierz tworzone rozwiązanie i określ tymczasową lokalizację oraz inne potrzebne opcje.Zobacz Tworzenie lub edycja definicji kompilacji.Po zakończeniu zapisz definicję kompilacji.
Na stronie kompilacji (klawiatura: Ctrl + 0, B) zakolejkuj kompilację.
Po zakończeniu kompilacji przejrzyj wyniki, aby zweryfikować przepływ pracy dostosowany zgodnie z oczekiwaniami.
Pytania i odpowiedzi
Pyt.: System zablokował mnie, ponieważ nie mam uprawnień.Jak sobie z tym poradzić?
Odp.: Uprawnienia serwera programu Team Foundation Server
Pyt.: Dlaczego potrzebny jest projekt kodu, aby edytować szablon?
Odp.: Należy edytować szablony z projektu kodu, ponieważ
mogą wystąpić problemy podczas próby edytowania szablonu poza kontekstem projektu kodu.
Jeśli nie opracowywano działania procesu kompilacji w tym samym rozwiązaniu, co szablonów procesu kompilacji, mogą wystąpić problemy.Gdy pracuje się w ten sposób, gdy trzeba użyć jednego z działań w szablonie procesu, jest ono dostępne w przyborniku projektanta przepływu pracy.Należy jednak zachować kod źródłowy swoich działań w projekcie osobnego kodu niż ten, który zawiera szablony procesu kompilacji.Zobacz Używanie i opracowywanie czynności niestandardowego procesu kompilacji.
Pyt.: Jak dodać odwołania, które są potrzebne do pracy z przepływem pracy w programie TFBuild?
Odp.: Użyj Menadżera odwołań, aby dodać odwołania do
Wyświetl odwołania do projektu kodu i otwórz Menadżera odwołań.
Przejdź do C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\ReferenceAssemblies\v2.0, a następnie wybierz i dodaj:
Pyt.: Czy w projektach zespołowych można udostępnić szablon?
Odp. Tak.Można zarejestrować szablon dla więcej niż jednego projektu zespołowego.Oznacza to, że można dzielić proces kompilacji pomiędzy dowolnymi projektami zespołowymi w obrębie kolekcji projektów zespołowych, która zawiera ten szablon.
Pyt.: Jeśli zmodyfikuję szablon, co stanie się z definicjami kompilacji, które go używają?
A: Jeśli trzeba zmodyfikować szablon, należy zaplanować przegląd wszystkich definicji kompilacji opartych na tym szablonie. Trzeba też poprawić je, po zakończeniu wprowadzania zmian w szablonie.Jeśli użytkownik nie wykona tych czynności, definicje kompilacji mogą nie działać poprawnie lub działać w sposób nieoczekiwany.
Pyt.: Co się stanie, jeśli usunę mój szablon procesu kompilacji?
Odp.: Jeśli zdecydujesz się usunąć szablon procesu kompilacji, najpierw zlokalizuj i usuń wszystkie definicje kompilacji oparte na tym szablonie.Po usunięciu szablonu nie będą działać żadne pozostałe definicje kompilacji oparte na tym szablonie.
Pyt.: Co jest przyczyną błędów w moim niestandardowym procesie kompilacji?
Odp.: Kilka najczęstszych przyczyn niektórych błędów:
TF215097: Może się pojawić, jeśli działanie niestandardowe nie ma wymaganego atrybutu lub w przypadku próby edytowania szablonu w tym samym projekcie kodu, który zawiera działania niestandardowe.
Błąd programu MSBuild XC1014: może się pojawić, jeśli nie ustawisz Akcji kompilacji swojego szablonu dla zawartości.
Jeśli zostanie wyświetlony jeden z powyższych błędów, należy się upewnić, czy nie pominięto żadnego z kroków powyższych procedur.
Użytkownik może również znaleźć pomocne informacje w następującym temacie: Diagnozowanie problemów Twojej kompilacji.
Pyt.: Co to jest Windows Workflow Foundation?Jak z tego korzystać?
A:Windows Workflow Foundation.
Pyt.: Jak uzyskać dane zmiennej środowiskowej?
Odp.:Użyj danych środowiskowych z procesu kompilacji niestandardowej
Pyt.: Gdzie można dowiedzieć się więcej o wbudowanych działaniach?
Odp.:Team Foundation Build — działania
Co należy zrobić, jeśli wbudowane działania nie odpowiadają moim potrzebom?
Odp.:Opracuj własne niestandardowe działania procesu kompilacji.
Pyt.: Gdzie można uzyskać szablony, działania przepływu pracy i skrypty?
A:Community TFS Build Extensions
Pyt.: Gdzie można dowiedzieć się więcej o tworzeniu niestandardowych procesów kompilacji?
A:Curated answer: Customize your Team Foundation Build process