Yapı işlemi için Varsayılan Şablonu kullanma

Varsayılan Şablon ( TfvcTemplate.12.xaml veya GitTemplate.12.xaml) kodunuzu oluşturan ve test eden temel bir işlemi hızlı şekilde tanımlamanızı sağlar.Team Foundation Build (TFBuild) uygulamasının kodunuzu oluşturma, testlerinizi çalıştırma ve betikler gibi diğer işlemleri çalıştırma şeklini denetleme seçeneklerini kullanabilirsiniz.

Başlarken

1. (İsteğe bağlı) Yeni bir yapı tanımı oluşturmadan önce, Takım Gezgini Ana sayfasından (Klavye: Ctrl + 0, H) oluşturmak istediğiniz çözümü açarak Projeler kutusunda otomatik olarak oluşturulmasını sağlayın.

2. Takım Gezgini'nde, takım projesine bağlandığınızdan emin olun (Klavye: Ctrl + 0, C) ve Yapılar sayfasını açın (Klavye: Ctrl + 0, B).

3. Yeni Yapı Tanımı bağlantısını seçin veya bir yapı seçin, bağlam menüsünü açın ve Yapı Tanımını Düzenle'yi seçin.

   İpucu
   Bir TF225001 hata iletisi görünürse, bir yapı denetleyicisini yapılandırın.

4. İşlem sekmesi üzerinde ve Yapı işlemi şablonu altında, Varsayılan Şablon varsayılan olarak seçilidir.

   

   Uyarı
   Bağlı olduğunuz bir Git takım projesi barındırılmasına Visual Studio Online?Kullanıma almayı geçersiz kılma ve Projeler parametreleri sizde yok mu? Bkz. Visual Studio Online'da doğru varsayılan Git yapısı işlem şablonunu kullandığımdan nasıl emin olabilirim?

5. Bu yapı tanımına yerleştirmek istediğiniz işlevi sağlayan alanları tamamlamak için bu konunun ilerleyen bölümlerindeki bilgileri kullanın.

6. İşlem sekmesindeki alanları doldurduktan sonra, diğer sekmelerdeki yapı işlemi seçeneklerini belirtin.

   Daha fazla bilgi için bkz. Yapı tanımı oluşturma veya düzenleme.

Şimdi ne yapmak istiyorsunuz?

• Kodunuzu alma

• Kodunuzu oluşturma

  • Oluşturulacak projeleri belirtme

  • Oluşturmak istediğiniz platform ve yapılandırmaları belirtme

  • Yapı seçeneklerini belirtme

• Kodunuzu test etme ve testin etkisini çözümleme

• Yapı sırasında diğer işlemleri çalıştırma

  • Yapı sırasında kod analizi gerçekleştirme

  • Çalıştırma ve verileri betiklere ve programlara geçirme

• Sunucuların yapınızı nasıl çalıştırdığını denetleme

  • Hangi aracıların yapınızı işlediğini belirtme

  • Yapı aracısı zaman sınırları belirtme

• Yapı sonucunu denetleme

  • Yapı çıkış konumunu belirtme

  • Tamamlanan yapıların adlarını takımınız için kullanışlı hale getirme

  • Yapıdan simgeler yayımlama

  • İş öğelerini ilişkilendirme ve oluşturma

  • Başarısızlık durumunda iş öğesi oluşturma

  • Kaynak kodunuzu etiketleme

• Sık sorulan soruların yanıtlarını alma

Kodunuzu alma

Kaynak Ayarları sekmesinde belirttiğiniz kaynak kodunu yapı aracısının nasıl alacağına ilişkin bazı seçenekler ayarlayabilirsiniz.

