Aracılığıyla paylaş

Team Foundation yapım faaliyetleri

  • Makale

Team Foundation Yapısı Aktiviteler oluşturma işleminde temel bileşenleri olan sizin Team Foundation Yapısı Sistem. Bu faaliyetler, özel mantık izleyen veya belirli görevleri gerçekleştirme gibi takım gereksinimlerini karşılamak için özel yapım işlemi oluşturmak için kullanabilirsiniz.

Çoğu durumda, özel yapım işlem şablonu oluşturmak için en iyi varsayılan şablonu temel yoludur (DefaultTemplate.xaml). Bu şekilde, gereksinimlerinizi karşılamak için belirli bölümlerini özelleştirme sırasında önceden oluşturulmuş genellikle yararlı işlevselliği yararlanabilirsiniz. Bu yaklaşımın başka bir avantajı, bu konuyu açıklayan etkinlikleri nasıl kullanabileceğiniz özel ve pratik örnekleri görebilirsiniz ' dir. Yapı işlem şablonu oluşturma hakkında daha fazla bilgi için bkz: Oluşturma ve özel yapım işlem şablonu ile çalışma.

Önemli

Yalnızca özel gereksinimleri karşılaması gerekir, özel oluşturma işlemi oluşturmanız gerekir. Kullanabileceğiniz DefaultTemplate.xaml tanımlamakta hızla oluşturma işlemi uyan birçok tipik gereksinimleri. Daha fazla bilgi için bkz. Varsayılan şablonu kullanarak bir yapı tanımlar.

Bu konuda

  • Gerekli İzinler (bu sayfa İngilizce içeriğe sahip olabilir)

  • Faaliyetleri amaç yönelimli referansı

  • Etkinlikler alfabetik referansı

Gerekli İzinler (bu sayfa İngilizce içeriğe sahip olabilir)

Kullandığınız yordamları gerçekleştirmek için Team Foundation Yapısı Etkinlikler olması gerekir aşağıdaki izinleri ayarlamak Ver:

  • Yapı tanımını düzenle

  • Kullanıma ve kontrol ilgili sürüm denetimi dizinler için (gibi BuildProcessTemplates alt ekip proje)

  • Sıra oluşturur

Daha fazla bilgi için bkz. Takım Kuruluş Sunucusu İzinleri.

Faaliyetleri amaç yönelimli referansı

  • Temel görevleri gerçekleştirebilirsiniz

    • Ortam değişkenlerinin değerlerini Al

    • Çalışma dosyalarının yollarını alın

    • Dizinleri ile çalışmak

    • Yapı Aracısı çalışma dizini yolunu Al

    • Çalışma alanında olmayan dosyaları karşıdan yükleme

    • Dosyaları bulma

    • Uyarılar, hataları, iletileri ve diğer verileri oluşturma günlüğüne yazma

    • Yapı meta veri ambarına yazma

  • Denetim oluşturma işlemi

    • Aktiviteler oluşturma Aracısı'nı Çalıştır

    • Bir iş parçacığı güvenli işlem uygulamak için adlandırılmış bir mutex yapıyı kullanır.

    • Neden (tetikleyici) temel yapý süreciniz bölümlerini sınırlama

  • , Test, derleme ve diğer görevleri

    • MSBuild ikili dosyaların kodu çözümlemesini çalıştırmanız ve diğer görevleri gerçekleştirmek için kullanın

    • Bu sınamayı çalıştırmak için MSTest kullanın

    • Yapı etkiler sınamaların listesini almak

    • Bir işlem başlatmak

  • Sürüm denetimi ile çalışmak

    • Changesets ilişkilendirmek ve yapı öğeleriyle çalışma

    • Gated değişiklikleri teslim et

    • İade ilkeleri değerlendir

    • Etiket dosyalarının sürüm denetimi

  • İş öğeleriyle çalışma

    • Changesets ilişkilendirmek ve yapı öğeleriyle çalışma

    • İş öğesi oluşturma

  • Sembol verilerle çalışma

    • Sürüm denetim yolları ve sürümleri .pdb dosyalarınızı sembol veri içine gömmek

    • SymStore sembolü depoya sembolleri Yayımla

  • Yararlı nesnelere başvurular almak

    • Ekip proje koleksiyonu için bir nesneye bir başvuru almak

    • Bir nesneye bir başvuru oluşturma Aracısı için alın

    • Bir nesneye bir başvuru için yapı Ayrıntıları Al

    • Bir nesneye bir başvuru almak için oluşturma ortamı

Etkinlikler alfabetik referansı

  • AgentScope

  • AssociateChangesetsAndWorkItems

  • CheckInGatedChanges

  • ConvertWorkspaceItem

  • ConvertWorkspaceItems

  • CopyDirectory

  • CreateDirectory

  • CreateWorkspace

  • DeleteDirectory

  • DeleteWorkspace

  • DownloadFile

  • DownloadFiles

  • EvaluateCheckInPolicies

  • ExpandEnvironmentVariables

  • FindMatchingFiles

  • GetBuildAgent

  • GetBuildDetail

  • GetBuildDirectory

  • GetBuildEnvironment

  • GetImpactedTests

  • GetTeamProjectCollection

  • GetWorkspace

  • IndexSources

  • InvokeForReason

  • InvokeProcess

  • LabelSources

  • LabelWorkspace

  • MSBuild

  • MSTest

  • OpenWorkItem

  • PublishSymbols

  • RevertWorkspace

  • SetBuildProperties

  • SharedResourceScope

  • SyncWorkspace

  • TfsBuild

  • UpdateBuildNumber

  • WriteBuildError

  • WriteBuildInformation <T>

  • WriteBuildMessage

  • WriteBuildWarning

Temel görevleri gerçekleştirebilirsiniz

Kullanabileceğiniz Team Foundation Yapısı aşağıdaki görevleri gerçekleştirmek için etkinlikler:

  • Ortam değişkenlerinin değerlerini Al

  • Çalışma dosyalarının yollarını alın

  • Dizinleri ile çalışmak

  • Yapı Aracısı çalışma dizini yolunu Al

  • Çalışma alanında olmayan dosyaları karşıdan yükleme

  • Dosyaları bulma

  • Uyarılar, hataları, iletileri ve diğer verileri oluşturma günlüğüne yazma

  • Yapı hakkında meta veri yazma

Ortam değişkenlerini (ExpandEnvironmentVariables etkinliğini) değerlerini Al

Use ExpandEnvironmentVariables aktiviteye çözmek bir veya daha fazla ortam değişkenleri oluşturma sunucusu. Bu etkinlik içinde ise ortam değişkenleri oluşturma Aracısı'nı okunan bir AgentScope sıralama; Aksi halde, bunlar yapı denetleyicisinde okunur.

ExpandEnvironmentVariables sonucu (String) özelliği

İşleminin sonucu döndürür. Örne?in: The temp directory on machine BLDSERV3 is C:\windows\SERVIC~2\NETWOR~1\AppData\Local\Temp.

ExpandEnvironmentVariables bağımsız değişkeni özellikleri

  • Input (String): Çözmek istediğiniz ortam değişkenlerini içeren dizesi belirtmeniz gerekir. Her ortam değişkeni belirterek biçimlendirmeniz gerekir bir MSBuild yerine özelliğini kullanarak Windows yüzde sembol gösterim. Örne?in: "The temporary directory on machine $(COMPUTERNAME) is $(TEMP)."

  • AdditionalVariables (IDictionary<TKey, TValue><String,String>): Belirtebileceğiniz bir IDictionary nesne içeren herhangi ek değişkenler (anahtar) olarak istediğiniz gidermek için ilgili kendi değerleri.

Başa dön

Çalışma dosyalarının yollarını alın

Her yapı üzerinde tanımlı bir sürüm denetimi çalışma alanı olan çalışma sekmesini yapı tanımı. Çalışma alanı oluşturma kaynak dosyaları ve sürüm denetim sisteminden gereken diğer dosyaları için erişim sağlar. Team Foundation YapısıYapı çalışma alanında bulunan dosyalarla çalışmak için kullanabileceğiniz iki etkinliği sağlar: ConvertWorkspaceItemve ConvertWorkspaceItems.

Çalışma alanları oluşturma hakkında daha fazla bilgi için bkz: Temel yapı tanımı oluşturma.

İpucuİpucu

Nasıl kullanılacağı hakkında ayrıntılı adım adım yönergeler için ConvertWorkspaceItem etkinliğini tipik bir senaryoda, Burada oluþturma sistemi, ikili dosyalar yerleştirir kontrol.

Çalışma alanı (ConvertWorkspaceItem etkinliğini) dosyasında yolunu Al

Use ConvertWorkspaceItem etkinlik oluşturma Aracısı yerel yola sunucu yoluna dönüştürme veya yapı aracıya sunucu yolu üzerinde bir yerel yol Dönüştür

ConvertWorkspaceItem sonucu (String) özelliği

Dönüştürülen yolunu döndürür.

