Yapı işlemi şablonunuzu özelleştirme

Makale
06/10/2015

Yapı işleminizin varsayılan şablonunun yapabildiklerinden daha fazlasını yapmasına ihtiyacınız varsa, yapı işlemi şablonunu kendi Windows Workflow Foundation (WWF) yönergelerinizi uygulayacak şekilde özelleştirebilirsiniz.Yönergeleriniz CodeActivity nesnelerinde uygulanan .NET Framework kodu çalıştırabilir.Team Foundation Yapısı'nda (TFBuild) yerleşik olan üçüncü tarafların sunduğu veya gerekirse sizin tarafınızdan oluşturulmuş etkinlikleri çalıştırabilirsiniz.

İpucu
Özel yapı işleminin işlevi Windows toplu iş dosyası veya PowerShell betiğinde kodlanmış olabilir; komutunuzu yükleyebilir ve yapı işleminizin bir parçası olarak çalıştırabilirsiniz.Bu yaklaşım, özel bir yapı işlemi oluşturmaktan daha hızlı ve basit olabilir.Bkz. Yapı işleminizde betik çalıştırma.

Özel yapı işlemi çözümü başlatma ve şablon oluşturma
Yapı tanımınızda özel bir şablon kullanma
Sık sorulan soruların yanıtlarını alma

Özel yapı işlemi çözümü başlatma ve şablon oluşturma

Yönergelerinizi uygulamadan önce, Team Foundation sunucunuzdan varsayılan şablonun bir kopyasını ayıklayın ve Visual Basic kod projesine ekleyin.

Önemli
Git takım projesinde mi çalışıyorsunuz?Yapı işlemi etkinlik ikili dosyalarını karşıya yüklemeyi mi planlıyorsunuz?Bu durumda, ikili dosyaların (özellikle de büyük dosyalarda yapılan çok sayıda düzeltmenin) depolanması Git deponuzun boyutunu şişirebilir.Özel yapı işlemi ikili dosyalarınızı, uygulamanızı oluşturduğunuz kodda ayrı olan bir depoda depolamanızı öneririz.Yapı işlemleriniz için ayrı bir takım projesi oluşturabilir veya varolan takım projenizde ek bir depo oluşturabilirsiniz.

Git simgesi Git takım projesinde mi çalışıyorsunuz?Yapı işlemi etkinlik ikili dosyalarını karşıya yüklemeyi mi planlıyorsunuz?Bu durumda, ikili dosyaların (özellikle de büyük dosyalarda yapılan çok sayıda düzeltmenin) depolanması Git deponuzun boyutunu şişirebilir.Özel yapı işlemi ikili dosyalarınızı, uygulamanızı oluşturduğunuz kodda ayrı olan bir depoda depolamanızı öneririz.Yapı işlemleriniz için ayrı bir takım projesi oluşturabilir veya varolan takım projenizde ek bir depo oluşturabilirsiniz.

Yapı işlemi kaynağınızı depolamayı planladığınız yerde takım projesine (ve uygunsa Git deposuna) bağlanın (Klavye: Ctrl + 0, C).
Yeni bir kod projesi oluşturun (Klavye: Ctrl + Shift + N).

Özellikle, yeni bir Visual Basic iş akışı etkinlik kitaplığı kod projesini (örneğin, Şablonlar) içeren yeni bir çözüm (örneğin, BuildProcessSource) oluşturun.Çözümü, anlaşılabilir bir konumda sürüm denetimi altında yeni bir dizine ekleyin.

TFVC örneği: C:\Users\YourName\Source\Workspaces\FabrikamTFVC\BuildProcessTemplates\

Git örneği: C:\Users\YourName\Source\Repos\BuildProcesses\

Şablonumu düzenlemek için neden bir kod projesine ihtiyacım var?
Yapılar sayfasında (Klavye: Ctrl + 0, B), yapı tanımı oluşturun veya düzenleyin.
Varsayılan şablonun bir kopyasını indirin.Bu yordamda daha önce oluşturduğunuz kod projesini içeren aynı klasörde yeni şablonunuzu kaydetme

TFVC örneği: C:\Users\YourName\Source\Workspaces\FabrikamTFVC\BuildProcessTemplates\BuildProcessSource\Templates

Git örneği: C:\Users\YourName\Source\Repos\BuildProcesses\BuildProcessSource\Templates
Çözüm gezgininde (Klavye: Ctrl + Alt + L), şablonu Şablonlar projenize ekleyin.

Activity1.xaml dosyasına ihtiyacınız yoktur, bu nedenle isterseniz silebilirsiniz.
Şablonunuzun Yapı Eylemi özelliğini İçerik olarak ayarlama.
Şablonlar kod projenize aşağıdaki başvuruları ekleyin:
Bu başvuruları kod projesine nasıl ekleyebilirim?

Kod projesini kaydedin.
Şablonu iade ettikten ve çalıştırdıktan sonra çalıştığından emin olmak için "Merhaba Dünya!" iletisi uygulayın.Bunu yapmak için WriteBuildMessage etkinliğini iş akışınıza sürükleyin ve BuildMessageImportance özelliğini Microsoft.TeamFoundation.Build.Client.BuildMessageImportance.High olarak ayarlayın.
Şablonu kaydedin ve yeni çözümünüzü karşıya yükleyin. TFVC'deyseniz bekleyen değişiklikleri iade edin (Klavye: Ctrl + 0, P) veya Git'teyseniz kaydedin (Klavye Ctrl + 0, G) ve gönderin.