Amacınız şu ise…	Bu parametreyi ayarlayın…	Bu kılavuzu kullanarak…
Yapıyı yürütmeden önce yapı aracısındaki çalışma alanının veya Git deponuzun temizlenip temizlenmeyeceğini belirtme	TFVC: Çalışma alanını temizle Git: Depoyu temizle	Yapı işlenmeden önce tüm çıkışları ve kaynak kodu dosyalarını silmek için True öğesini seçin.Derleme işleminizin, yapı işleminizde sorunlara maruz kalırken mümkün olduğunca ayrıntılı olmasını istiyorsanız bunu kullanın. İpucu Yapı işleminiz için temiz çalışma alanı veya depo gerekmiyorsa, bu parametre değerini False olarak ayarlayarak yapıyı çalıştırmak için gereken zamanı önemli ölçüde azaltabilirsiniz. Bu ayar kullanırsanız, herhangi bir etkisi olmaz barındırılan yapı denetleyicisi.Bu durumda, her yapıyla birlikte yeni bir çalışma dizininiz olur.
Kaynak kodunuzun belirli bir sürümünü oluşturma	TFVC: Sürümü al Git: Kullanıma almayı geçersiz kıl	TFVC: Oluşturmak istediğiniz sürümü tanımlayan versionspec'i belirtin. Git: Kullanıma almak için dalı belirtin veya kimliği kaydedin.

Kodunuzu oluşturma

Kodunuzu derlemek için MSBuild kullanabilirsiniz.

Oluşturulacak projeleri belirtme

Yapı altındaki Projeler kutusunda Yapı işlemi parametreleri tablosunda, oluşturulacak bir veya daha fazla çözüm ya da kod belirtebilirsiniz.En az bir çözüm ya da proje belirtmeniz gerekir.

Birkaç ilgili proje oluşturuyorsanız, her projeyi ayrı ayrı listelemek yerine onları tek bir çözüme eklemeniz ve Projeler hücresi içindeki çözümü belirtmeniz gerekir.

Projeler kutusunda oluşturulacak çözümleri veya projeleri belirtmek üzere Çözümler/Projeler iletişim kutusunu açmak için üç nokta düğmesini (...) seçebilirsiniz.

Bir TFVC projesi için Projeler kutusunu el ile doldurmak istiyorsanız, oluşturmak istediğiniz her proje ya da çözüme tam sürüm denetim yolu belirtin.Aşağıdaki örnekte gösterildiği gibi her değeri bir virgül ile sınırlandırın:

$/Features/FeatureA/Server/All Server Projects.sln, $/Features/FeatureA/Client/All Client Projects.sln

Önemli
TFVC kullanıyorsanız, her proje ya da çözüm yolunun yapı tanımının Kaynak Ayarları sekmesinde listelenmiş Kaynak Denetimi Klasörü değerlerinden birinin alt birimi olduğundan emin olun.Git kullanıyorsanız, proje veya çözümün Git deponuzda, oluşturduğunuz bir dalda olduğundan emin olun.

Oluşturmak istediğiniz platform ve yapılandırmaları belirtme

Yapılandırmalar kutusunda, oluşturmak istediğiniz platform ve yapılandırmaları belirtebilirsiniz.Örneğin, bu kutuya Release|x86 ekleyerek bu yapının yalnızca C++ projenizin 32 bit sürümünün sürüm yapılandırmasını oluşturması gerektiğini belirtebilirsiniz.

İpucu
Büyük bir kod tabanına sahipseniz, yalnızca yapılandırmaları ve gereksinim duyduğunuz platformları oluşturarak yapının işlenme hızını önemli ölçüde artırabilirsiniz.

Yapılandırmalar kutusunu boş bırakırsanız, varsayılan yapılandırma ve her çözüm ya da projede tanımlanan platform oluşturulur.

Yapılandırmalar kutusunda, hangi öğelerin oluşturulacağını belirtmek üzere Yapılandırmalar iletişim kutusunu açıp kullanmak için üç nokta düğmesini (...) seçebilirsiniz.Ayrıca bunları el ile de belirtebilirsiniz.