ConvertWorkspaceItem bağımsız değişkeni özellikleri

  • Input (String): Dönüştürmek istediğiniz yol değeri girmeniz gerekir.

  • Workspace (Workspace): Başvuru sağlamanız gerekir Workspace içeren dosya. Çoğu durumda, bu özellik de bilgisine değişkenine ayarlamalısınız sonucu özelliği CreateWorkspace etkinliği. Temel alan bir işlemi oluşturma, DefaultTemplate.xaml, büyük olasılıkla kullanmanız gereken Workspace değişkeni.

  • Yön

    • Sunucu yolu yerel bir yol Dönüştür: İçinde Yön özelliği, select ServerToLocalve sunucu üzerinde dosyasının yolunu belirtmek Giriş (String) özellik.

      Örneğin, ekibinizin genel yardımcı programını aşağıdaki dizinde saklayabilir: $/OurTeam/BuildProcess/Util. Çalışan bir özel oluşturma işlemi oluşturabilirsiniz ScanBinaries.exe , ikili dosyaları derlenmiş sonra yardımcı programı. $/OurTeam/BuildProcess/Util Üzerindeki eşlenmiş çalışma sekmesini belirtebileceğiniz yapı tanımınızı $/OurTeam/BuildProcess/Util/ScanBinaries.exe , Giriş yardımcı programını yerel yolu geçmek için özellik sonucu (String) özelliği.

    • Sunucu yolu ile bir yerel yol Dönüştür: De Yön özelliği, select ServerToLocalve yerel build aracı dosyasının yolunu belirtmek Giriş özelliği.

Çalışma alanı (ConvertWorkspaceItems etkinliğini) dosyalarında yollara alın

Use ConvertWorkspaceItems etkinlik oluşturma Aracısı yerel yollarında server yollara Dönüştür veya yapı Aracısı sunucu yolları yerel yollarında dönüştürmek

ConvertWorkspaceItems sonucu (IList<String>) özelliği

Dönüştürülen yolu değerlerini döndürür.

ConvertWorkspaceItems bağımsız değişkeni özellikleri

  • Input (IEnumerable<T><String>): Dönüştürmek istediğiniz yolu değerlerini sağlamanız gerekir.

  • Workspace (Workspace): Başvuru sağlamanız gerekir Workspace içeren dosyalar. Çoğu durumda, bu özellik de bilgisine değişkenine ayarlamalısınız sonucu özelliği CreateWorkspace etkinliği.

    İpucuİpucu

    Temel alan bir işlemi oluşturma, DefaultTemplate.xaml, büyük olasılıkla kullanmanız gereken Workspace değişkeni.

  • Yön: Aşağıdaki değerlerden birini seçin:

    • Seçin ServerToLocal server yolu değerleri topluluğu belirterek, Giriş özelliği ile istediğiniz sonucu yerel yol değerler listesini döndürmek için özelliği.

    • Seçin LocalToServer yerel yol değerleri topluluğu belirterek, Giriş özelliği ile istediğiniz sonucu server yolu değerler listesini döndürmek için özelliği.

Dizinleri ile çalışmak

Dizinlerle çeşitli etkinlikleri kullanarak çalışma Team Foundation Yapısı.

İpucuİpucu

Sürüm denetimi çalışma oluþturma'nın bir parçası olan dizinleri ile çalışmanız gerekir, yerine çalışma faaliyetleri kullanmanız gerekir. Daha fazla bilgi için bkz: Çalışma dosyalarının yollarını Al.

Bir dizin (CreateDirectory etkinliği)

Kullanım CreateDirectory , adını belirtin, bir dizin oluşturmak için faaliyet dizini (String) özellik.

Bir dizin (CopyDirectory etkinliğini) kopyalama

Use CopyDirectory yinelemeli olarak faaliyete belirttiğiniz bir dizinden içerik kopyalama kaynak (String) özelliği, belirttiğiniz başka bir dizine hedef (String) özelliği. Belirttiğiniz dizin hedef özelliği gerekir zaten. Boş dizin ve alt dizinleri kopyalanmaz.

Bir dizini (DeleteDirectory etkinliğini) silmek

Use DeleteDirectory , adını belirtin, bir dizini silmek için etkinlik dizin (String) özelliği. Silmekte olduğunuz dizinin alt dizinleri içeriyorsa, ayarlamalısınız özyinelemeli (Boolean) özelliğini True; Aksi takdirde, oluşturma başarısız olur.

Çalışma dizininde (GetBuildDirectory etkinliğini) oluşturma Aracısı get yol

Use GetBuildDirectory etkinlik oluşturma aracının çalışma dizininden değişmez yolu geçmek için sonucu (String) özelliği. Bu etkinliği yalnızca içinde kullanabileceğiniz bir AgentScope etkinliği.

Başa dön

Çalışma alanında olmayan dosyaları karşıdan yükleme

Use DownloadFiles etkinlik yüklenecek bir veya daha fazla dosyaları. Yoksay DownloadFile etkinliği.

DownloadFiles etkinlik

Use DownloadFiles etkinlik sürüm denetimi bir veya daha fazla dosyaları karşıdan yükleme

İpucuİpucu

Karşıdan yüklemek istediğiniz dosyaları oluşturma çalışma, büyük olasılıkla bunları kullanarak erişmek için kullanması ConvertWorkspaceItem etkinliği.

DownloadFiles bağımsız değişkeni özellikleri

  • LocalPath (String) değeri belirtmeniz gerekir:

    • Tek bir dosyayı karşıdan yüklüyorsanız, yerel yolu ve karşıdan yüklediğiniz dosyayı yerel kopyasını vermek istediğiniz adı belirtin; Örneğin, "c:\Docs\readme.txt".

    • Birden çok dosya karşıdan yüklüyorsanız, yerel dosyaları karşıdan yüklemek istediğiniz dizinin yolunu belirtin; Örneğin, "c:\Docs\".

  • ServerPath (String) değeri belirtmeniz gerekir:

    • Tek bir dosyayı karşıdan yüklüyorsanız, sunucunun yolunu ve karşıdan yüklediğiniz dosya adını belirtin; Örneğin, "$/Docs/readme.txt".

    • Birden çok dosya karşıdan yüklüyorsanız, karşıdan yüklemek istediğiniz dosyaları içeren dizini sunucusunun yolunu belirtin; Örneğin, "$/Docs/".

  • Recursion (RecursionType):

    • OneLevel: Dosya veya dosyaları belirttiğiniz dizine yükler ServerPath özelliği.

    • Full: Belirttiğiniz dizin içindeki dosyaları yükler ServerPath özellik ve tüm alt dizinlerindeki tüm dosyaları.

  • Version (String): Bir versionspec belirtebilirsiniz. Bırakın Bu özelliği geçerli sürümünü karşıdan yüklemek için Microsoft.TeamFoundation.VersionControl.Client.VersionSpec.Latest.DisplayString. Versionspecs hakkında daha fazla bilgi için bkz: Komut Satırı Sözdizimi (Sürüm Denetimi).

  • DeletionID (Int32): Yalnızca sürüm denetimi silinmiş bir dosya yüklüyorsanız, bu özelliğini belirtmeniz gerekir. Yazarak bu değer etkileşimli olarak alabilirsiniz tf dir /deleted komut istemi. (Daha fazla bilgi için bkz: Dir komutu). Ancak, Team Foundation Yapısı elde etmek için yerleşik bir etkinlik sağlamaz bir DeletionID. Bu özelliği kullanmak için elde etmek veya bu işlevi sağlayan özel bir faaliyet oluşturmak gerekir.

Başa dön

DownloadFile etkinlik

Yoksay DownloadFile etkinliği. DownloadFiles bir veya daha fazla dosyaları karşıdan yüklemek için en kolay yolu etkinliktir.

(FindMatchingFiles etkinliğini) dosyaları Bul

Use FindMatchingFiles aktivite bulma dosyaları. Arama ölçütünü belirtmek MatchPattern (String) özellik. Bu özellik, aşağıdaki öğeleri içeren bir değişken belirtebilirsiniz:

  • Tarafından desteklenen sözdizimi searchPattern bağımsız değişkeni Directory GetFiles(String, String) yöntemi.

  • **yinelemeli arama belirtmek için. Örne?in:

    • Metin dosyaları için Kaynaklar dizinini arama yapmak için aşağıdaki değeri benzer bir şey belirtebilirdiniz MatchPattern özelliği: String.Format("{0}\**\*.txt", SourcesDirectory).

    • Kaynaklar dizini metin dosyaları için çağrılan bir veya daha fazla dizinlerde aramasını txtfiles, aşağıdaki değeri benzer bir şey gibi belirtebilirdiniz MatchPattern özelliği: String.Format("{0}\**\txtfiles\*.txt", SourcesDirectory).

İşlem sonucunu toplamak sonucu (IEnumerable<T><String>) özellik.

Uyarılar, hataları, iletileri ve diğer verileri oluşturma günlüğüne yazma