Yapı tanımınızda özel bir şablon kullanma

Yukarıda açıklandığı gibi takım projenize özel bir yapı işlemi şablonu yükledikten sonra, şablonu yapı tanımlarınızdan kullanabilirsiniz.

Yapılar sayfasında (Klavye: Ctrl + 0, B), yapı tanımı oluşturun veya düzenleyin.
Yapı tanımı İşlem sekmesinde, Ayrıntıları Göster'i ve ardından Yeni'yi seçin.
Yeni'yi seçtikten sonra:
- TFVC: Team Foundation Server'ınızda şablonunuzun yolunu yazın veya yola göz atın.
- Git: Geliştirme makinenizde şablonun yolunu yazın veya yola göz atın.
Şablonun yolunu belirttikten sonra, listeden seçebilirsiniz.
Yeni bir yapı tanımı oluşturuyorsanız, oluşturduğunuz çözümü seçin ve hazırlama konumunu ve ihtiyacınız olan diğer seçenekleri belirtin.Bkz. Yapı tanımı oluşturma veya düzenleme.İşlemi tamamladığınızda, yapı tanımını kaydedin.
Yapılar sayfasında (Klavye Ctrl + 0, B), yapıyı sıraya alın.
Yapı tamamlandıktan sonra, özelleştirilmiş iş akışınızın beklendiği gibi çalıştığını doğrulamak için sonuçları görüntüleyin.

Soru - Yanıt

S: İznim olmadığı için sistem tarafından engellendim.Nasıl izin alabilirim?

Y: Team Foundation Server izinleri

S: Şablonumu düzenlemek için neden bir kod projesine ihtiyacım var?

Y: Aşağıdaki nedenlerle bir kod içerisinden şablonları düzenleyebilirsiniz

Şablonu bir kod projesinin bağlamı dışından düzenlemeye çalıştığınızda sorunlar oluşabilir.
Yapı işlemi etkinliğinizi yapı işlemi şablonlarınızla aynı çözümde geliştirmezseniz sorunlar oluşabilir.Bu şekilde çalışarak, işlem şablonunuzda etkinliklerinizden birini kullanmanız gerektiğinde, etkinlik iş akışı tasarımcısı araç kutusunda kullanılabilir.Ancak, etkinliklerinizin kaynak kodunu yapı işlemi şablonlarınızı içeren projeden farklı bir kod projesinde tutmanız gerekir.Bkz. Özel yapı işlemi etkinlikleri kullanma ve geliştirme.

S: TFBuild iş akışı ile çalışmak için ihtiyacım olan başvuruları nasıl ekleyebilirim?

Y: Başvuruları eklemek için başvuru yöneticisini kullanın

Kod projesi başvurularını görüntüleyin ve başvuru yöneticisini açın.

Özel Şablon kod proje başvurularını

Referans Yöneticisi iletişim kutusu

C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\ReferenceAssemblies\v2.0 yoluna göz atın ve şunu seçip ekleyin:

İletişim kutusu başvurmak için dosyaları seçin

Referans Yöneticisi iletişim kutusu

S: Takım projeleri arasında bir şablonu paylaşabilir miyim?

Y: Evet.Bir şablonu birden fazla takım projesiyle kaydedebilirsiniz.Bu özellik, şablonunuzu içeren takım projesi koleksiyonundaki herhangi bir takım projesinde bir yapı işlemini paylaşabileceğiniz anlamına gelir.

S: Şablonumu değiştirirsem, kullandığım yapı tanımlarına ne olur?

Y: Şablonu değiştirmeniz gerekiyorsa, şablonda değişikliklerinizi tamamladıktan sonra şablonu temel alan tüm yapı tanımlarını düzeltmeyi ve gözden geçirmeyi planlamalısınız.Bunu yapmazsanız, yapı tanımlarınız başarısız olabilir veya beklenmedik bir şekilde çalışabilir.

S: Yapı işlemi şablonumu silersem ne olur?

Y: Yapı işlemi şablonunu silmeye karar verirseniz, önce şablonu temel alan tüm yapı tanımlarını bulduğunuzdan ve sildiğinizden emin olun.Şablonu sildiğinizde, şablonu temel alan kalan yapı tanımları artık çalışmaz.

S: Özel yapı işlemimde neler hatalara neden oluyor?

Y: Bazı hataların birkaç genel nedeni:

TF215097: Özel etkinliğinizin gerekli bir özniteliği eksikse veya özel etkinliklerinizi içeren şablonunuzda aynı kod projesini düzenlemeye çalışırsanız görünebilir.
MSBuild hata XC1014: Şablonunuzun Yapı Eylemini İçeriğe ayarlamazsanız görünebilir.

Yukarıdaki hatalardan birini alırsanız, yukarıdaki yordamlarda yer alan adımlardan birini atlamış olmadığınızdan emin olun.

Şu konuyu da yararlı bulabilirsiniz: Yapınızda sorunları tanılama.