Yapılandırmalar kutusundaki her yapılandırma aşağıdaki biçimde olmalıdır:

Yapılandırma|Platform

Aşağıdaki yer tutucuları değiştirmeniz gerekir:

• Yapılandırma hata ayıklama, sürüm veya tüm yapılandırmaları gibi bir değer.

• Platform Win32, x 86, x 64 veya herhangi bir CPU gibi bir değer.

Listedeki yapılandırmalar virgülle ayrılmalıdır.

Örneğin, C# projenizin Hata Ayıklama ve Sürüm yapılandırmasını oluşturmak isteseydiniz, Yapılandırmalar kutusunda Hata Ayıklama|Herhangi bir CPU, Yayın|Herhangi bir CPU öğelerini belirtebilirdiniz.

Yapılandırma ve platform için kullandığınız simgelerin, çözüm özellikleri ya da kod proje özelliklerinizde ayarlanmış olan belirteçlerle eşleşmesi gerekir.Eşleşmiyorlarsa, yapınız tamamlandığında beklenmedik sonuçlarla karşılaşabilirsiniz.

[!NOT]

Çözüm dosyası yerine ayrı kod projeleri oluşturuyorsanız ve platform olarak Herhangi Bir CPU'yu belirtmek istiyorsanız, bunu Herhangi Bir CPU yerine AnyCPU olarak belirtmeniz gerekir.

Yapı seçeneklerini belirtme

Çeşitli yapı seçeneklerini denetleyebilirsiniz.

Amacınız şu ise…	Bu parametreyi ayarlayın…	Bu kılavuzu kullanarak…
Yeniden oluşturma yapılıp yapılmayacağını denetleme	Yapı, Temiz yapı	Kod projelerindeki tüm kodu yeniden oluşturmak istiyorsanız True olarak ayarlayın.Bu, MSBuild/target:clean ile eşdeğerdir.Ayrıca Depoyu temizle'yi False olarak ayarlamadığınız sürece bu seçeneğin pratik etkisi yoktur. İpucu Bu seçeneği False'a ayarlayarak, geniş kod tabanları oluşturmak için gereken zamanı önemli ölçüde kısaltabilirsiniz.
Kodunuzu katman diyagramlarına karşı doğrulama	Yapı, Gelişmiş, MSBuild Bağımsız Değişkenleri	Sıradaki dizeyi şu parametre değerine ekleyin: /p:ValidateArchitecture=true. Daha fazla bilgi için bkz. Katman Diyagramları ile Kodu Doğrulama.
MS Build'e geçirilecek komut satırı bağımsız değişkenlerini belirtme	Yapı, Gelişmiş, MSBuild Bağımsız Değişkenleri	Yapı işleminiz bağımsız değişkenleri MSBuild'e geçirmenizi gerektiriyorsa, bunları MSBuild Bağımsız Değişkenleri parametresine girin.Daha fazla bilgi için bkz. MSBuild Komut Satırı Başvurusu.
Yapınızı işlemek için kullanılan MSBuild sürümünün bit genişliğini belirtme	Yapı, Gelişmiş, MSBuild Platformu	Aşağıdaki değerlerden birini belirtin: MSBuild'i yapı aracısına yüklenmiş Team Foundation Yapı Hizmeti öğesiyle aynı CPU bit genişliğinde çalıştırmak istiyorsanız Otomatik'i belirtin. Bu yapıyı her zaman MSBuild'in 32 bit sürümünü kullanarak işlemek istiyorsanız, X86 seçeneğini belirtin. Visual Studio 32 bitlik bir uygulama olarak çalıştığı için yapınız Team Foundation Yapı Hizmetiöğesinin 64 bit sürümünü çalıştıran yapı aracısı tarafından işletildiğinde sorunlarla karşılaşabilirsiniz.Bu tür sorunları, X86 seçeneğini belirterek giderebilirsiniz. Bu değeri belirtirseniz, yapınızın 64 bit yapı makinesi tarafından barındırılan yapı aracısı tarafından işlendiğinden emin olmanız gerekir (örneğin, bu konunun önceki kısımlarında açıklandığı gibi bir etiket kullanarak).Aksi takdirde, yapınız başarısız olur.