WriteBuildMessage etkinlik

Use WriteBuildMessage Yapı Kütük'ü de bir bilgilendirme iletisi yazma etkinliği İletide belirtmelisiniz ileti (String) özellik. Değerini değiştirerek iletinin önemini de belirtmek önem özelliği (BuildMessageImportance).

İpucuİpucu

  • Yapý süreciniz kullanıcıları hem ne bunlar görüntülemek gerekir ve ambarda depolanan veri aşırı bilgi azaltmak için süzme ayrıntı amacıyla kullanabilir. Bu filtre daha etkili ayar Düşünceli ve tutarlı bir yaklaşım kullanarak yapmak yardımcı olabilir önem yapı iletilerinizin özelliği. Nasıl build günlüğün ayrıntı düzeyini kullanıcılar filtre hakkında daha fazla bilgi için bkz: Varsayılan şablonu kullanarak bir yapı tanımlar.

  • Varsayılan ayarları kullanıyorsanız, iletinizi oluşturma günlüğüne yazılmayacak. Bu sorunu gidermek için aşağıdaki adımlardan birini gerçekleştirin:

    • Set WriteBuildMessage önem özelliğine Microsoft.TeamFoundation.Build.Client.BuildMessageImportance.High.

    • Üzerinde işlem sekmesini yapı tanımı set Günlük ayrıntı düzeyini işlemi parametresi için Detailed veya Diagnostic.

WriteBuildWarning etkinlik

Use WriteBuildWarning bir uyarı iletisini build Kütük'ü de yazma etkinliği Uyarılar oluşturma Sonuçları penceresinde sarı bir ünlem işaretiyle görünüyor. İletide belirtmelisiniz ileti (String) özellik.

WriteBuildError etkinlik

Use WriteBuildError Yapı Kütük'ü de bir hata iletisi yazma etkinliği Derleme Sonuçları penceresinde kırmızı bir ünlem işaretiyle hatalar görüntülenir. Hata oluşturma günlüğüne yazıldığında, yapı olarak sınıflandırılır Partially Succeeded en iyisidir. İletide belirtmelisiniz ileti (String) özellik.

WriteBuildInformation <T> Etkinlik

Use WriteBuildInformation<T> Yapı Kütük'ü içine bir nesne yerleştirme faaliyeti Kullanıcı oluşturma Sonuçları penceresinde günlük görüntülediğinde nesneyi yansıtma kullanarak işlenir.

WriteBuildInformation <T> Değişken özellikleri

  • Value (Object): Yapý günlüðüne yerleştirmek istediğiniz nesne belirtmeniz gerekir. Nesneniz yapı Sonuçları penceresinde işlenecek nesne uygulamalıdır IBuildInformationNode ve Type aşağıdakilerden birine InformationTypes değerler:

    • ActivityProperties

    • ActivityTracking

    • AgentScopeActivityTracking

    • BuildError

    • BuildMessage

    • BuildProject

    • BuildStep

    • BuildWarning

    • ExternalLink

    • OpenedWorkItem

  • ParentToBuildDetail: Belirtebileceğiniz False olun bu nesnenin üst üst bu etkinliği olması veya belirtebilirsiniz True üst yapmak IBuildDetail nesne.

    Bu özelliğinin bir etkisi nasıl bilgi derleme sonucu görünür olmasıdır. Belirtirseniz, False, bilgiler girintili ve önce ve sonra diğer etkinlikler çıktısıyla hizalı WriteBuildInformation<T> etkinliği ve olan aynı düzeyi. Belirtirseniz, True, bilgi girintili değildir.

Başa dön

Meta veri ambarına yazma

Meta veri ambarına yapıda hakkında yazabilirsiniz:

  • Yapı numarası (UpdateBuildNumber etkinliğini) yazma

  • Yazma anahtar veri noktaları (SetBuildProperties etkinliğini) oluşturma hakkında

İpucuİpucu

Bu etkinlikler, yazmak için kullanabileceğiniz istediğiniz meta verileri desteği yoksa GetBuildDetail için başvuru için etkinlik IBuildDetail nesne ve verilere doğrudan nesne kullanarak atayabilirsinizbu başvuru.

Yapı numarası (UpdateBuildNumber etkinliğini) yazma

Use UpdateBuildNumber Faaliyet ayarlamak yapı numarası veya adı yapı. Bu etkinlik, aşağıdaki adımları gerçekleştirir:

  1. Yapı sayı biçimini belirleyen bir ifadeye dayalı bir yapı numarası oluşturur. Yapý süreciniz üzerinde parametresi tarafından sağlanan bir iş akışı bağımsız Bu ifadeden genellikle kabul işlem sekmesini yapı tanımı.

  2. Yapı yapı numarası (veya adı) sonuç değeri yazarak ayarlar BuildNumber özelliği.

UpdateBuildNumber sonucu (String) özelliği

Sonuç: Yeni verir BuildNumber değer.

UpdateBuildNumber özellikleri

  • BuildNumberFormat (String): Yapı sayıların biçimini belirten bir ifade sağlamanız gerekir. İfade simgeleri kullanabilirsiniz. Aşağıdaki örnek durum göz önünde bulundurun:

    • Ekip proje adıContosoCore

    • Yapı tanımı adlı DailyBuild.

    • Yapı kimliği4

    • Bugün, 24 Ağustos 2009 olduğunu.

    • 9:50:43 pm saattir.

    • Yapı, bugün bir kez çalıştırıldı.

    Örneğin, ayarlayabilirsiniz BuildNumberFormat özelliği aşağıdaki değere:

    $(BuildDefinitionName)_$(Date:yyyyMMdd)$(Rev:.r)

    Bu durumda, sonraki derlemesi tamamlandı DailyBuild aşağıdaki yapı numarasını ayarlayın:

    DailyBuild_20090824.2

    Aşağıdaki tabloda her simgenin nasıl çözümlendiğini örnee dayanarak gösterir.

    Token

    Bu bölümündeki örneğe göre değiştirme değeri

    $(BuildDefinitionName)

    DailyBuild

    $(BuildID)

    4

    $(DayOfMonth)

    24

    $(DayOfYear)

    236

    $(Hours)

    09

    $(Minutes)

    50

    $(Month)

    08

    $(Rev:.rr)

    2 (Bu gün sonraki yapı 3 olması vb.)

    $(Date:MMddyy)

    082409

    $(Seconds)

    50

    $(TeamProject)

    ContosoCore

    $(Year:yy)

    09

    $(year:yyyy)

    2009

Başa dön

Yazma anahtar veri noktaları (SetBuildProperties etkinliğini) oluşturma hakkında

Use SetBuildProperties Anahtar veri noktalarının yazmak için IBuildDetail nesnesi, veri ambarı her yapı hakkında veri depolama yönetir Bu veri çoğunu kullanıcıya build Sonuçları penceresinde görüntülenir.

SetBuildProperties özellikleri

  • PropertiesToSet: Adlarını ayarlamak istediğiniz özelliklerin onay kutularını seçmeniz gerekir.

  • YapıNumarası (String): Ayarlayabileceğiniz BuildNumber derlemesinin hangi düşündüğünüz adı olarak yapı.

    İpucuİpucu

    Bu değer, kullanıcı tarafından belirtilen ayarlara göre ayarlamak istiyorsanız, işlem sekmesini yapı tanımı, büyük olasılıkla kullanmanız gereken UpdateBuildNumber bu özelliği yerine faaliyet.

  • CompilationStatus (BuildPhaseStatus): Derleme durumu ayarlayabilirsiniz (CompilationStatus). ( MSBuild etkinlik de ayarlar bu değer otomatik olarak.)

  • DropLocation (String): Açılan konumda kaydedebilirsiniz DropLocation özelliği.

    Not

    Bu özellik ayarlarsanız, aslında bırakma konumuna oluşturmayın. Bunun yerine, veri ambarı, genellikle kullanarak oluşturduğunuz bırakma klasörünün konumunu depolamak için bu özelliği kullanabilirsiniz CreateDirectory etkinliği.

  • KeepForever (Boolean): Ayarlayabileceğiniz KeepForever özelliğine True ayarlarını atlamak istiyorsanız, Bekletme ilkesini sekmesini sakla sonsuza kadar tamamlanan yapı ve yapı tanımı.

  • LabelName (String): Ayarlayabileceğiniz LabelName Bu yapı sürüm denetimi kaynak kodu dosyaları üzerinde işaretlemek için kullanılan etiketi kaydetme özelliği Bu özellik genellikle değere eşleştirmek için ayarladığınız adı özelliği LabelWorkspace etkinliği.

    Önemli

    Team Foundation Yapısıchangeset ilişkilendirmek ve yapılar öğelerle çalışmak için bu verileri gerektirir. Bu veriler belirtmezseniz, AssociateChangesetsAndWorkItems etkinlik başarısız olur.

  • LogLocation (String): Kullanabileceğiniz LogLocation özellik kaydetme unc dosya yolu'klasörüne yapý süreciniz yere koyar günlük dosyası.

    Not

    Büyük bir olasılıkla özel yapý süreciniz bu özelliği kullanmanız gerekmez. Bu özellik öncelikle tarafından amaçlanmıştır UpgradeTemplate.xaml dosyaya destekleyen eski yapı işlemleri.

  • Quality (String): Yapý içinde kalitesi kaydedebilirsiniz Quality özelliği.

  • SourceGetVersion (String): Kullanabileceğiniz SourceGetVersion hangi kaynaklardan alınır Bu yapı. sürüm belirtimi kaydetme özelliği

  • Status (BuildStatus): Yapý içinde genel durumunu kaydetmek Status özelliği. Örneğin, yapı başarılı veya başarısız olup olmadığını belirtmek için bu özelliği kullanabilirsiniz.

  • TestStatus (BuildPhaseStatus): Kullandığınız TestStatus testleri Bu yapı. çalıştırılan genel durumunu kaydetme özelliği Örneğin, bu yapı üzerinde çalıştırdığınız sınamaları başarılı veya başarısız olup olmadığını belirtmek için bu özelliği kullanabilirsiniz.

Başa dön

Denetim oluşturma işlemi

Kullanabileceğiniz Team Foundation Yapısı oluşturma işlemi aşağıdaki şekillerde denetlemek için etkinlikler:

  • Aktiviteler oluşturma Aracısı'nı Çalıştır

  • Bir iş parçacığı güvenli işlem uygulamak için adlandırılmış bir mutex yapıyı kullanır.

  • Neden (tetikleyici) temel yapý süreciniz bölümlerini sınırlama

Faaliyetleri oluşturma Aracısı (AgentScope etkinliğini) Çalıştır

Use AgentScope aktiviteye içine parçaları yapý süreciniz istediğiniz çalıştırma oluşturma Aracısı.

AgentScope bağımsız değişkeni özellikleri

  • Aracısı Seçimi

    • MaxWaitTime (TimeSpan): Oluşturma işlemi kullanılabilir olana kadar siparişe Aracısı için bekleyeceği en fazla süreyi belirtebilirsiniz. :: Ss biçiminde bir değer yazabilirsiniz. Örneğin, oluşturma zaman aşımı hatası ile 01: 30: 45 değerini belirtin ve yapı oluşturma Aracısı ile 1 saat, 30 dakika, ve 45 saniye sonra atanmamış başarısız olur. 00: 00: 00 Değeri sınırsız yapı denetleyicisi vermek istiyorsanız, zaman bu yapı tanımı işlemek için bir yapı aracı bulmak için belirtin.

      Önemli

      Yapı Kuyruğunuzdaki makul sıfır olmayan bir değer belirterek yedekleme kaçınmak MaxWaitTime özelliği

    • ReservationSpec (AgentReservationSpec): Bu aktiviteyi içeren faaliyetler işleyecek oluşturma Aracısı türünü kısıtlayabilirsiniz. Örneğin, yalnızca belirli bir etiketi olan yapı aracılarının faaliyetleri içinde işlemek için kullanılan belirtebilirsiniz AgentScope etkinliği.

  • Execution

    • MaxExecutionTime (TimeSpan): Bunun için izin verilen en uzun süreyi belirtebilirsiniz AgentScope etkinlik tamamlanacak. :: Ss biçiminde bir değer yazabilirsiniz. Örneğin, oluşturma zaman aşımı hatası ile 04: 30: 15 değerini belirtin ve yapı Aracısı çalışmalarının 4 saat, 30 dakika, 15 saniye sonra tamamlanmadı başarısız olur. 00: 00: 00 Değeri sınırsız yapı Aracısı vermek istiyorsanız, zaman yapı işlemek için belirtin.

      İpucuİpucu

      Yapı Kuyruğunuzdaki makul sıfır olmayan bir değer belirterek yedekleme kaçınmak MaxExecutionTime özelliği

  • Kapsam

    • DataToIgnore: Bu özellik yoksay.

Başa dön

Bir iş parçacığı güvenli işlem (SharedResourceScope etkinliğini) uygulamak için adlandırılmış bir mutex yapıyı kullanır.

Use SharedResourceScope aktiviteye uygulayan bir adlandırılmış mutex (karşılıklı dışlama) yapısı. Bu etkinliğin içinde koymak yapý süreciniz parçası "iş parçacıklarını." olacaktır

Bir normal bu etkinlik parçaları aynı anda tek bir işlem tarafından erişilecek bir paylaşılan kaynağa erişmesi gereken bir işlemi kapsamak için kullanılır. Örneğin, sırayla, dosya paylaşımında tek metin dosyasına yazmak için kendi yapılarına isteyebilirsiniz. Bu tür bir işlemi doğru çalıştığından emin olmak için içini uygulamalısınız bir SharedResourceScope etkinliği.

Başka bir örnek DefaultTemplate.xaml, içinde bulabilirsiniz çağrısı PublishSymbols etkinlik katıştırılan bir SharedResourceScope etkinlik:

  1. Sıra (Sequence) >

  2. Aracısı'nı çalıştırın (AgentScope) >

  3. Derleme, Test ve ilişkilendirin Changesets ve çalışma öğeleri deneyin (TryCatch [Try]) >

  4. Sıra (Sequence) >

  5. Alma testleri, dizin kaynakları etkilenen ve semboller yayımlamak (Parallel) >

  6. SourceAndSymbolServerSettings.IndexSources veya SourceAndSymbolServerSettings.HasSymbolStorePath (If [Then]) >

  7. Kaynaklar dizini ve sembolleri harekete yapýlar için yayınlama (InvokeForReason) >

  8. SourceAndSymbolServerSettings.HasSymbolStorePath (If [Then]) >

  9. Semboller yayımlamak deneyin (TryCatch [Try]) >

  10. Erişim simgesi deposu Eşitle (SharedResourceScope) >

  11. Semboller yayımlamak (PublishSymbols)

Bu yapı gezinme hakkında daha fazla bilgi için bkz: Karmaşık bir Windows iş akışı gidin.

SharedResourceScope bağımsız değişkeni özellikleri

  • KaynakAdı (String): Bir değer belirtmeniz gerekir. Tüm örneklerini SharedResourceScope etkinlikleri çalıştırılır teker teker, sahip oldukları aynı KaynakAdı ekip proje koleksiyonunuzda (farklý yapý tanım şablonları içinde olsalar bile,) değer.

  • MaxExecutionTime (TimeSpan): İçin izin verilen en uzun süreyi belirtebilirsiniz SharedResourceScope etkinlik tamamlanacak. :: Ss biçiminde bir değer yazabilirsiniz. 04: 30: 15 Değerini belirtin Örneğin, oluşturma zaman aşımı hatası ile başarısız olur ve SharedResourceScope etkinliğini değil tamamlanmış sonra 4 saat, 30 dakika ve 15 saniye. Sınırsız süre işlemeye izin vermek istiyorsanız, 00: 00: 00 değerini belirtin SharedResourceScope etkinliği.

    İpucuİpucu

    Yapı Kuyruğunuzdaki makul sıfır olmayan bir değer belirterek yedekleme kaçınmak MaxExecutionTime özelliği

  • MaxWaitTime (TimeSpan): İşlemek için kuyrukta oluşturma işlemi bekleyeceği en fazla süreyi belirtmek SharedResourceScope etkinliği. :: Ss biçiminde bir değer yazabilirsiniz. 01: 30: 45 Değerini belirtin Örneğin, oluşturma zaman aşımı hatası ile başarısız olur ve SharedResourceScope etkinlik işlenmedi sonra 1 saat, 30 dakika ve 45 saniye. 00: 00: 00 Değeri oluşturma işlemi sınırsız izin vermek istiyorsanız, kuyrukta bekleyeceği süreyi belirtin.

    İpucuİpucu

    Yapı Kuyruğunuzdaki makul sıfır olmayan bir değer belirterek yedekleme kaçınmak MaxWaitTime özelliği

Başa dön

Neden (tetikleyici) (InvokeForReason etkinliğini) temel yapý süreciniz bölümlerini sınırlama

Use InvokeForReason aktiviteye içine bir yapý süreciniz yalnızca çalıştırmak istediğiniz parçasını oluşturur, çalıştırmak için belirli bir neden. Yapı nedeniyle genellikle, kullanıcının seçtiği Tetikleyici tarafından ayarlanır Tetikleyici sekmesini yapı tanımı. İçinde de, belirtebilirsiniz neden özelliği, izin vermek istediğiniz bir veya daha fazla açıklaması değerleri. Aşağıdaki tabloda, her değeri neden olan koşulu açıklar.

Nedeni

Neden

BatchedCI

Yapılar çalışırken belirtilmiş Tetikleyici sekmesini yapı tanımı.

CheckInShelveset

Gated iade belirtilmiş Tetikleyici sekmesini yapı tanımı.

IndividualCI