Diğer işlemleri çalıştırma

Yapı sırasında diğer işlemleri çalıştırabilirsiniz.

Kod analizini gerçekleştirme

Oluşturma sırasında yaygın hataları bulmak için kodunuzu çözümleyebilirsiniz.Gelişmiş yapı parametrelerindeki Kod analizini gerçekleştirin parametresini ayarlayın.

• Bu özelliğin etkinleştirildiği her kod projesini analiz etmek için Yapılandırıldığı Gibi'yi seçin.

• Kod projesinde bu özelliğin etkin olup olmadığından bağımsız olarak her kod projesini analiz etmek için Her Zaman öğesini seçin.

• Kod analizini atlamak için Hiçbir Zaman öğesini seçin.

Daha fazla bilgi için aşağıdaki konulardan birine bakın:

• Nasıl yapılır: C/C++ Projeleri için Kod Analizi Özelliklerini Ayarlama

• Nasıl yapılır: Yönetilen Kod Projesi İçin Kod Analizini Yapılandırma

• Nasıl yapılır: Bir ASP.NET Web Uygulaması İçin Kod Analizini Yapılandırma

Sunucuların yapınızı nasıl çalıştırdığını denetleme

Yapı sunucularının yapınızı nasıl çalıştıracağını denetleyebilirsiniz

Hangi aracıların yapınızı işlediğini belirtme

Hangi yapı aracılarının yapınızı işlemek için kullanıldığını belirtmek için Gelişmiş düğümünü genişletin, Aracı Ayarları düğümünü genişletin ve ardından aşağıdaki parametreler için değerler belirtin:

• Ad Filtresi: Bu alanda aracının adını yazarak bu yapı tanımını işlemek için kullanılan yapı aracılarına filtre uygulayabilirsiniz.* ve ? joker karakterlerini kullanarak da adlar kümesi belirtebilirsiniz.Örneğin, adı CI* karakterleriyle başlayan herhangi bir aracıyı belirtmek için CI belirtebilirsiniz.Bu ölçütü içeren aracılar CI, CI1 ya da CI_Agent2'yi içerir.

• Etiket Filtresi: Yalnızca eşleşen etiketler içeren yapı aracılarının bu yapıyı yürüteceğinden emin olmak için bir ya da daha fazla etiket belirtin.Özel durumlar için yapı aracılarını ayırmak amacıyla genellikle etiketleri belirli yapı aracılarına uygularsınız.Örneğin, yapı aracısını geçitli iade yapılarınızı işlemek için tasarlanmış yapı makinesinde ayarlarsınız.Bu yapı aracısıyla geçitli olan etiketi uygularsınız.Son olarak geçitli etiketi, yalnızca geçitli etiketle etiketlenmiş aracı tarafından işlenmesi için yapı aracısına uygularsınız.Etiket belirtmek için üç nokta düğmesini (...) seçin.

  [!NOT]

  Bu yapıyı işlemek için uygun olan yapı aracılarının havuzu, bu yapı tanımı için belirtmiş olduğunuz yapı denetleyicisi tarafından belirlenir.Yapı denetleyicisini değiştirmek için Yapı Varsayılanları sekmesini seçin, Yapı denetleyicisi menüsünü açın ve yapı denetleyicisini seçin.