Sürekli Integration belirtilmiş Tetikleyici sekmesini yapı tanımı.

Manual

Kullanıcı el ile oluşturma sıraya. Daha fazla bilgi için bkz. Sıra bir yapı.

Schedule

Zamanla belirtilmiş Tetikleyici yapı tanımı, sekme ve Build önceki yapı bu yana değişti bir şey olsa bile onay kutusunun temizlenmiş.

ScheduleForced

Zamanlama belirtilmiş Tetikleyici yapı tanımı, sekme ve Build önceki yapı bu yana değişti bir şey olsa bile onay kutusunu seçili de.

UserCreated

Bu nedenle nesnelere uygulayan kod oluşur Microsoft.TeamFoundation.Build ad. Daha fazla bilgi için bkz. Team Foundation Server SDK.

ValidateShelveset

Bir kullanıcı özel bir yapý sıraya. Daha fazla bilgi için bkz. Sıra bir yapı.

Başa dön

, Test, derleme ve diğer görevleri

Kullanabileceğiniz Team Foundation Yapısı ikili dosyaların, etkinlikler, sınamaları çalıştırmak ve diğer görevleri yerine getirmek:

  • MSBuild ikili dosyaların kodu çözümlemesini çalıştırmanız ve diğer görevleri gerçekleştirmek için kullanın

  • Bu sınamayı çalıştırmak için MSTest kullanın

  • Bu yapı etkiler sınamaların listesini almak

MSBuild ikili dosyaların kodu çözümlemesini çalıştırmanız ve (MSBuild faaliyet) diğer görevleri gerçekleştirmek için kullanın

Use MSBuild ikili dosyaların, faaliyet kodu çözümlemesini çalıştırmanız ve herhangi bir işlevsellik, yararlanmak MSBuild sağlar.

MSBuild sonuç

Bu etkinliği bir özellik bir sonuç döndürür. Ancak, bu etkinlik ayarlar CompilationStatus için Failed herhangi bir derleme hatası açtıysanız,.

MSBuild bağımsız özellikleri

  • AdditionalVCOverrides (String): Yaparsanız GenerateVsPropsFile için True, bu özelliği içerik katıştırılmış üretilen içine .vsprops dosyası.

  • CommandLineArguments (String): Geçmesini istediğiniz komut satırı bağımsız değişkenleri belirtebilirsiniz MSBuild.

  • Yapılandırma (String): Oluşturulacak yapılandırma belirtebilirsiniz. Örne?in: “debug” veya “release”.

  • GenerateVSPropsFile (Boolean): Bu özelliği ayarlamak, True, MSBuild oluşturduğu bir standart .vsprops dosyasına aktarmak için c++ projects. Bu dosya c++ özellikleri ve istekleriyle belirttiğiniz çıkış dizinini içerir AdditionalVCOverrides özelliği.

  • LogFile (String): Günlüğün adı dosya belirtebilirsiniz MSBuild oluşturmalısınız.

  • LogFileDropLocation (String): İstediğiniz dizinin tam unc yolunu belirtebilirsiniz MSBuild bırakma günlük dosyası.

  • MaxProcesses (Int32): En fazla işlem sayısını belirtebilirsiniz, MSBuild oluşturur.

  • OutDir (String), dizin belirtebilirsiniz nerede MSBuild düşünceye derlenmiş ikili dosyalar. Daha fazla bilgi için bkz. Burada oluþturma sistemi, ikili dosyalar yerleştirir kontrol.

  • Platform (String): Hangi platform belirtebilirsiniz MSBuild yapılar. Örne?in: “Any CPU”, “x86”, or “x64”.

  • Project (String): Çözüm ya da kod proje, belirtebileceğiniz MSBuild yapılar.

  • ResponseFile (String): Yanıt dosyasını belirtebilirsiniz MSBuild kullanır.

  • RunCodeAnalysis (CodeAnalysisOption): Kod analiz her zaman çalışması gerektiğini, hiçbir zaman çalışması gereken veya proje ayarlarına göre çalışması gerektiğini belirtebilirsiniz.

  • Targets (IEnumerable<T><String>): Oluşturmak için hedefleri belirtebilirsiniz.

  • TargetsNotLogged (IEnumerable<T><String>): Hedefleri belirleyebileceğiniz için ProjectStarted olayları günlüğe.

  • ToolPath (String): Aracın yolunu belirtebilirsiniz.

  • ToolPlatform (ToolPlatform): Aracın platform belirtebilirsiniz. Belirtmek Microsoft.TeamFoundation.Build.Workflow.Activities.ToolPlatform.Auto algılamak platformu dayalı geçerli bir işletim sistemi.

  • Verbosity (BuildVerbosity): Günlüğün ayrıntı düzeyini belirtebilirsiniz, MSBuild oluşturur.

Çoğu hakkında daha fazla bilgi için MSBuild seçeneklerini MSBuild özellikleri etkiler, bkz: MSBuild komut çizgi Başvuru.

Başa dön

Sınamalarınızı (MSTest etkinliği)

Bu etkinliği kullanarak sınamaları çalıştırmak için kullanmak MSTest.exe.

Çekirdek MSTest özellikleri

Başlatmak için nasıl, sınamaları çalıştırmak ve sonra uygun özellikleri için değerleri belirtmek istediğinize karar verin.

  • (Önerilen yaklaşım) test kaplarında sınamaları çalıştırmak için aşağıdaki özellikleri kullanın:

    • TestContainers (IEnumerable<String>): Çalıştırmak istediğiniz sınama test kaplar belirtmeniz gerekir. Bu özellik eşdeğerdir /testcontainer seçeneği MSTest.exe komut. Daha fazla bilgi için bkz. MSTest.exe Command-Line Options (/testcontainer).

    • SearchPathRoot (String): Kök testi kapsayıcılar ve bağımlılıklarını aramak dizin yolunu belirtebilirsiniz. Bir değer belirtmezseniz, MSTest aktivitesi tipik konumları dosyaları bulma deneyecek

    • TestSettings (String): Bir sınama çalıştırması yapılandırma dosyasının kullanılacağını belirtebilirsiniz. Bu özellik eşdeğerdir /testsettings seçeneği MSTest.exe komut. Daha fazla bilgi için bkz. MSTest.exe Command-Line Options (/testsettings).

  • Test listelerinde sınamaları çalıştırmak için aşağıdaki özellikleri kullanın:

MSTest filtreleme özellikleri

Filtre hangi testleri çalıştırmak için aşağıdaki özellikleri kullanabilirsiniz:

  • Category (String): Bunların test kategorilerine göre testler filtre uygulayabilirsiniz. Bu özellik eşdeğerdir /category seçeneği MSTest.exe komut. Daha fazla bilgi için bkz:MSTest.exe Command-Line Options (/category) ve Testlerinizi Gruplamak için Test Kategorisi Tanımlama.

  • MaxPriority (Int32): Çalıştırmak istediğiniz sınama en yüksek önceliğini belirleyebilirsiniz. Yalnızca önceliğini küçük veya bu değere eşit çalışacak olan sınar. ' E eşit veya daha büyük bir pozitif tamsayı belirtmelisiniz MinPriority özelliği veya belirtmeniz gerekir -1 en yüksek öncelik belirlemek istemiyorsanız.

    İpucuİpucu

    Sınamalarınızı için öncelikler atadıysanız, MinPriority ve MaxPriority özellikler kapsamlı sınama ve daha hızlı yapılar arasında bir denge tanımlamanıza yardımcı olmak için önemli bir mekanizma olabilir.

  • MinPriority (Int32): Çalıştırmak istediğiniz sınama minimum önceliğini belirleyebilirsiniz. Yalnızca büyük veya bu değere eşit önceliğini sınamalarını çalıştırır. Eşit veya daha küçük olan bir pozitif tamsayı belirtmelisiniz'den MaxPriority özelliği veya belirtmeniz gerekir -1 en düşük öncelik belirlemek istemiyorsanız.

  • TestNames (IEnumerable<String>): Çalıştırmak istediğiniz sınama adlarını belirtebilirsiniz. Bu özellik eşdeğerdir /test seçeneği MSTest.exe komut. Daha fazla bilgi için bkz. MSTest.exe Command-Line Options (/test).

MSTest yayımlama özellikleri