• Etiket Karşılaştırma İşleci: Menüde aşağıdaki değerlerden birini seçin:

  • MatchExactly: Bu yapı tanımının yalnızca Etiket Filtresi kutusunda belirttiğiniz etiket kümesinin aynısına sahip olan yapı aracıları tarafından işlenmesini istiyorsanız, bu değeri seçin.Herhangi bir etiket belirtmezseniz, herhangi bir aracı bu yapı tanımını işleyebilir.

    İpucu
    MatchExactly öğesini seçerek, bu yapı tanımı için uygun olan aracıları yalnızca Etiket Filtresi alanındaki etiket kümesinin tamamına sahip olanlarla kısıtlarsınız.

  • MatchAtLeast: Bu yapı tanımının en azından Etiket Filtresi kutusunda belirttiğiniz etiket kümesinin aynısına sahip olan herhangi bir yapı aracısı tarafından işlenmesini istiyorsanız, bu değeri seçin.Herhangi bir etiket belirtmezseniz, yalnızca etikete sahip olmayan aracılar bu yapı tanımını işleyebilir.

Yapı aracısı zaman sınırları belirtme

Zaman sınırlarını belirtmek için Gelişmiş düğümünü genişletin, Aracı Ayarları düğümünü genişletin ve ardından parametreleri aşağıdaki tabloda belirtin.

Amacınız şu ise…	Bu parametreyi ayarlayın…	Bu kılavuzu kullanarak…
Yapı aracısının yapıyı işlemesi için izin verilen en uzun süreyi belirtme	En Fazla Yürütme Zamanı	hh:mm:ss biçiminde bir zaman aralığı değeri girin.Örneğin, 04:30:15 değerini belirtirseniz ve yapı aracısı 4 saat 30 dakika ve 15 saniyede işini bitiremezse yapı başarısız olacaktır.Yapı aracısına yapıyı işlemesi için sınırsız zaman tanımak istiyorsanız, 00:00:00 değerini belirtin.
Yapı isteğini yapı aracısına atamak için izin verilen en uzun süreyi belirtme	En Fazla Bekleme Zamanı	hh:mm:ss biçiminde bir zaman aralığı değeri girin.Örneğin, 01:30:45 değerini belirtirseniz ve yapı aracısı 1 saat 30 dakika ve 45 saniyede işini bitiremezse, yapı başarısız olacaktır.Yapı denetleyicisine bu yapı tanımını işleyecek bir yapı aracısı bulmak için sınırsız zaman tanımak istiyorsanız, 00:00:00 değerini belirtin.

Yapı sonucunu denetleme

Yapı Çıkış Konumunu Belirtme

TFBuild'in yapı çıkışlarını nereye yerleştireceğini denetlemek için aşağıdakini seçin:

• Tüm yapı çıkış dosyalarını bırakma klasörüne yerleştirmek için SingleFolder.

• Yapı çıkışlarını Projeler kutusunda belirttiğiniz her çözüm ve kod projesi için bırakma klasörü alt klasörlerinde gruplandırmak için PerProject.

• Yapı aracısı kaynakları klasörü içindeki ikili dosyaları, Visual Studio'daki geliştirme makinenizde kodunuzu oluştururken gördüğünüz aynı alt klasör yapısında düzenlenmiş şekilde bırakmak için AsConfigured.Bu yapı, kod projelerinizde tanımlanır.

  Bu seçeneği kullanırsanız, TFBuild çıkışını bırakma klasörüne kopyalamaz.Bunun yerine, hazırlama konumuna bırakılmaları için TF_BUILD_BINARIESDIRECTORY tarafından belirtilen konuma çıkışları kopyalanacak şekilde betiklerinizi programlayabilirsiniz.Bkz. yapı sonrası veya test sonrası betikler.

Tamamlanan yapıların adlarını takımınız için kullanışlı hale getirme

Siz ve takımınız yararlı verileri tamamlanan her yapının adına yüklemek için Gelişmiş, Yapı sayı biçimi seçeneğini kullanabilirsiniz.Bu parametrenin geçerli değerleri için bkz. Tamamlanan yapılara anlamlı adlar vermek için yapı numaralarını kullanma.