Veri ambarına sınama sonuçlarını yayımlamak için aşağıdaki özellikleri kullanabilirsiniz:

  • Publish (Boolean): Bu özelliği ayarlamanız gerekir True , istediğiniz yayımlama test sonuçları.

  • Flavor (String): Özellik karşı sonuçlarını yayımlamak istediğiniz sınamaları çalıştırdığınız derlemesinin belirtebilirsiniz. Bu özellik eşdeğerdir /flavor seçeneği MSTest.exe komut. Daha fazla bilgi için bkz. Test Sonuçlarını Yayınlamak için Komut Satırı Seçenekleri.

  • Platform (String): Karşı sonuçlarını yayımlamak istediğiniz sınamaları çalıştırdığınız yapı platformunun belirtebilirsiniz. Bu özellik eşdeğerdir /platform seçeneği MSTest.exe komut. Daha fazla bilgi için bkz. Test Sonuçlarını Yayınlamak için Komut Satırı Seçenekleri.

  • TestConfigId (Int32): Var olan bir sınama yönetimi yapılandırmasını sınama sonuçlarını yayımlamak istediğiniz çalışması ile ilişkilendirmek için kimliği belirtebilirsiniz. Bu özellik eşdeğerdir /testconfigid seçeneği MSTest.exe komut. Daha fazla bilgi için MSTest /? en Visual Studio komut istemi.

  • TestConfigName (String): Sınama sonuçlarını yayımlamak istediğiniz çalışması ile ilişkilendirmek için varolan bir sınama yönetimi yapılandırma adını belirtebilirsiniz. Bu özellik eşdeğerdir /testconfigname seçeneği MSTest.exe komut. Daha fazla bilgi için MSTest /? en Visual Studio komut istemi.

MSTest diğer özellikleri

  • CommandLineArguments (String): Belirtebileceğiniz ek komut satırı seçenekleri hakkında daha fazla bilgi için bkz: MSTest.exe Komut Satırı Seçenekleri.

  • PathToResultsFilesRoot (String): Kök dizin yolu oluşturma Aracısı'nı belirtebilirsiniz nerede MSTest.exe sonuçları dosyaları (.trx) koyar.

  • ToolPath (String): Sürümünü içeren dizin yolu belirtebilirsiniz MSTest.exe istediğiniz çalışma. Bir yol belirtmezseniz, Team Foundation Yapısı sınamaları listelerinizi verileri esas yolu'otomatik olarak belirler veya sınama kap.

Başa dön

Yapı (GetImpactedTests etkinliğini) etkiler sınamaların listesini almak

Use GetImpactedTests etkinliği geçerli kod değişiklikleri tanımlamak ve sınamaları tarafından etkilenen bir listesini oluşturmak içinbu değişiklikler. Etkinlik etkilenen sınamaların listesini test ekip üyeleri bu yapı tamamlandıktan sonra çalıştırmaları gereken hangi sınamaları belirlemek amacıyla veri ambarına yazar. Ekip bu verileri nasıl kullanacakları hakkında daha fazla bilgi için bkz: Kod Değişikliklerinden Etkilenen Çalışma için Önerilen Testler.

Not

Bu etkinlik, iade gated yapılar veya Özel yapýlar etkisizdir.

Gerekli koşullar

GetImpactedTests Etkinlik yalnızca aşağıdaki koşullar geçerli olduğunda işlev:

Nasıl önceki yapı GetImpactedTests etkinliğini tanımlar

GetImpactedTests Etkinlik üreten sonuçlarını karşılaştırarak geçerli yapı için önceki bir yapı. Etkinliğini aşağıdaki işlemi kullanarak önceki yapı tanımlar:

  1. Belirtirseniz, BaselineBuildDropLocation özelliği, bu ikili dosyalar oluşturan yapı önceki yapı tanımlanır.

  2. Belirtmezseniz, BaselineBuildDropLocation özelliği, etkinliğini tanımlar önceki yapı aşağıdaki ölçütün tümüne uyan en son yapı veri ambarını arayarak:

    • Aynı yapı olan BuildDefinitionUri olarak geçerli bir yapı.

    • Status Yapı kalıyor ya da Succeeded veya PartiallySucceeded.

    • Yapı olan bir DropLocation.

    • Yapı gated iade yapı ya da özel bir yapı değil.

GetImpactedTests sonucu özellikleri

  • CodeChanges (CodeChangeList): Her yöntemin kodunuzda bu yapı ve önceki yapı arasında yapılan değişikliklerin listesini döndürür. Yöntemler Microsoft Intermediate language (MSIL) düzeyinde analiz edilir.

  • ImpactedTests (TestList): Önceki yapı ve bu yapı arasında kod değişikliklerden etkilenen sınamaları listesini döndürür.

GetImpactedTests Bağımsız değişkeni özellikleri

  • Misc

    • Yapı: Sağlamanız gerekir IBuildDetail nesnesi oluşturma. Kullanabileceğiniz GetBuildDetail bu nesne için bir başvuru almak için etkinlik.

  • Çeşitli konular

    • Derlemeler (IEnumerable<String>): Bu etkinliğini incelemek istediğiniz birleştirmeleri listesi belirtmeniz gerekir. Genellikle bu yapı Bu derlemeleri yerleşik.

    • AssociatedChangesets (IList<T><Changeset>): Sınama etkisi sonuçları ile ilişkilendirmek istediğiniz changesets belirtebilirsiniz. Genellikle, oluşturduğunuz changesets belirtmek istediğiniz. Bu changesets başvuru alabilirsiniz AssociateChangesetsAndWorkItems etkinliği.

    • BinariesRoot (String): Üzerinde sizin derlemeler bağımlı ikili dosyaların yolunu belirtmeniz gerekir. Bu değeri kullanarak alma GetBuildDirectory etkinliği.

    • Workspace (Workspace): Oluþturma çalışma başvuru sağlamanız gerekir. Bu başvurusundan elde edebilirsiniz sonucu özelliği CreateWorkspace etkinliği.

    • BaselineBuildDropLocation (String): İstediğiniz tamamlanan yapı içeren alt klasörü yolu belirtebilirsiniz GetImpactedTests aktiviteye karşılaştırmak için geçerli bir yapı. Bu özelliği belirtmezseniz, etkinliği önceki yapı oluþturma sistemi sorgulamaya çalışır. Daha fazla bilgi için bkz: "Nasıl GetImpactedTests etkinliğini tanımlayan önceki Build" Bu bölümün yukarısında.

Başa dön

Bir işlem (InvokeProcess etkinliğini) Başlat

Use InvokeProcess etkinlik (program Çalıştır) bir işlem başlatmak yapı sunucu. Bu aslında bir sarmalayıcı üzerinden etkinliktir Start.

InvokeProcess sonucu (Int32) özelliği

Döndürür ExitCode işlem.

InvokeProcess bağımsız değişkeni özellikleri

  • FileName (String): Belirtmeniz gerekir FileName (çalıştırmak istediğiniz programı) başlatmak istediğiniz işlemin. Örne?in: %ProgramFiles%\ContosoBuildUtils\MarkBins.exe.

  • Arguments (String): Komut satırı bağımsız değişkenleri belirtebilirsiniz (Arguments) işlem. geçirmek istediðiniz

  • EnvironmentVariables(IDictionary<TKey, TValue><String,String>): Ek ortam değişkenleri belirtebilirsiniz (EnvironmentVariables) ve bunların değerleri.

  • OutputEncoding (Encoding): Çıkış okumak için kullanılan kodlamayı belirtebilirsiniz (StandardOutputEncoding) ve hata (RedirectStandardError) akışları. Çoğu durumda, varsayılan değer bu özellik için en iyi değerdir:

    System.Text.Encoding.GetEncoding(System.Globalization.CultureInfo.InstalledUICulture.TextInfo.OEMCodePage)

  • WorkingDirectory (String): Çalışma dizinini belirtebilirsiniz (WorkingDirectory) işlemi çalıştırmak istediğiniz

    Örneğin, çalıştırmak isteyebilirsiniz sizin MarkBins.exe yardımcı programını karşı derlenmiş, ikili dosyalar. Yardımcı programın çalıştığı kapsamını daraltmak için tanrılara GetBuildDirectory ve sonucu bu özellikte.

İşleminizin standart çıktı ve hata çıktısı görüntülemek için

  1. De InvokeProcess etkinliği, çift görüntülemek için çift.

  2. Sürükle bir WriteBuildMessage Toolbox'dan faaliyet etkinliği altında görünecek şekilde Tanıtıcı standart çıktıve WriteBuildMessage ileti özelliğine stdOutput.

  3. Sürükle bir WriteBuildError etkinliği araç altında görünecek şekilde Tanıtıcı standart çıktıve WriteBuildMessage ileti özelliğine errOutput.

Sürüm denetimi ile çalışmak

Kullanabileceğiniz Team Foundation Yapısı aşağıdaki sürümü gerçekleştirilecek etkinlikleri denetlemek görevleri:

  • Changesets ilişkilendirmek ve yapı öğeleriyle çalışma

  • Gated değişiklikleri teslim et

  • İade ilkeleri değerlendir

  • Etiket dosyalarının sürüm denetimi

Changesets ve çalışma öğelerini (AssociateChangesetsAndWorkItems etkinliğini) yapı ile ilişkilendirme

Use AssociateChangesetsAndWorkItems Faaliyet kodu ve gitti tüm changesets ile tamamlanan her yapı bağlamak içinbunların ilişkili çalışma öğeleri.

Her yapı tanımı, hangi changesets ve iş öğeleri sonraki tamamlanan yapı ile ilişkili olmasını bekleyen kendi kaydını tutar. Örneğin, Build a ve b Build changeset 382 oluşturabilir. Build a atılmış ve başarıyla tamamlandı, ancak b Build kuyruğa atılmış bir uygulama ve başarısız olur. Changeset 382 şimdi başarıyla tamamlanmış bir yapı oluşturmak başarısız b. ile bağlantılı Changeset 382 sonraki tamamlanan build Build a ile bağlantılı olmayacaktır, ancak sonraki başarıyla tamamlanan derlemesi oluştur b. ile bağlanacak

AssociateChangesetsAndWorkItems sonucu (IList<T><Changeset>) özelliği

Yapı ile ilişkili changesets döndürür.

AssociateChangesetsAndWorkItems bağımsız değişkeni özellikleri

  • CurrentLabel (String): Bu özellik boş bırakın.

  • LastLabel (String): Bu özellik boş bırakın.

  • UpdateWorkItems (Boolean): Bu özelliğin değeri ayarlayabilirsiniz True doldurmak istiyorsanız, , Sabit alan yapı numarası ile ilişkili çalışma öğeleri. Aksi halde, değeri ayarlamak False.

Başa dön

Gated değişiklikleri (CheckInGatedChanges etkinliğini) denetleyin

Use CheckInGatedChanges etkinliğini denetlemek sürüm kontrolü için kod değişiklikleri tetikleyen bir gated iade yapı. Bu etkinlik de changesets ile ilişkili çalışma öğeleri Yapı ilişkilendirir.

Not

Düzgün çalışabilmesi için bu etkinlik tüm uygulamaları sonra yerleştirilmelidir MSBuild ve MSTest şablonunuzu faaliyetleri.

CheckInGatedChanges sonucu (Changeset) özelliği

İade değişiklikleri içeren changeset döndürür.

CheckInGatedChanges bağımsız değişkeni özellikleri

  • IgnoreErrors (Boolean): Bu özelliği ayarlamak False yalnızca denetlenecek dosyaların izin için CompilationStatus ve TestStatus Özellikler her iki değeri olan Succeeded. Bu özelliği ayarlamak True denetlenmesi değerlerini ne olursa olsun dosyalara izin vermek içinbu özellikleri.

    Not

    Kullanabileceğiniz SetBuildProperties ayarlamak için etkinlik CompilationStatus ve TestStatus özellikleri.

  • UpdateWorkItems (String): Bu değeri ayarlamak True doldurmak istiyorsanız, , Sabit alan yapı numarası ile ilişkili çalışma öğeleri. Aksi halde, onu ayarlamak False.

Başa dön

İade (EvaluateCheckInPolicies etkinliğini) ilkeleri değerlendir

Use EvaluateCheckInPolicies aktiviteye çalıştır onay ilkelerini oluşturma sunucusu. Bu faaliyetin zorla üzerinde belirtilen klasörlerde bulunan iade ilkeleri çalışır çalışma sekmesini yapı tanımı. İade ilkeleri başarısız olursa, oluşturma işlemi başarısız olur ve yapı nedeni ya da CheckInShelveset (bir gated iade yapı) veya ValidateShelveset (Özel Yapım).

Önemli

İade ilkeleri yapı sunucudaki geliştirici istemci bilgisayarda değil değerlendirilir.

Bu faaliyetin en etkili iade gated yapılar ile birlikte kullanarak daha güçlü kalite kapıları zorlamak için kullanılır. Faaliyeti bu şekilde kullanırsanız, kullanıcı iade ilkeleri atlayarak engellenir. Bu faaliyetin iade ilkeleri aşağıdaki türleri için kullanışlıdır:

  • Yerleşik Work Items İade İlkesi

  • Yapı sunucuda değerlendirilmesi için tasarlanmış özel iade ilkeleri

Bu etkinlik yerleşik değerlendirmek için yararlı değil Builds, Code Analysis, veya Testing Policy İade ilkeleri kullanılarak doğrudan işlemleri bir yapý daha verimli çalışabilir çünkü MSBuild ve MSTest etkinlikleri.

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

EvaluateCheckInPolicies bağımsız değişkeni özellikleri

  • Workspace (Workspace): Değerlendirmek istediğiniz çalışma alanı belirtmeniz gerekir. Çoğu durumda, bu özellik de bilgisine değişkenine ayarlamalısınız sonucu özelliği CreateWorkspace etkinliği. Temel alan bir işlemi oluşturma, DefaultTemplate.xaml, büyük olasılıkla kullanmanız gereken Workspace değişkeni.

Başa dön

Etiket dosyalarının sürüm denetimi

Dosyaları kullanarak etiket Team Foundation Yapısı Etkinlikler:

  • Oluşturmakta olduğunuz kaynak kodu etiket

  • Etiket dosyaları

(LabelWorkspace etkinliğini) kurduğunuz kaynak kodu etiket

Böylece her dosyanın hangi sürümünün belirli bir tamamlanan oluşturmaya dahil ekibinizin kolayca tanıyabileceğiniz kaynak kod sürüm denetim dosyalarında etiket. Use LabelWorkspace aktiviteye dahil bu adımı oluşturma işlemi.

LabelWorkspace bağımsız değişkeni özellikleri

  • Name (String): Etiket adı belirtmeniz gerekir.

  • Child (LabelChildOption): Belirttiğiniz etiketi eşleşen etiket olan öğeleri işlemesini belirtebilirsiniz. Bu özellik eşdeğerdir /child seçeneği tf label komut.

  • Workspace (Workspace): Bu yapı çalışma başvuru sağlamanız gerekir. Çoğu durumda, bu özellik de bilgisine değişkenine ayarlamalısınız sonucu özelliği CreateWorkspace etkinliği. Temel alan bir işlemi oluşturma, DefaultTemplate.xaml, büyük olasılıkla kullanmanız gereken Workspace değişkeni.

  • Comment (String): Etiket için bir açıklama belirtebilirsiniz. Bu özellik eşdeğerdir /comment seçeneği tf label komut.

  • Scope (String): Etiket kapsamı belirtebilirsiniz. Bu özellik eşdeğerdir @scope bağımsız değişkeni tf label komut.

Hakkında daha fazla bilgi için tf label parametreleri için bkz: Label Komutu (Team Foundation Sürüm Denetimi).

Başa dön

Etiket dosyalarını (LabelSources etkinliği)

Use LabelSources faaliyete etiket dosyalarının sürüm denetimi.

İpucuİpucu

Kaynağı kullanırsanız, daha etkili bir şekilde oluşturmakta olduğunuz kod dosyaları sık sık etiketleyebilirsiniz LabelWorkspace etkinliği.

LabelSources bağımsız değişkeni özellikleri

  • Items (IEnumerable<String>): Etiketlemek istediğiniz öğeleri belirtmeniz gerekir. Her String eşdeğeri olan bir itemspec bağımsız değişkeni tf label komut.

  • Name (String): Etiket adı belirtmeniz gerekir.

  • Scope (String): Etiket için bir kapsam belirtmeniz gerekir. Bu özellik eşdeğerdir @scope bağımsız değişkeni tf label komut.

  • Recursion (RecursionType): Belirtebileceğiniz Microsoft.TeamFoundation.VersionControl.Client.RecursionType.Full , istediğiniz etiket tüm dosyaların bir dizin hiyerarşisi. Aksi takdirde belirtmek Microsoft.TeamFoundation.VersionControl.Client.RecursionType.OneLevel.

  • Version (String): Etiketlemek istediğiniz öğeleri sürümünü belirtmeniz gerekir. Bu özellik eşdeğerdir /version seçeneği tf label komut.

  • Child (LabelChildOption): Belirttiğiniz etiketi eşleşen etiket olan öğeleri işlemesini belirtebilirsiniz. Bu özellik eşdeğerdir /child seçeneği tf label komut.

  • Comment (String): Etiket için bir açıklama belirtebilirsiniz. Bu özellik eşdeğerdir /comment seçeneği tf label komut.

Hakkında daha fazla bilgi için tf label parametreleri için bkz: Label Komutu (Team Foundation Sürüm Denetimi).

Başa dön

İş öğeleriyle çalışma

Çalışma öğelerini kullanarak çalışma Team Foundation Yapısı Etkinlikler:

  • Changesets ilişkilendirmek ve yapı öğeleriyle çalışma

  • İş öğesi oluşturma

İş öğesi (OpenWorkItem etkinliğini) oluşturma

Use OpenWorkItem etkinlik oluşturma bir iş öğesi.

OpenWorkItem sonucu (WorkItem) özelliği

Yeni iş öğesini döndürür.