Yapıdan Simgeler Yayımlama

Geçmiş hata ayıklama gibi özellikleri etkinleştirmek için simge verilerinin dizinini oluşturmak ve bunları yayımlamak üzere Simgeleri yayımlama yolu parametresini belirtin.Bkz. Simge verilerini dizinleme ve yayımlama.

Değişiklik kümesi, yürütmeler ve iş öğelerini ilişkilendirme

Yapı işlemi, tamamlanan her yapıyı değişiklik kümelerinin tamamına veya koda ve bunların ilgili iş öğelerine giden yürütmelere otomatik olarak bağlar.Bu davranışı devre dışı bırakamazsınız, ancak Gelişmiş altında True ya da False seçerek İş öğelerini yapı numarasıyla güncelleştirmek isteyip istemediğinize karar verebilirsiniz.

Yapı işlemi değişiklik kümelerinin, yürütmelerin ve iş öğelerinin ne zaman ilişkilendirileceğini nasıl belirliyor?

Başarısızlık durumunda iş öğesi oluşturma

Yapı başarısız olduğunda yapı işleminin bir hata oluşturup bunu TFVC değişiklik kümesini iade etmiş veya Git yürütmesini göndermiş kişiye atamasını istiyorsanız, Gelişmiş, Başarısızlık durumunda iş öğesi oluştur için True'yu seçin.

Kaynak kodunuzu etiketleme

Tamamlanan yapıya dosyanın hangi sürümünün eklendiğini takımınızın kolayca bulmasını sağlamak üzere her kaynak dosyayı otomatik olarak bir etiketle işaretlemek istiyorsanız, TF Sürüm Denetimi, Kaynakları Etiketle için True'yu seçin.Bu ayar Git takım projeleri için geçerli değildir.

Etiket için hangi sürüm TFBuild nasıl belirler hakkında daha fazla bilgi için bkz nasıl iyi olduğu, yapı?

Soru - Yanıt

Visual Studio Online'da doğru varsayılan Git yapısı işlem şablonunu kullandığımdan nasıl emin olabilirim?

Bağlı olduğunuz bir Git takım projesi barındırılmasına Visual Studio Online?Kullanıma almayı geçersiz kılma ve Projeler parametreleri sizde yok mu?

Ayrıntıları gösterdiğinizde Varsayılan Şablon (GitTemplate.xaml) görünüyor mü?

Görünüyorsa, GitTemplate.12.xaml'yi seçin.Bu yapıldıktan sonra, Kullanıma almayı geçersiz kıl parametresi ve Projeler parametresindeki gözat düğmesi görünür.

S: Yapı işlemi değişiklik kümelerinin, yürütmelerin ve iş öğelerinin ne zaman ilişkilendirileceğini nasıl belirliyor?

Y: Her yapı tanımı hangi değişiklik kümelerinin (TFVC), yürütmelerin (Git) ve iş öğelerinin sonraki tamamlanan yapıyla ilişkilendirilmeyi beklediğinin kaydını kendisi tutar.

Örneğin, değişiklik kümesi 382 Yapı A ve Yapı B tarafından oluşturulmuştur.Yapı A sıraya alınır ve başarıyla tamamlanır.Yapı B sıraya alınır ve başarısız olur.Değişiklik kümesi 382 artık Yapı A'nın başarıyla tamamlanmış yapısıyla ve Yapı B'nin başarısız yapısıyla bağlantılıdır. Değişiklik kümesi 382 Yapı A'nın sonraki tamamlanan yapısıyla bağlanmayacak, ancak Yapı B'nin bir sonraki başarılı yapısıyla bağlanacaktır.

Nasıl TFBuild ilişkilendirmek için hangi sürümün belirler hakkında daha fazla bilgi için bkz: nasıl iyi olduğu, yapı?

S: başka şeyler için yapı işlemi gerekir.Bunu nasıl özelleştirebilir?

A:Customize the process