OpenWorkItem bağımsız değişkeni özellikleri

  • AssignedTo (String): Çalışma öğesi atamak istediğiniz kişinin belirtmeniz gerekir.

  • Title (String): Çalışma öğesi adını belirtmeniz gerekir.

  • Type (String): Çalışma öğesi türünü belirtmeniz gerekir. Normal türü değerler aşağıdaki örnekler içerir: “Bug”, “Issue” ve “Task”.

  • Comment (String): Çalışma öğesi geçmiş için açıklama ekleyebilirsiniz.

  • CustomFields (IDictionary<TKey, TValue><String,String>): Diğer alanları bir veya daha fazla çalışma öğesinin değerini belirtebilirsiniz.

Başa dön

Sembol verilerle çalışma

İki kullanarak sembol verilerle çalışabilirsiniz Team Foundation Yapısı Etkinlikler: IndexSources ve PublishSymbols.

Bir normal Bu etkinliklerin IntelliTrace hata ayıklamayı etkinleştirmek için kullanılır. IntelliTrace hata ayıklamayı etkinleştirmek istiyorsanız, size çağırmalısınız IndexSources sembol verilerinizi sonra da hazırlamak için etkinlik çağrısı PublishSymbols SymStore sembol deposuna verileri yayımlamak için etkinlik.

IntelliTrace hata ayıklama hakkında daha fazla bilgi için bkz: IntelliTrace ile hata ayıklama.

Sürüm denetim yolları ve sürümleri pdb dosyalarınızı (IndexSources etkinliğini) simge verileri içine gömmek

Use IndexSources etkinlik katıştırmak sürüm denetim yolları ve sürümler simgesi verilerine .pdb dosyalarını.

IndexSources bağımsız değişkeni özellikleri

  • FileList (IEnumerable<String>): Her simge dosyasının adını ve tam yolunu belirtmeniz gerekir. Kullanabileceğiniz FindMatchingFiles bu değişkeni girmek için etkinlik.

    Kullanabileceğiniz ** yapmak için bir özyinelemeli arama. Örneğin, tanrılara FindMatchingFiles aşağıdaki değer MatchPattern özelliği: String.Format("{0}\**\*.pdb", BinariesDirectory).

Başa dön

Semboller SymStore sembol deposu (PublishSymbols etkinliğini) yayımlama

Use PublishSymbols etkinlik pdb dosyalarınız için Sembol verileri yayımlamak içinbir SymStore simgesi deposu. Bu aslında bir sarmalayıcı üzerinden etkinliktir SymStore.exe.

Önemli

Eşzamanlı yapılar aynı sembolleri dosya paylaşımına yayımlamaya çalışırsanız verileri bozuk. Bu riski azaltmak için bu etkinliğini çağırması gerekir içinde yalnızca bir SharedResourceScope etkinliği.

SymStore sembolü deposu hazırlamak

Kullanmaya başlamadan önce PublishSymbols etkinliği, SymStore sembolü deposu önce hazırlamak gerekir:

  1. Dosya paylaşım sunucusu simgeler depolamak için bir klasör ayarlama.

  2. GRANT Tam Denetim izinleri kullanıcı hesabı yapı aracı çalıştığı altında.

SymStore sembolü deposu hakkında daha fazla bilgi için Microsoft Web sitesinde aşağıdaki konulara bakın:

PublishSymbols sonucu (String) özelliği

İşlem kimliği verir SymStore.exe döndürür.

PublishSymbols bağımsız değişkeni özellikleri

  • FileList (IEnumerable<String>): Her simge dosyasının adını ve tam yolunu belirtmeniz gerekir. Kullanabileceğiniz FindMatchingFiles bu değişkeni girmek için etkinlik.

    Örneğin, tanrılara FindMatchingFiles aşağıdaki değer MatchPattern özelliği: String.Format("{0}\**\*.pdb", BinariesDirectory).

  • StorePath (String): SymStore sembolü deposunun kök klasörüne unc dosya yolu belirtmelisiniz.

  • CommandLineArguments (String): İçin iletebilirsiniz ek bağımsız değişkenler hakkında bilgi SymStore.exebakın SymStore komut satırı seçenekleri.

  • Comments (String): Sembol deposu işlem geçmişi dosyasında kaydedilen hareket yorumlar belirtebilirsiniz. Bu özellik eşdeğerdir /c Comment parametresi SymStore.exe komut. Daha fazla bilgi için bkz: SymStore komut satırı seçenekleri.

  • ProductName (String): Sembol deposu işlem geçmişi dosyasında kaydedilen ürün adı belirtebilirsiniz. Örneğin, yapı tanımı ada bu özelliği ayarlayabilirsiniz (Name), hangi elde edilemedi BuildDefinition çağırarak özellik GetBuildDetail. Bu özellik eşdeğerdir /t Product parametresi SymStore.exe komut. Daha fazla bilgi için bkz: SymStore komut satırı seçenekleri.

  • StoreCompressed (Boolean): Bu değeri ayarlamak True olarak sembol deposundaki dosyalar depolamak içinsıkıştırılmış dosyaları. Aksi takdirde dosyalar saklanır sıkıştırılmamış. Bu özellik eşdeğerdir /compress parametresi SymStore.exe komut. Daha fazla bilgi için bkz: SymStore komut satırı seçenekleri.

  • Version (String): Örneğin, yapı numarası bu özelliği ayarlayabilirsiniz (BuildNumber) çağırarak edinebileceğiniz GetBuildDetail. Bu özellik eşdeğerdir /v Version parametresi SymStore.exe komut. Daha fazla bilgi için bkz: SymStore komut satırı seçenekleri.

Başa dön

Yararlı nesnelere başvurular almak

Yararlı nesnelere başvurular kullanarak alma Team Foundation Yapısı etkinlikleri.

Bir ekip proje koleksiyonu (GetTeamProjectCollection etkinliğini) nesnesine bir başvuru almak

Kullanım GetTeamProjectCollection almak için etkinlik karşı kendi sonucu özelliği, başvuru bir TfsTeamProjectCollection nesne. Bu başlatıcı nesne önemlidir; Örneğin, bir uygulama katmanlı sunucusuna bağlanmak için kullanılabilmesi için Team Foundation.

IBuildAgent nesnesine (GetBuildAgent etkinliğini) Al

Kullanım GetBuildAgent almak için etkinlik karşı kendi sonucu özelliği, bir başvuru IBuildAgent nesne. Bu etkinliği yalnızca içinde kullanabileceğiniz bir AgentScope etkinliği.

IBuildDetail nesnesine (GetBuildDetail etkinliğini) Al

Kullanım GetBuildDetail etkinlik elde etmek için karşı kendi sonucu özelliği, bir başvuru IBuildDetail nesne. Bunu kullanabilirsiniz almak ve bazı durumlarda ayarlamak için nesne, geçerli ilgili veriler.

Başa dön

BuildEnvironment nesnesine (GetBuildEnvironment etkinliğini) Al

Kullanım GetBuildEnvironment etkinlik aracılığıyla almak için kendi sonucu özelliği, bir başvuru BuildEnvironment nesne. Genellikle aşağıdaki görevleri gerçekleştirmek için bu özelliği kullanabilirsiniz:

  • Use Environment nesnesi belirleme mi geçerli workflow parçasını çalışan yapı denetleyicisi veya yapı Aracısı.

  • Use CustomAssemblyPath nesnesine özel faaliyetler içeren derlemeler yolunun alınoluşturma Aracısı.

Başa dön

İşlem yeniden kullanmak üzere özel bir ilgisi yoktur etkinlikleri oluşturmak

Bazı etkinlikler kullanılmak üzere özel bir işlemi yapılmamıştır.

TfsBuild etkinlik

Bu faaliyetin yoksay. Yalnızca kullanılmak üzere varsa UpgradeTemplate.xaml. Bu etkinlik, özel yapım işleminde yeniden kullanım için tasarlanmamıştır.

CreateWorkspace etkinliği

Muhtemelen hiçbir zaman oluşturmak veya bir örneğini değiştirmek gerekir CreateWorkspace etkinliği. Bir veya daha fazla ek çalışma gerektiren bir işlemi tasarlıyorsanız, bu amacı gerçekleştirmek için özel bir aktivite oluşturmanız gerekir.

Diğer çalışma faaliyetleri

Yapı işlem şablonu Bu etkinlikler aynı kullanabilecek şekilde o DefaultTemplatate.xaml bunları kullanır. Ancak bir çalışma alanı oluşturmak için özel bir etkinlik geliştirme sürece, büyük olasılıkla hiçbir zaman oluşturmak veya bir çalışma alanında özel yapý işlem şablonu örneğini değiştirmek gerekir.

DeleteWorkspace

Başa dön

GetWorkspace

Başa dön

RevertWorkspace

Başa dön

SyncWorkspace

Başa dön

Ayrıca bkz.

Görevler

Yapılandırma Aracıları Oluşturma ve Onlarla Çalışma

Derleme sonuçları penceresini görüntülemek

Kavramlar

Varsayılan şablonu kullanarak bir yapı tanımlar

Yapı Denetleyicisi Oluşturun ve Birlikte Çalışın

Diğer Kaynaklar

Visual Studio 2010 Workflow Designer

Windows Workflow Foundation

MSBuild Başvuru