Team Foundation Aktivite Oluştur
Team Foundation Yapısı faaliyetleri Team Foundation Yapısı sisteminizdeki derleme işlemenizin temel bileşenleridir. Bu faaliyetleri, özel mantık izlemek veya belirli görevleri gerçekleştirme gibi takım gereksinimlerini karşılamak üzere özel derleme işlemi oluşturmak için kullanabilirsiniz.
Çoğu durumda, özel derleme işlem şablonu oluşturmanın en yolu onu Varsayılan Şablon üzerinde temellendirmektir (DefaultTemplate.xaml). Bu şekilde, gereksinimlerinizi karşılamak için belirli bölümleri özelleştirme sırasında önceden oluşturulmuş genelde kullanışlı işlevlerden yararlanabilirsiniz. Bu yaklaşımın bir diğer avantajı ise, bu konuda açıklanan etkinlikleri nasıl kullanacağınız hakkında özel ve pratik örnekleri görebilmenizdir. Bir derleme işlemi şablonu oluşturmayla ilgili daha fazla bilgi için bkz. Oluşturma ve özel yapı işlem şablonu ile çalışma.
Önemli
Yalnızca, özel gereksinimleri karşılamanız gerekiyorsa, özel derleme işlemi oluşturmanız gerekir.Birçok tipik gereksinimi karşılayan derleme işlemini hızlıca tanımlamak için DefaultTemplate.xaml 'ı kullanabilirsiniz.Daha fazla bilgi için bkz. Varsayılan şablonu temel yapı işlemi tanımla.
Bu konuda
Gerekli İzinler (Bu sayfa İngilizce içeriğe sahip olabilir)
Faaliyetlere amaç yönelimli referans
Etkinliklere alfabetik referans
Gerekli izinler
Team Foundation Yapısı etkinliklerini kullanan yordamları gerçekleştirmek için, aşağıdaki etkinliklerin İzin Ver 'e ayarlamanız gerekmektedir:
Yapı tanımını düzenle
Alakalı sürüm kontrol dizinleri için Çıkış Yapın ve Giriş Yapın (Ekip projenizin BuildProcessTemplates alt dizini gibi)
Derlemeyi sıraya al.
Daha fazla bilgi için bkz. Takım Kuruluş Sunucusu İzinleri.
Faaliyetlere amaç yönelimli referans
Temel görevleri gerçekleştirin
Ortam değişkenlerinin değerlerini al
Tanımlanmamış Değerler için Sınama Değişkenleri
Çalışma alanındaki dosyalara olan yolları alın
Dizinler ile çalışın
Derleme aracısı çalışma dizinine olan yol alın
Çalışma alanında olmayan dosyaları karşıdan yükleyin
Dosyaları bulun
Uyarıları, hataları, iletileri ve diğer verileri oluşturma günlüğünde yazın
Derleme meta verilerini veri ambarına yazın
Derleme İşlemini Denetleyin
Etkinlikleri derleme aracısında çalıştırın
Güvenli dizi işlemini yürütmek için adlandırılmış mutex yapısını kullanın
Nedene (tetikleyici) dayanan derleme sürecinizin bölümlerini sınırlayın
Diğer görevleri derleyin, sınayın ve gerçekleştirin
İkili dosyaları derlemek, kodu çözümlemesini çalıştırmak ve diğer görevleri gerçekleştirmek için MSBuild'i kullanın
Testleri Çalıştırma
Derlemenin etkilediği sınamaların listesini alın
Bir işlem başlatın
Sürüm Denetimiyle çalışın.
Değişiklik kümesini ve çalışma öğelerini derleme ile ilişkilendirin
Geçitli değişiklikleri kaydet
Kayıt ilkelerini değerlendirin
Sürüm kontrolündeki dosyaları etiketleyin
Shelvesets listesini alın
TfGet
TfResolve
TfShelve
TfUndo
TfUnshelve
TfWorkfold
İş öğeleriyle çalışma
Değişiklik kümesini ve çalışma öğelerini derleme ile ilişkilendirin
İş öğesi oluşturma
Sembol verileri ile çalışın
Sürüm kontrol yollarını ve sürümleri .pdb dosyalarınızdaki sembol verilerinizin içine gömün
Sembolleri SymStore sembol deposunda yayımlayın
Yararlı Nesnelere Başvurular alın
Ekip proje koleksiyonu için bir nesneye bir başvuru alın
Bir derleme aracısı için bir nesneye başvuru alın
Bir derleme özeti için bir nesneye başvuru alın
Bir derleme çevresi için bir nesneye başvuru alın
Etkinliklere alfabetik referans
AgentScope
ApproveRequestForCheckIn
AssociateChangesetsAndWorkItems
CheckInGatedChanges
ConvertWorkspaceItem
ConvertWorkspaceItems
CopyDirectory
CreateDirectory
CreateWorkspace
DeleteDirectory
DeleteWorkspace
DownloadFile
DownloadFiles
EvaluateCheckInPolicies
ExpandEnvironmentVariables
FindMatchingFiles
GenerateRunSettings
GetApprovedRequests
GetBuildAgent
GetBuildDetail
GetBuildDirectory
GetBuildEnvironment
GetCommonLocalPath
GetCommonServerPath
GetImpactedTests
GetPendingChanges
GetRejectedRequests
GetReshelvedShelveset
GetShelvedChanges
GetTeamProjectCollection
GetWorkspace
IndexSources
InvokeForReason
InvokeProcess
IsNotNull<T>
IsNull<T>
LabelSources
LabelWorkspace
MSBuild
MSTest
OpenWorkItem
ParseWorkspaceSpec
PublishSymbols
QueryShelvesets
RejectRequestFromCheckIn
RetryRequest
RetryRequests
RevertWorkspace
RunOnce
RunTests
SetBuildProperties
SharedResourceScope
SyncWorkspace
SynchronizeRequests
TfGet
TfQueryConflicts
TfResolve
TfShelve
TfUndo
TfUnshelve
TfWorkfold
TfsBuild
UpdateBuildNumber
WriteBuildError
WriteBuildInformation<T>
WriteBuildMessage
WriteBuildTestError
WriteBuildWarning
Özel Özet Bilgisini Yaz
Temel görevleri gerçekleştirin
Aşağıdaki görevleri gerçekleştirmek için Team Foundation Yapısı etkinliklerini kullanabilirsiniz:
Ortam değişkenlerinin değerlerini al
Çalışma alanındaki dosyalara olan yolları alın
Dizinler ile çalışın
Derleme aracısı çalışma dizinine olan yol alın
Çalışma alanında olmayan dosyaları karşıdan yükleyin
Dosyaları bulun
Uyarıları, hataları, iletileri ve diğer verileri oluşturma günlüğünde yazın
Derleme hakkındaki meta verileri yazın
Ortam değişkenlerinin (ExpandEnvironmentVariables etkinliği) değerlerini alın
Derleme sunucusundaki bir ya da daha fazla ortam değişkenlerini çözmek için ExpandEnvironmentVariables kullanın. Eğer bu etkinlik AgentScope serisi içinde ise ortam değişkenleri derleme aracısında okunur; aksi takdirde, derleme denetleyicisinde okunurlar.
ExpandEnvironmentVariables Sonucu (String) Özellik
İşlemin sonucu. Ö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
Girdi (String): Çözmek istediğiniz ortam değişkenlerini içeren dizeyi belirtmeniz gerekir. Her ortam değişkenini Windows yüzdelik sembol gösterimini kullanmak yerine MSBuild özelliğini belirterek biçimlendirmelisiniz. Örneğin: "The temporary directory on machine $(COMPUTERNAME) is $(TEMP)."
AdditionalVariables (IDictionary<TKey, TValue><String,String>): Karşılık gelen değerlerine çözmek istediğiniz herhangi bir ek değişkeni (anahtar olarak) taşıyan IDictionary nesnesini belirtebilirsiniz.
Başa dön
Tanımlanmamış Değerler için Sınama Değişkenleri
IsNotNull<T>
Değer 'de (Object) sağladığınız Visual Basic anlatımının Null olup olmadığını sınamak için IsNotNull<T> etkinliğini kullanın. Testin sonucunu Sonucu Boolean özelliğinde döner.
IsNull<T>
Değer 'de (Object) sağladığınız Visual Basic anlatımının Null olup olmadığını sınamak için IsNotNull<T> etkinliğini kullanın. Testin sonucunu Sonucu Boolean özelliğinde döner.
Çalışma alanındaki dosyalara olan yolları alın
Her derleme, derleme tanımının Çalışma Alanı sekmesinde tanımlı sürüm denetim çalışma alanına sahiptir Çalışma alanı kaynak kod dosyaları ve ihtiyacı olan diğer dosyalarına erişim ile birlikte derlemeyi sürüm denetim sisteminden sağlar. Team Foundation Yapısı , derleme çalışma alanında bulunan dosyalarla çalışmak için kullanabileceğiniz iki etkinliği sağlar: ConvertWorkspaceItemve ConvertWorkspaceItems .
Derleme çalışma alanları hakkında daha fazla bilgi için bkz: Yapı Tanımları Oluşturma .
İpucu
Tipik bir senaryoda ConvertWorkspaceItem etkinliğinin nasıl kullanılacağı hakkında ayrıntılı adım adım kılavuz için, bkz. Burada oluþturma sistemi, ikili dosyalar yerleştirir kontrol .
Çalışma alanındaki (ConvertWorkspaceItem etkinliği) dosyasının yolunu al
Derleme aracısındaki sunucu yolunu yerel yola çevirmek ya da derleme aracısındaki yerel yolu sunucu yoluna çevirmek için ConvertWorkspaceItem etkinliğini kullanın.
ConvertWorkspaceItem Sonucu (String) Özelliği
Dönüştürülen yolu döndürür.
ConvertWorkspaceItem Bağımsız Değişkeni Özellikleri
Girdi (String): Dönüştürmek istediğiniz yol değerini belirtmeniz gerekir.
Çalışma Alanı (Workspace): Dosyayı içeren Workspace öğesine başvuru sağlamanız gerekir. Çoğu durumda, bu özelliği CreateWorkspace etkinliğinin Sonuç özelliği içinde başlattığınız değere ayarlamanız gerekir. DefaultTemplate.xaml 'de temellenmiş bir derleme işlemi oluşturuyorsanız,büyük olasılıkla Workspace değişkenini kullanmanız gerekir.
Yön
Sunucu yolunu yerel bir yola dönüştür: Yön özelliği içinde ServerToLocal öğesini seçin ve sonra yolu sunucu üzerinde Girdi (String) özelliği içindeki dosyaya belirtin.
Örneğin, ekibiniz genel yardımdı gereksinimleri aşağıdaki dizine depolayabilir: $/OurTeam/BuildProcess/Util . İkili dosyalarınız derlendikten sonra ScanBinaries.exe yardımcı programını yürüten özel derleme işlemini oluşturabilirsiniz. Eğer $/OurTeam/BuildProcess/Util , derleme tanımınızın Çalışma Alanı sekmesi üzerinde eşlenmişse, Sonuç (String) özelliğinden yardımcı programa yerel yol almak için Girdi özelliği içinde $/OurTeam/BuildProcess/Util/ScanBinaries.exe öğesini belirtebilirsiniz.
Sunucu yolunu yerel bir yola dönüştür: Yön özelliği içinde ServerToLocal öğesini seçin ve sonra yolu sunucu üzerinde Girdi özelliği içindeki dosyaya belirtin.
Çalışma alanındaki (ConvertWorkspaceItems etkinliği) dosyalara olan yolları alın
Derleme aracısındaki sunucu yolunu yerel yola çevirmek ya da derleme aracısındaki yerel yolu sunucu yoluna çevirmek için ConvertWorkspaceItems etkinliğini kullanın.
ConvertWorkspaceItem Sonucu (IList<String>) Özelliği
Dönüştürülen yol değerlerini döndürür.
ConvertWorkspaceItems Bağımsız Değişkeni Özellikleri
Girdi (IEnumerable<T><String>): Dönüştürmek istediğiniz yol değerini belirtmeniz gerekir.
Çalışma Alanı (Workspace): Dosyayı içeren Workspace öğesine başvuru sağlamanız gerekir. Çoğu durumda, bu özelliği CreateWorkspace etkinliğinin Sonuç özelliği içinde başlattığınız değere ayarlamanız gerekir.
İpucu
DefaultTemplate.xaml 'de temellenmiş bir derleme işlemi oluşturuyorsanız,büyük olasılıkla Workspace değişkenini kullanmanız gerekir.
Yön: Aşağıdaki değerlerden birini seçin:
Eğer Girdi özelliği içindeki sunucu yol değerlerinin topluluğunu belirtiyorsanız ve Sonuç özelliğinin yerel yol değerleri dönmesini istiyorsanız ServerToLocal öğesini seçin.
Eğer Girdi özelliği içindeki sunucu yol değerlerinin topluluğunu belirtiyorsanız ve Sonuç özelliğinin yerel yol değerleri dönmesini istiyorsanız LocalToServer öğesini seçin.
Dizinler ile çalışın
Team Foundation Yapısı içerisindeki birkaç etkinliği kullanarak dizinlerle çalışabilirsiniz.
İpucu
Derlemenizin sürüm denetimi çalışma alanının bir parçası olan dizinler ile çalışmanız gerekiyorsa, bunun yerine çalışma alanı faaliyetleri kullanmanız gerekir.Daha fazla bilgi için bkz: Çalışma Alanındaki Dosyalara olan Yolları Alın.
Bir dizin oluşturun (CreateDirectory etkinliği)
Dizin (String) özelliğinde belirttiğiniz isimde bir dizin oluşturmak için CreateDirectory etkinliğini kullanın.
Bir dizin (CopyDirectory etkinliği) kopyalayın
Bütün içeriği Kaynak (String) özelliğinde belirttiğiniz bir dizinden, Hedef (String) özelliğinde belirttiğiniz bir diğer dizine tekrar tekrar kopyalamak için CopyDirectory etkinliğini kullanın. Hedef özelliğinde belirttiğiniz dizin önceden mevcut olmalıdır. Boş dizinler veya alt dizinler kopyalanmaz.
Bir dizini (DeleteDirectory etkinliği) silin
Dizin (String) özelliğinde belirttiğiniz isimde bir dizini silmek için DeleteDirectory etkinliğini kullanın. Silmekte olduğunuz dizin alt dizinler içeriyorsa, Yinelenmeli (Boolean) özelliğini True özelliğine ayarlamalısınız; aksi takdirde derleme başarısız olur.
Derleme Aracısı Çalışma Alanını Dizinine olan Yolu (GetBuildDirectory etkinliği) alın
Sonuç (String) özelliğinden, derleme aracısının çalışma dizinine olan değişmez yolu almak için GetBuildDirectory etkinliğini kullanın. Bu etkinliği yalnızca AgentScope etkinliği içerisinde kullanabilirsiniz.
Başa dön
Yol verilerini işleyin
GetCommonLocalPath etkinliği
Bir ya da daha fazla yerel klasörün en düşük seviye ortak üst klasörüne olan yolu almak için GetCommonLocalPath etkinliğini kullanın. Örneğin, bunlar gibi LocalItems (IEnumerable<String>) belirtirseniz:
{“c:\Code\Fabrikam-3\TestScrum\Main\FabrikamFiber.CallCenter”, “c:\Code\Fabrikam-3\TestScrum\Main\lib”}
Ardından Sonuç (String) bunları döndürecektir:
c:\Code\Fabrikam-3\TestScrum\Main
GetCommonServerPath etkinliği
Bir ya da daha fazla yerel klasörün en düşük seviye ortak üst klasörüne olan yolu almak için GetCommonServerPath etkinliğini kullanın. Örneğin, bunlar gibi ServerItems (IEnumerable<String>) belirtirseniz:
{“$/TestScrum/Main/FabrikamFiber.CallCenter”, “$/TestScrum/Main/lib”}
Ardından Sonuç (String) bunları döndürecektir:
$/TestScrum/Main
Çalışma alanında olmayan dosyaları karşıdan yükleyin
Bir veya daha fazla dosyaları karşıdan yüklemek için DownloadFiles etkinliğini kullanın. DownloadFile etkinliğini göz ardı edin.
DownloadFiles etkinliği
Bir veya daha fazla dosyayı sürüm denetiminde yüklemek için DownloadFiles etkinliğini kullanın.
İpucu
Karşıdan yüklemek istediğiniz dosyalar derleme çalışma alanındaysa, büyük olasılıkla bunlara ConvertWorkspaceItem etkinliğini kullanarak erişebilirsiniz.
DownloadFiles Bağımsız Değişkeni Özellikleri
LocalPath (String) Bir değer belirtmeniz gerekir:
Tek bir dosyayı karşıdan yüklüyorsanız, yerel yolu ve karşıdan yüklediğiniz dosyanın yerel kopyasına vermek istediğiniz adı belirtin; örneğin, "c:\Docs\readme.txt" .
Birden çok dosyayı karşıdan yüklüyorsanız, dosyaları indirmek istediğiniz dizine olan yerel yolu belirtin; örneğin, "c:\Docs\"..
ServerPath (String) Bir değer 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 dizine olan sunucu yolunu belirtin; örneğin, "$/Docs/".
Yinelenme (RecursionType):
OneLevel: ServerPath özelliğinde belirttiğiniz dizinde dosya veya dosyalar indirir.
Full: ServerPath özelliğinde belirttiğiniz dizinde dosyalar ve tüm alt dizinlerinde tüm dosyaları indirir.
Sürüm (String): Bir versionspec belirtebilirsiniz. Geçerli sürümünü karşıdan yüklemek için bu özelliği Microsoft.TeamFoundation.VersionControl.Client.VersionSpec.Latest.DisplayString öğesine ayarlı olarak bırakın. Temsilciler hakkında daha fazla bilgi için bkz. Komut satırı sözdizimi.
DeletionID (Int32): Bu özelliği sadece sürüm denetimden silinmiş dosyayı indiriyorsanız belirtebilirsiniz. Bu değeri komut isteminde tf dir /deleted öğesini yazarak etkileşimli olarak alabilirsiniz. (Daha fazla bilgi için bkz. Dir Command). Ancak, Team Foundation Yapısı , DeletionID'yi elde etmek için yerleşik bir etkinlik sağlamaz. Bu özelliği kullanmak için bu işlevi sağlayan özel bir faaliyet oluşturmanız ya da elde etmeniz gerekir.
Başa dön
DownloadFile etkinliği
DownloadFile etkinliğini göz ardı edin. DownloadFiles etkinliği bir veya daha fazla dosyayı karşıdan yüklemek için en kolay yoldur.
Dosyaları bulun (FindMatchingFiles etkinliği)
Dosyaları bulmak için FindMatchingFiles etkinliğini kullanın. MatchPattern (String) özelliğinde arama ölçütlerini belirtin. Bu özellikte, aşağıdaki öğeleri içeren bir bağımsız değişken belirtebilirsiniz:
Directory GetFiles(String, String) yönteminin searchPattern bağımsız değişkeni tarafından desteklenen sözdizimi.
Yinelemeli arama belirtmek için ** . Örne?in:
Metin dosyaları için kaynaklar dizininde arama yapmak için MatchPattern özelliği için aşağıdaki değere benzeyen bir şey belirtebilirsiniz: String.Format("{0}\**\*.txt", SourcesDirectory) .
txtfiles olarak bilinen bir ya da daha fazla alt dizinde metin dosyaları için kaynak dizinini aramak amaçlı MatchPattern özelliği için aşağıdaki değere benzeyen bir şey belirtebilirsiniz: String.Format("{0}\**\txtfiles\*.txt", SourcesDirectory).
Sonuç (IEnumerable<T><String>) özelliğindeki işlemin sonucunu toplarsınız.
Uyarıları, hataları, iletileri ve diğer verileri oluşturma günlüğünde yazın
Özel Özet Bilgisini Yaz
Derleme sonuç penceresinde kullanıcılara gösterilen derleme özetinin içine ileti yazmak için WriteCustomSummaryInformation etkinliğini kullanın.
WriteCustomSummaryInformation Bağımsız Değişkeni Özellikleri
İleti (String): Derleme özetinde görüntülenmesini istediğiniz iletiyi belirtmeniz gerekir.
Aşağıdaki söz dizimlerinden birini kullanarak ileti içine köprüler dahil edebilirsiniz:
[link text](url) [link text] (url)
Örne?in:
For the latest operation status, see [Fabrikam Fiber Ops] (http://intranet.fabrikam.com/ops/status).
SectionDisplayName (String): İletinin gösterilmesini istediğiniz bölümün adını belirtmeniz gerekir. Aynı SectionKey değerine sahip birden çok WriteCustomSummaryInformation örneği farklı SectionDisplayName değeri belirtiyorsa sistem derleme işlem şablonundaki ilk örneğin SectionDisplayName 'ini kullanır.
SectionKey (String): İletinin gösterilmesini istediğiniz bölümün adı için tanımlayıcı belirtmeniz gerekir. Belirttiğiniz değerle, NameProperty içinde açıklanan kurallar uymak zorundadır.
Örneğin, eğer WriteCustomSummaryInformation kodunun iki örneği ile birlikte “MySection” kodunun SectionKey değerini derlerseniz, derlemenizi işlendiğinde iki ileti de derleme özetindeki aynı bölümde görünecektir.
SectionPriority (Int32): Derleme özetinde ki bölümün alakalı konumunu belirleyen bölümün önceliğini belirtebilirsiniz. Değer ne kadar düşükse bölümün görüneceği özette o kadar yüksek olur. Aynı SectionKey değerine sahip birden çok WriteCustomSummaryInformation örneği farklı SectionPriority değeri belirtiyorsa sistem derleme işlem şablonundaki ilk örneğin SectionPriority 'sini kullanır.
Başa dön
WriteBuildMessage etkinliği
Derleme günlüğünde bilgilendirici ileti yazmak için WriteBuildMessage etkinliğini kullanın. İletiyi, İleti (String) özelliğinde belirtmelisiniz. Ayrıca iletinin önemini, Önem özelliğinin (BuildMessageImportance) değerini değiştirerek gösterebilirsiniz.
İpucu
-
Derleme süreciniz kullanıcıları hem ne görmeleri gerekenle hem de ambarda depolanan verilerle bilgi fazlalığını azaltmak için ayrıntı düzeyi filtrelemesini dikkate alabilirler.Derleme iletilerinin Önem özelliğini ayarlamaya düşünceli ve tutarlı bir yaklaşım kullanarak bu filtrelemeyi daha etkili yapmaya yardım edebilirsiniz.Daha fazla bilgi için bkz. Yapı bilgileri ve ayrıntı denetimini yönetme.
-
Varsayılan ayarları kullanıyorsanız, iletiniz derleme günlüğüne yazılmayacak.Bu sorunu gidermek için aşağıdaki adımlardan birini gerçekleştirin:
-
WriteBuildMessage Önem özelliğini, Microsoft.TeamFoundation.Build.Client.BuildMessageImportance.High 'e ayarlayın.
-
Derleme tanımının İşlem sekmesi üzerinde, Günlük Ayrıntı Düzeyini işlem parametresini Detailed veya Diagnostic öğesine ayarlayın.
-
WriteBuildWarning etkinliği
Derleme günlüğünde uyarı iletisi yazmak için WriteBuildWarning etkinliğini kullanın. Uyarılar derleme işlem penceresinde sarı ünlem işaretiyle görünür. İletiyi, İleti (String) özelliğinde belirtmelisiniz.
Derleme uyarılarınız yalnızca ekibiniz ayrıntı düzeyini en az ya da daha yükseğe ayarladığında kaydedilir. Daha fazla bilgi için bkz. Yapı bilgileri ve ayrıntı denetimini yönetme.
WriteBuildError etkinliği
Derleme günlüğünde derleme hata iletisi yazmak için WriteBuildError etkinliğini kullanın. Derleme sonuçları penceresinde kırmızı bir ünlem işaretiyle hatalar görüntülenir. Bir hata derleme günlüğüne yazıldığında, derleme en iyi şekilde Partially Succeeded olarak sınıflandırılır. İletiyi, İleti (String) özelliğinde belirtmelisiniz.
Hatalar her zaman, ayrıntı düzeyi ayarından bağımsız olarak günlüğe kaydedilir. Daha fazla bilgi için bkz. Yapı bilgileri ve ayrıntı denetimini yönetme.
WriteBuildTestError etkinliği
Derleme günlüğünde sınama hata iletisi yazmak için WriteBuildTestError etkinliğini kullanın. Derleme sonuçları penceresinde kırmızı bir ünlem işaretiyle hatalar görüntülenir. Bir hata derleme günlüğüne yazıldığında, derleme en iyi şekilde Partially Succeeded olarak sınıflandırılır. İletiyi, İleti (String) özelliğinde belirtmelisiniz.
Hatalar her zaman, ayrıntı düzeyi ayarından bağımsız olarak günlüğe kaydedilir. Daha fazla bilgi için bkz. Yapı bilgileri ve ayrıntı denetimini yönetme.
WriteBuildInformation <T> etkinliği
Derleme günlüğüne nesne koymak için WriteBuildInformation<T> etkinliğini kullanın. Kullanıcı derleme sonuçları penceresinde günlüğü görüntülediğinde nesne yansıtma kullanarak işlenir.
WriteBuildInformation<T> Bağımsız Değişkeni Özellikleri
Değer (Object): Derleme günlüğüne yerleştirmek istediğiniz nesneyi belirtmeniz gerekir. Derleme sonuçları penceresinde işlenecek nesneniz için nesne IBuildInformationNode öğesini uygulamalı ve Type 'ı aşağıdaki InformationTypes değerlerinden birine ayarlamalısınız:
ActivityProperties
ActivityTracking
AgentScopeActivityTracking
BuildError
BuildMessage
BuildProject
BuildStep
BuildWarning
ExternalLink
OpenedWorkItem
ParentToBuildDetail: bu nesnenin üstünü bu etkinliğin üstü yapmak için False öğesini belirtebilirsiniz yada üstü IBuildDetail nesnesi yapmak için True öğesini belirtebilirsiniz.
Bu özelliğin bir etkisi bilginin derleme sonuç penceresinde nasıl göründüğüdür. False 'u belirtirseniz, bilgiler WriteBuildInformation<T> etkinliğinden hem önce sonra ve aynı düzeyde olan diğer etkinliklerden gelen çıktıyla birlikte hizalanır ve girintilendirilir. True öğesini belirtirseniz, bilgi girintilenmez.
Başa dön
Derleme meta verilerini Veri Ambarına yazın
Veri ambarına meta veriler hakkında yazabilirsiniz:
Derleme Numarasını (UpdateBuildNumber etkinliği) yazın
Derleme (SetBuildProperties etkinliği) hakkındaki Anahtar Veri Noktaları yazın
İpucu
Bu etkinlikler yazmak istediğiniz meta verileri desteklemiyorsa IBuildDetail nesnesine bir başvuru almak ve daha sonrada bu başvuruyu kullanarak verileri doğruca nesneye atamak için GetBuildDetail etkinliğini kullanabilirsiniz.
Derleme Numarasını (UpdateBuildNumber etkinliği) yazın
Derlemenin derleme numarasını (ya da adını) ayarlamak için UpdateBuildNumber etkinliğini kullanın. Bu etkinlik aşağıdaki adımları gerçekleştirir:
Derleme numarası biçimini belirleyen bir ifadeye dayalı bir derleme numarası oluşturur. Derleme işleminiz, derleme tanımının İşlem sekmesi üzerindeki parametre tarafından sağlanan bir iş akışı bağımsız değişkeninden bu ifadeyi genellikle kabul eder.
Sonuç değerini BuildNumber özelliğine yazarak derlemenin derleme numarasını (ya da adını) ayarlar.
UpdateBuildNumber Sonucu (String) Özelliği
Sonuç: Yeni BuildNumber değerini döndürür.
UpdateBuildNumber Özellikleri
- BuildNumberFormat (String): Derleme sayılarının biçimini belirten bir ifade sağlamanız gerekir. Bu ifadenin söz dizimi hakkında daha fazla bilgi için bkz. Yapı numaraları ile çalışmak.
Başa dön
Derleme (SetBuildProperties etkinliği) hakkındaki Anahtar Veri Noktaları yazın
Veri ambarındaki her derleme hakkındaki verilerin depolamasını yöneten IBuildDetail nesnesine anahtar veri noktaları yazmak için SetBuildProperties kullanın. Bu verilerin çoğu kullanıcıya derleme sonuçları penceresinde görüntülenir.
SetBuildProperties Özellikleri
PropertiesToSet: Ayarlamak istediğiniz özelliklerin adları için onay kutularını seçmelisiniz.
BuildNumber (String): Derlemenin, derleme ismi olarak düşünebileceğiniz BuildNumber öğesini ayarlayabilirsiniz.
İpucu
Bu değeri derleme tanımının İşlem sekmesi üzerindeki kullanıcı tarafından belirtilen ayarlara dayanacak şekilde ayarlamak istiyorsanız muhtemelen bu özellik yerine UpdateBuildNumber etkinliğini kullanmanız gerekir.
CompilationStatus (BuildPhaseStatus): Derleme durumunu ayarlayabilirsiniz (CompilationStatus). ( MSBuild etkinliği bu değeri ayrıca otomatik olarak da ayarlar.)
DropLocation (String): Bırakma konumunu DropLocation özelliğinde kaydedebilirsiniz.
Not
Bu özelliği ayarlarsanız, aslında bırakma konumunu oluşturmazsınız.Bunun yerine, bu özelliği CreateDirectory etkinliğini kullanarak oluşturduğunuz bırakma klasörünün konumu olan veri ambarına depolamak için kullanırsınız.
KeepForever (Boolean): derleme tanımının Bekletme ilkesini sekmesi üzerindeki ayarları atlamak ve tamamlanan derlemeyi sonsuza kadar saklamak istiyorsanız KeepForever özelliğini True 'ya ayarlayabilirsiniz.
LabelName (String): LabelName özelliğini, sürüm kontrolündeki kaynak kodu dosyaları üzerinde bu derlemeyi işaretlemek için kullanılan etiketini kaydetmek için kullanabilirsiniz. Bu özelliği genellikle LabelWorkspace etkinliğinin Ad özelliğindeki değerle eşleşmesi için ayarlarsınız.
Önemli
Team Foundation Yapısı derlemeyi değişiklik kümeleri ve çalışma öğeleriyle ilişkilendirmek için bu verilere ihtiyaç duyar.Bu verileri sağlamazsanız, AssociateChangesetsAndWorkItems etkinliği başarısız olur.
LogLocation (String): LogLocation özelliğini derleme işleminizin günlük dosyasını koyduğu klasöre olan UNC dosya yolunu kaydetmek için kullanabilirsiniz.
Not
Büyük olasılıkla özel derleme sürecinizde bu özelliği kullanmanız gerekmez.Bu özellik eski derleme işlemlerini desteklemek için öncelikli olarak UpgradeTemplate.xaml dosyası tarafından kullanıma yöneliktir.
Quality (String): Quality özelliğinde derlemenin kalitesini kaydedebilirsiniz.
SourceGetVersion (String): Bu derleme için alınmış kaynaklar için olan sürüm belirtimini kaydetmek için SourceGetVersion özelliğini kullanabilirsiniz.
Durum (BuildStatus): Derlemenin genel durumunu Status özelliğinde kaydedebilirsiniz. Örneğin, derlemenin başarılı veya başarısız olduğunu yada olmadığını belirtmek için bu özelliği kullanabilirsiniz.
TestStatus (BuildPhaseStatus): Bu derlemede çalışan sınamanın genel durumunu kaydetmek için TestStatus özelliğini kullanabilirsiniz.. Örneğin, bu derleme üzerinde çalıştırdığınız sınamaların başarılı veya başarısız olduğunu belirtmek için bu özelliği kullanabilirsiniz.
Başa dön
Derleme İşlemini Denetleyin
Derleme işlemini aşağıdaki yollarla denetlemek için Team Foundation Yapısı etkinliğini kullanabilirsiniz:
Etkinlikleri derleme aracısında çalıştırın
Güvenli dizi işlemini yürütmek için adlandırılmış mutex yapısını kullanın
Nedene (tetikleyici) dayanan derleme sürecinizin bölümlerini sınırlayın
Etkinlikleri derleme aracısında (AgentScope etkinliği) çalıştırın
Derleme aracısında çalıştırmak istediğiniz derleme işleminizin parçalarını çevrelemek için AgentScope etkinliğini kullanın.
AgentScope Bağımsız Değişkeni Özellikleri
Aracı Seçimi
MaxWaitTime (TimeSpan): Derleme işlemi derleme aracısının uygun olmasını beklediği en uzun süreyi belirtebilirsiniz. Bir değeri ss:dd:ss biçiminde yazabilirsiniz. Örneğin, eğer 01: 30: 45 değerini belirtirseniz ve derleme aracısı 1 saat 30 dakika ve 45 saniyede işini bitiremezse derleme başarısız olacaktır. Eğer derleme aracısına derlemeyi işlemesi için sınırsız zaman vermek istiyorsanız 00: 00: 00 değerini belirtin.
Önemli
MaxWaitTime özelliğinde sıfırdan farklı makul bir değer belirterek derleme sıranızı yedeklemekten kaçınabilirsiniz.
ReservationSpec (AgentReservationSpec): Bu etkinliğin içerdiği etkinlikleri işleyecek derleme aracısı türünü kısıtlayabilirsiniz. Örneğin, etkinlikleri AgentScope etkinliği içinde işlemek için yalnızca belirli bir etiketi olan derleme aracılarının kullanılacağını belirtebilirsiniz .
Yürütme
MaxExecutionTime (TimeSpan): AgentScope etkinliğinin tamamlanması için izin verilen en uzun zamanı belirtebilirsiniz. Bir değeri ss:dd:ss biçiminde yazabilirsiniz. Örneğin, eğer 04: 30: 15 değerini belirtirseniz ve derleme aracısı 4 saat 30 dakika ve 15 saniyede işini bitiremezse derleme başarısız olacaktır. Eğer derleme aracısına derlemeyi işlemesi için sınırsız zaman vermek istiyorsanız 00: 00: 00 değerini belirtin.
İpucu
MaxExecutionTime özelliğinde sıfırdan farklı makul bir değer belirterek derleme sıranızı yedeklemekten kaçınabilirsiniz.
Kapsam
- DataToIgnore: Bu özelliği yok sayın.
Başa dön
Güvenli dizi işlemini (SharedResourceScope etkinliği) yürütmek için adlandırılmış mutex yapısını kullanın
Derleme işleminizin kapalı parçasının "parçacığı güvenli" olacağından emin olmak amaçlı adlandırılmış mutex (karşılıklı dışlama) yapısını yürütmek için SharedResourceScope etkinliğini kullanın.
Bu etkinliğin genel kullanımı sadece bir işlem tarafından zamanında erişilmek zorunda olan paylaşılan kaynağa ulaşmak zorunda olan derleme işleminin parçalarını çevrelemektir. Örneğin, derlemenizin sırayla dosya paylaşımındaki tek bir metin dosyasına yazmasını isteyebilirsiniz. Bu tür bir işlemin doğru çalıştığından emin olmak için onu SharedResourceScope etkinliği içinde yürütmelisiniz.
PublishSymbols etkinlik çağrısının SharedResourceScope etkinliği içine gömüldüğü DefaultTemplate.xaml'daki bir başka örneği bulabilirsiniz.
Dizi (Sequence) >
(AgentScope) Aracısında Çalıştırın>
Derleme, Test ve Değişiklik kümeleri ile Çalışma Öğelerini ilişkilendirmeyi deneyin (TryCatch [Try]) >
Dizi (Sequence) >
Gömülü Sınamalarını, Dizin Kaynaklarını ve Yayın Sembollerini alın (Parallel) >
Eğer SourceAndSymbolServerSettings.IndexSources veya SourceAndSymbolServerSettings.HasSymbolStorePath (If [Then]) >
Tetiklenmiş Derlemeler için Dizin Kaynakları ve Yayın Sembolleri (InvokeForReason) >
Eğer SourceAndSymbolServerSettings.HasSymbolStorePath (If [Then]) >
Yayın Sembollerini deneyin (TryCatch [Try]) >
Sembol Deposuna olan erişimi Eşitleme (SharedResourceScope) >
Yayın Sembolleri (PublishSymbols)
Bu yapıyı yönlendirme hakkında daha fazla bilgi için bkz: Karmaşık bir Windows iş akışı içinde gezinme.
SharedResourceScope Bağımsız Değişkeni Özellikleri
ResourceName (String): Bir değer belirtmeniz gerekir. Eğer ekip projesi koleksiyonunuzda aynı ResourceName değerine sahiplerse SharedResourceScope etkinliklerinin tüm örnekleri teker teker çalıştırılır.
MaxExecutionTime (TimeSpan): SharedResourceScope etkinliğinin tamamlanması için izin verilen en uzun zamanı belirtebilirsiniz. Bir değeri ss:dd:ss biçiminde yazabilirsiniz. Örneğin, 04: 30: 15 değerini belirtirseniz ve SharedResourceScope etkinliği 4 saat, 30 dakika, ve 15 saniye sonra tamamlanmamış olursa derleme zaman aşımı hatası ile birlikte başarısız olur. SharedResourceScope etkinliğini işlemek için sınırsız zamana izin vermek istiyorsanız 00:00:00 değerini belirtin.
İpucu
MaxExecutionTime özelliğinde sıfırdan farklı makul bir değer belirterek derleme sıranızı yedeklemekten kaçınabilirsiniz.
MaxWaitTime (TimeSpan): Derleme işleminin SharedResourceScope etkinliğini işlemek için sırada beklediği en uzun zamanı belirtebilirsiniz. Bir değeri ss:dd:ss biçiminde yazabilirsiniz. Örneğin, 01: 30: 45 değerini belirtirseniz ve SharedResourceScope etkinliği 1 saat, 30 dakika, ve 45 saniye sonra işlenmemişse derleme zaman aşımı hatası ile birlikte başarısız olur. Sırada beklemesi amacı ile derlemenin sınırsız zaman işlemesini istiyorsanız 00: 00: 00 değerini belirtin.
İpucu
MaxWaitTime özelliğinde sıfırdan farklı makul bir değer belirterek derleme sıranızı yedeklemekten kaçınabilirsiniz.
Başa dön
Nedene (tetikleyici) dayanan derleme sürecinizin bölümlerini sınırlayın (InvokeForReason etkinliği)
Sadece belirli bir neden için çalıştırılmış derlemeler içinde çalıştırmak istediğiniz derleme işleminizin parçasını çevrelemek için InvokeForReason etkinliğini kullanın. Derleme nedenleri genellikle kullanıcının derleme tanımının Tetikleyici sekmesi üzerinden seçtiği tetikleyici tarafından ayarlanır. İzin vermek istediğiniz bir ya da daha fazla neden değerini Neden özelliği içinde belirtebilirsiniz. Daha fazla bilgi için bkz. Yapım tetikler ve nedenlerini belirtin.
Başa dön
Diğer görevleri derleyin, sınayın ve gerçekleştirin
İkili dosyaları derlemek, sınamaları çalıştırmak ve diğer görevleri gerçekleştirmek için Team Foundation Yapısı etkinliklerini kullanabilirsiniz.
İkili dosyaları derlemek, kodu çözümlemesini çalıştırmak ve diğer görevleri gerçekleştirmek için MSBuild'i kullanın
Testleri Çalıştırma
Bu derlemenin etkilediği sınamaların listesini alın
İkili dosyaları derlemek, kodu çözümlemesini çalıştırmak ve diğer görevleri gerçekleştirmek için MSBuild'i kullanın (MSBuild etkinliği)
İkili dosyaları derlemek, kod çözümlemesini yürütmek ve MSBuild 'in sağladığı diğer bütün işlevselliklerden yarar sağlamak için MSBuild etkinliğini kullanın.
MSBuild Sonucu
Bu faaliyetin hiçbir özelliği bir sonuç döndürmez. Ancak, bu etkinlik herhangi bir hatanın günlüğe kaydedilmesi durumunda CompilationStatus 'u Failed 'a ayarlar.
MSBuild Bağımsız Değişkeni Özellikleri
AdditionalVCOverrides (String): Eğer GenerateVsPropsFile 'ı True 'ya ayarlarsanız, bu özelliğin içeriği oluşturulmuş .vsprops dosyası içine gömülür.
CommandLineArguments (String): MSBuild 'e geçmesini istediğiniz komut satırı bağımsız değişkenini belirtebilirsiniz.
Configuration (String): Yapılandırmayı derlenecek olarak belirtebilirsiniz. Örneğin: “debug” veya “release”.
GenerateVSPropsFile (Boolean): Bu özellik True 'ya ayarlanırsa, MSBuild C++ projelerine aktarmak için standart bir .vsprops dosyası oluşturur. Bu dosya C++ projeleri ve AdditionalVCOverrides özelliği içinde ne belirttiyseniz onun için çıktı dizini içerecektir.
LogFile (String): MSBuild 'in oluşturması gerektiği günlük dosyasının adını belirtebilirsiniz.
LogFileDropLocation (String): MSBuild 'in günlük dosyasını bırakmasını istediğiniz dizine olan tamamen kalifiye UNC yolunu belirtebilirsiniz.
MaxProcesses (Int32): MSBuild 'in oluşturduğu en çok işlem sayısını belirtebilirsiniz.
OutDir (String) MSBuild 'in derlenmiş ikili dosyaları bıraktığı dizini belirtebilirsiniz. Daha fazla bilgi için bkz. Burada oluþturma sistemi, ikili dosyalar yerleştirir kontrol.
Platform (String): MSBuild derlemelerine platform belirtebilirsiniz. Örneğin: “Any CPU”, “x86” ya da “x64”.
Project (String): Çözümü ya da MSBuild 'in derlediği kod projesini belirtebilirsiniz.
ResponseFile (String): MSBuild 'in kullandığı yanıt dosyasını belirtebilirsiniz.
RunCodeAnalysis (CodeAnalysisOption): Kod çözümlemesinin her zaman çalışması gerektiğini, hiçbir zaman çalışması gerektiğini veya proje ayarlarına göre çalışması gerektiğini belirtebilirsiniz.
Targets (IEnumerable<T><String>): Derlenecek hedefleri belirtebilirsiniz.
TargetsNotLogged (IEnumerable<T><String>): ProjectStarted olaylarının günlüğe kaydedilmediği hedefleri belirtebilirsiniz.
ToolPath (String): Araca olan yolu belirtebilirsiniz.
ToolPlatform (ToolPlatform): Araç için olan platformu belirtebilirsiniz. Geçerli işletim sistemine dayanan platformu algılamak için Microsoft.TeamFoundation.Build.Workflow.Activities.ToolPlatform.Auto öğesini belirtin.
Verbosity (BuildVerbosity): MSBuild 'in oluşturduğu günlüğün ayrıntı düzeyini belirtebilirsiniz.
MSBuild özelliklerinin etkilediği birçok MSBuild seçeneği hakkında daha fazla bilgi için, bkz: MSBuild Komut Satırı Başvurusu.
Başa dön
Testleri çalıştırın.
RunTests etkinliğini ya da MSTest etkinliğini kullanarak testleri yürütebilirsiniz.
RunTests etkinliğini kullanarak testleri çalıştırın
Testleri yürütmek amaçlı Hızlı Test Çalıştırıcısını kullanmak için RunTests etkinliğini kullanın. Derlemenizi ikili dosyaları uyumsuz platformlarla birlikte derler ve sınarsa bu etkinliği derlemelere karşı her platformda ayrı ayrı yürütmelisiniz.
Bu sınama çalıştırıcısının avantajları ve dezavantajları gibi daha fazla bilgi için bkz: oluştur [Team-Foundation].
Çekirdek RunTests Özellikleri
TestSources (IEnumerable<String>): Çalıştırmak istediğiniz sınamaları içeren derleme dosyalarının listesini belirtmeniz gerekir.
ExecutionPlatform (ExecutionPlatformType) Sınamak istediğiniz ikili dosyaların platformunu belirtebilirsiniz. Daha fazla bilgi için bkz: Hızlı Test Çalıştırıcısı.
ExecutionTimeout (Int32): Derleme işleminin sınama çalıştırmasının tamamlanmasını beklediği en uzun süreyi belirtebilirsiniz. RunTests etkinliğine sınamaları çalıştırması için sınırsız süre vermek istiyorsanız 0 değerini belirtin.
KeepAlive (Boolean): Hızlı Sınama Çalıştırıcısının RunTests etkinliği tamamlandıktan sonra yürütmeye devam etmesini istiyorsanız bu özelliği True 'ya ayarlayın.
RunSettings (String): Belgelenmemiştir.
TestCaseFilter (String): Bu özelliği sınama taleplerinin alt kümesini yürütmek için kullanabilirsiniz. Daha fazla bilgi için bkz: Visual Studio Test Çalıştırıcısı tarafından yürütülen testler için ölçütleri Belirt.
UpdateFrequency (Int32): Belgelenmemiştir.
UpdateFrequencyTimeout (Int32): Belgelenmemiştir.
RunTests Yayın Özellikleri
Aşağıdaki özellikleri ekip projesi koleksiyonuna yayımlamak için kullanabilirsiniz:
PublishResults (Boolean): Sınama sonuçlarını yayımlamak istiyorsanız bu özelliği True 'ya ayarlamanız gerekir.
Flavor (String): Sonuçlarını yayımlamak istediğiniz sınamalara karşı yürüttüğünüz derlemenin özelliğini belirtebilirsiniz.
Platform (String): Sonuçlarını yayımlamak istediğiniz sınamalara karşı yürüttüğünüz derlemenin platformunu belirtebilirsiniz.
RunName (String): sınama çalışmasının adını belirtebilirsiniz. Derleme işleminizin müşterileri bu adı derleme sonucu penceresi özetinde görecek. Bir ad belirtmezseniz, daha sonra sistem otomatik olarak bir tane oluşturacak.
Temsilciler
OnTestCompleted: Belgelenmemiştir.
OnTestRunCompleted: Belgelenmemiştir.
Başa dön
MSTest aktivitesini kullanan testler yürütün
Bu etkinliği MSTest.exe dosyasını kullanarak sınamaları çalıştırmak için kullanın. Bu sınama çalıştırıcısının avantajları ve dezavantajları gibi daha fazla bilgi için bkz: oluştur [Team-Foundation].
Çekirdek MSTest Özellikleri
Başlatmak için sınamaları nasıl çalıştırmak istediğinize karar verin ve uygun özellikler için değerleri belirtin.
Test kaplarında sınamaları çalıştırmak için (Önerilen yaklaşım) aşağıdaki özellikleri kullanın:
TestContainers (IEnumerable<String>): Çalıştırmak istediğiniz sınamanın sınama taşıyıcılarını belirtmelisiniz. Bu özellik, MSTest.exe komutunun /testcontainer seçeneğine eşdeğerdir. Daha fazla bilgi için bkz. /testcontainer (test kapsayıcı).
SearchPathRoot (String): Sınama taşıyıcıları ve onların bağımlılıkları için arama yapılan dizine olan yolun kökünü belirtebilirsiniz. Bir değer belirtmezseniz, MSTest etkinliği tipik konumlardaki dosyaları bulmayı deneyecek.
TestSettings (String): Kullanmak için bir sınama çalıştırma yapılandırma dosyası belirtebilirsiniz. Bu özellik, MSTest.exe komutunun /testsettings seçeneğine eşdeğerdir. Daha fazla bilgi için bkz. /testsettings (test ayarları).
Sınama listelerinde sınamaları çalıştırmak için aşağıdaki özellikleri kullanın:
TestLists (IEnumerable<String>): Çalıştırmak istediğiniz sınama listesini belirtmeniz gerekir. Bu özellik, MSTest.exe komutunun /testlist seçeneğine eşdeğerdir. Daha fazla bilgi için, bkz. /testlist (test listesi) ve Testlerinizi Gruplamak için Test Listeleri Tanımlama.
TestMetadata (String): Çalıştırmak istediğiniz sınama listelerini taşıyan meta veri dosyasını belirtmeniz gerekir. Bu özellik, MSTest.exe komutunun /testmetadata seçeneğine eşdeğerdir. Daha fazla bilgi için bkz. /testmetadata (test meta verisi).
MSTest Filtreleme Özellikleri
Hangi sınamaların çalıştırılacağına göre filtrelemek için aşağıdaki özellikleri kullanabilirsiniz:
Category (String): Kendi test kategorilerine göre testlere filtre uygulayabilirsiniz. Bu özellik, MSTest.exe komutunun /category seçeneğine eşdeğerdir. Daha fazla bilgi için, bkz. /category ve Testlerinizi Gruplamak için Test Kategorisi Tanımlama.
MaxPriority (Int32): Çalıştırmak istediğiniz sınamaların en yüksek önceliğini belirtebilirsiniz. Önceliği yalnızca bu değere eş ya da bu değerden az olan sınamalar çalışacaktır. MinPriority özelliğine eş ya da daha fazla olan pozitif bir tam sayı belirtmeniz gerekir veya en yüksek öncelik belirlemek istemiyorsanız -1 belirtmeniz gerekir.
İpucu
Sınamalarınız için öncelikler atadıysanız, MinPriority ve MaxPriority özellikleri 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ınamaların en düşük önceliğini belirtebilirsiniz. Önceliği yalnızca bu değere eş ya da bu değerden çok olan sınamalar çalışacaktır. MaxPriority özelliğine eş ya da daha az olan pozitif bir tam sayı belirtmeniz gerekir veya en düşük öncelik belirlemek istemiyorsanız -1 belirtmeniz gerekir.
TestNames (IEnumerable<String>): Çalıştırmak istediğiniz sınamaların adlarını belirtebilirsiniz. Bu özellik, MSTest.exe komutunun /test seçeneğine eşdeğerdir. Daha fazla bilgi için bkz. /test.
MSTest Yayımlama Özellikleri
Aşağıdaki özellikleri ekip projesi koleksiyonuna yayımlamak için kullanabilirsiniz:
Publish (Boolean): Sınama sonuçlarını yayımlamak istiyorsanız bu özelliği True 'ya ayarlamanız gerekir.
Flavor (String): Sonuçlarını yayımlamak istediğiniz sınamalara karşı yürüttüğünüz derlemenin özelliğini belirtebilirsiniz. Bu özellik, MSTest.exe komutunun /flavor seçeneğine eşdeğerdir. Daha fazla bilgi için bkz. Test Sonuçlarını Yayınlamak için Komut Satırı Seçenekleri.
Platform (String): Sonuçlarını yayımlamak istediğiniz sınamalara karşı yürüttüğünüz derlemenin platformunu belirtebilirsiniz. Bu özellik, MSTest.exe komutunun /platform seçeneğine eşdeğerdir. Daha fazla bilgi için bkz. Test Sonuçlarını Yayınlamak için Komut Satırı Seçenekleri.
TestConfigId (Int32): Sonucunu yayımlamak istediğiniz sınama çalıştırması ile ilişkilendirmek için var olan bir sınama yönetimi yapılandırmasının kimliğini belirtebilirsiniz. Bu özellik, MSTest.exe komutunun /testconfigid seçeneğine eşdeğerdir. Daha fazla bilgi için: Visual Studio komut istemindeki MSTest /? .
TestConfigName (String): Sonucunu yayımlamak istediğiniz sınama çalıştırması ile ilişkilendirmek için var olan bir sınama yönetimi yapılandırmasının adını belirtebilirsiniz. Bu özellik, MSTest.exe komutunun /testconfigname seçeneğine eşdeğerdir. Daha fazla bilgi için: Visual Studio komut istemindeki MSTest /? .
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): MSTest.exe dosyasının sonuç dosyalarını (.trx) koyduğu derleme aracısı üzerindeki dizine olan yolun kökünü belirtebilirsiniz.
ToolPath (String): Çalıştırmak istediğiniz MSTest.exe dosyasının sürümünü taşıyan dizine olan yolu belirtebilirsiniz. Bir yol belirtmezseniz, Team Foundation Yapısı test listeleri veya test taşıyıcılarındaki verilere dayanan yolu otomatik olarak belirler.
Başa dön
Yapının etkilediği testlerin bir listesini alın (GetImpactedTests Etkinliği)
Geçerli derleme içinde kod değişiklikleri tanımlamak ve bu değişikliklerden etkilenen sınamaların listesini üretmek için GetImpactedTests etkinliğini kullanın. Bu derleme tamamlandıktan sonra sınama ekibinizin elemanlarını hangi testin yürütüleceğini belirlemelerine yardım etmek için etkinlik etkilenmiş sınamaların listesini veri ambarına yazar. Ekibinizin bu verileri nasıl kullanacakları hakkında daha fazla bilgi için bkz: Kod Değişikliklerinden Etkilenen Testleri Bulma.
Not
Bu faaliyetin etrafı çevrili kayıt derlemeleri veya özel derlemelerde hiçbir etkisi yoktur.
Gerekli Koşullar
GetImpactedTests etkinliği yalnızca aşağıdaki koşullar geçerli olduğunda işlevi olur:
MSTest etkinlik sınama etkisi verilerini toplayan sınama ayarları dosyası ( TestSettings özelliği içinde belirtilen) ile birlikte yürütülür. Otomatik olarak oluşturulan Traceandtestimpact.testsettings dosyasını ya da Etkisini Test onay kutusunun seçili olduğu bir başka sınama ayarları dosyasını kullanabilirsiniz. Daha fazla bilgi için bkz. Nasıl yapılır: Kod Değişikliklerinden Sonra Hangi Testin Çalışması Gerektiğini Denetlemek İçin Veri Toplama.
GetImpactedTests etkinliği başarılı bir şekilde önceki derlemeleri tanımlamıştır. Daha fazla bilgi için sonraki bölüme bakınız.
GetImpactedTests etkinliği Önceki Derlemeleri nasıl tanımlar
GetImpactedTests etkinliği önceki derleme ile geçerli derlemeyi karşılaştırarak bunun sonuçlarını üretir. Etkinlik aşağıdaki işlemi kullanarak önceki derlemeyi tanımlar:
Eğer BaselineBuildDropLocation özelliğini belirtirseniz, bu ikili dosyaları oluşturan derleme önceki derlemeler gibi tanımlanır.
Eğer BaselineBuildDropLocation özelliğini belirtmezseniz, etkinlik aşağıdaki bütün kriterlerle eşleşen en son derlemeyi veri ambarında arayarak önceki derlemeyi tanımlar:
Derleme, geçerli derleme gibi BuildDefinitionUri 'e sahiptir.
Derlemenin Status 'u Succeeded veya PartiallySucceeded .
Derleme DropLocation 'a sahiptir.
Derleme, etrafı çevrili kayıt derlemesi ya da özel bir derleme değildir.
GetImpactedTests Sonucu Özellikleri
CodeChanges (CodeChangeList): Kodunuzda bu derleme ve önceki derleme arasındaki her yöntem için yapılan değişikliklerin bir listesini döndürür. Yöntemler Microsoft Intermediate language (MSIL) düzeyinde analiz edilir.
ImpactedTests (TestList): Bir önceki derleme ve bu derleme arasında kod değişikliklerinden etkilenen sınamaların listesini döndürür.
GetImpactedTests Bağımsız Değişkeni Özellikleri
Çeşitli
- Build: Derlemenin IBuildDetail nesnesini sağlamanız gerekir. Bu nesneye bir başvuru almak için GetBuildDetail etkinliğini kullanabilirsiniz.
Çeşitli konular
Assemblies (IEnumerable<String>): Bu etkinliğin incelemesini istediğiniz derlemelerin bir listesini belirtmeniz gerekir. Genellikle bu derlemeleri bu derlemede derlediniz.
AssociatedChangesets (IList<T><Changeset>): sınama etkisi sonuçları ile ilişkilendirmek istediğiniz değişiklik kümelerini belirtebilirsiniz. Tipik olarak derlemekte olduğunuz değişiklik kümelerini belirtmek istersiniz. AssociateChangesetsAndWorkItems etkinliğinden bu değişiklik kümelerine başvuru alabilirsiniz.
BinariesRoot (String): Derlemelerinizin bağımlı olduğu ikili dosyalara olan yolu belirtmeniz gerekir. GetBuildDirectory etkinliğini kullanarak bu değeri alabilirsiniz.
Workspace (Workspace): Derlemenizin çalışma alanına başvuru sağlamanız gerekir. Bu başvuruyu CreateWorkspace etkinliğinin Sonuç özelliğinden elde edebilirsiniz.
BaselineBuildDropLocation (String): GetImpactedTests etkinliğinin geçerli derlemeyle karşılaştırmasını istediğiniz tamamlanmış derlemeyi taşıyan bırakma klasörüne olan yolu belirtebilirsiniz. Bu özelliği belirtmezseniz, etkinlik önceki derleme için derleme sistemini sorgulamaya çalışır. Daha fazla bilgi için bu bölümün önceki kısımlarında yer alan bkz: "GetImpactedTests etkinliği Önceki Derlemeyi Nasıl Tanımlar".
Başa dön
Bir işlem (InvokeProcess etkinliği) başlat
Derleme sunucuda bir işlem başlatmak (bir program çalıştırmak) için InvokeProcess etkinliğini kullanın. Bu etkinlik aslında Start üzerindeki bir sarmalayıcıdır.
InvokeProcess sonucu (Int32) Özelliği
İşlemden ExitCode 'u döner.
InvokeProcess Bağımsız Değişkeni Özellikleri
FileName (String): Başlatmak istediğiniz (çalıştırmak istediğiniz program) işlemin FileName 'ini belirtmeniz gerekir. Örneğin: %ProgramFiles%\ContosoBuildUtils\MarkBins.exe.
Arguments (String): İşleme geçirmek istediğiniz komut satırı bağımsız değişkenlerini (Arguments) belirtebilirsiniz.
EnvironmentVariables (IDictionary<TKey, TValue><String,String>): Ek ortam değişkenlerini (EnvironmentVariables) ve bunların değerlerini belirtebilirsiniz.
OutputEncoding (Encoding): Çıktı (StandardOutputEncoding) ve hata (RedirectStandardError) akışlarını okumak için kullanılan kodlamayı belirtebilirsiniz. Çoğu durumda, bu özellik için en iyi değer varsayılan değerdir:
System.Text.Encoding.GetEncoding(System.Globalization.CultureInfo.InstalledUICulture.TextInfo.OEMCodePage)
WorkingDirectory (String): İşlemi çalıştırmak istediğiniz çalışma dizinini belirtebilirsiniz (WorkingDirectory).
Örneğin, derlenmiş ikili dosyalara karşı MarkBins.exe yardımcı programını çalıştırmak isteyebilirsiniz. Yardımcı programın çalıştığı kapsamı daraltmak için GetBuildDirectory'yi çağırabilir ve bu özelliği sonuca yerleştirebilirsiniz.
Standart çıktıyı ve hata çıktısını işleminizden göstermek için
InvokeProcess etkinliği içinde, Görüntülemek için çift tıklayın 'a çift tıklayın.
Etkinliğin Standart Çıktıyı Hallet altında gözükmesi ve WriteBuildMessage İleti özelliğini stdOutput 'a ayarlamak için Araç Kutusundan WriteBuildMessage etkinliğini sürükleyin.
Etkinliğin Standart Çıktıyı Hallet altında gözükmesi ve WriteBuildMessage İleti özelliğini errOutput 'a ayarlamak için Araç Kutusundan WriteBuildError etkinliğini sürükleyin.
Sürüm Denetimiyle çalışın.
Aşağıdaki sürüm denetim görevlerini gerçekleştirmek için Team Foundation Yapısı etkinliklerini kullanabilirsiniz:
Değişiklik kümesini ve çalışma öğelerini derleme ile ilişkilendirin
Geçitli değişiklikleri kaydet
Kayıt ilkelerini değerlendirin
Sürüm kontrolündeki dosyaları etiketleyin
Değişiklik kümesi ve çalışma öğelerini derleme ile ilişkilendirin (AssociateChangesetsAndWorkItems etkinliği)
Tamamlanan her derleme ile kod içine ve bunların alakalı çalışma öğelerine giden bütün değişiklik kümelerini bağlamak için AssociateChangesetsAndWorkItems etkinliğini kullanın.
Her derleme tanımı hangi değişiklik kümesinin ve çalışma öğesinin sıradaki tamamlanmış derleme ile ilişkilenmeyi beklediğinin kaydını tutar. Örneğin, Derleme A ve Derleme değişiklik kümesi 382'yi oluşturabilir. Derleme A sıraya alınmış ve başarıyla tamamlanmış ancak Derleme B sıraya alınıp ve başarısız olmuş olabilir. Changeset 382 şimdi Derleme A'nın başarıyla tamamlanmış derlemesiyle ve Derleme B'nin başarısız derlemesi ile bağlantılıdır. Changeset 382 Derleme A'nın sonraki tamamlanan derlemesi ile bağlanmayacak ama Derleme B'nin bir dahaki başarılı derlemesi ile bağlanacaktır.
AssociateChangesetsAndWorkItems Sonucu (IList<T><Changeset>) Özelliği
Derleme ile ilişkili değişiklik kümelerini döner.
AssociateChangesetsAndWorkItems Bağımsız Değişkeni Özellikleri
CurrentLabel (String): Bu özelliği boş bırakın.
LastLabel (String): Bu özelliği boş bırakın.
UpdateWorkItems (Boolean): Derleme numarası ile ilişkili çalışma öğelerinin Sabit alanlarını doldurmak istiyorsanız bu özelliğin değerini True 'ya ayarlayabilirsiniz. Aksi takdirde değeri False 'a ayarlayın.
Başa dön
Etrafı çevrili değişiklikleri kaydedin (CheckInGatedChanges etkinliği)
Etrafı çevrili kayıt derlemesini tetikleyen kod değişikliklerine sürüm denetimi yapmak amaçlı kaydetmek için CheckInGatedChanges etkinliğini kullanın. Ayrıca bu faaliyet değişiklik kümeleriyle ilişkilendirilmiş çalışma öğelerini derleme ile ilişkilendirir.
Not
Düzgün çalışabilmesi için bu etkinlik şablonunuzdaki MSBuild 'in bütün uygulamalarından ve MSTest etkinliklerinden sonra yerleştirilmelidir.
CheckInGatedChanges Sonucu (Changeset) Özelliği
Kaydedilen değişiklikleri içeren değişiklik kümesini döner.
CheckInGatedChanges bağımsız Değişkeni Özellikleri
IgnoreErrors (Boolean): CompilationStatus ve TestStatus özellikleri Succeeded değerine sahipse dosyaların kaydolmasına izin vermek için bu özelliği False 'a ayarlayın. Bu özelliğin değerinin ne olduğundan bağımsız olarak bu dosyaların kaydolmasına izin vermek için bu özelliği True 'ya ayarlayın.
Not
CompilationStatus ve TestStatus özelliklerini ayarlamak için SetBuildProperties etkinliğini kullanabilirsiniz.
UpdateWorkItems (String): Derleme numarası ile ilişkili çalışma öğelerinin Sabit alanlarını doldurmak istiyorsanız bu değeri True 'ya ayarlayın. Aksi halde, False 'a ayarlayın.
Başa dön
Kayıt ilkelerini (EvaluateCheckInPolicies etkinliği) değerlendirin
Derleme sunucusunda kayıt ilkelerini yürütmek için EvaluateCheckInPolicies kullanın. Bu etkinlik derleme tanımı üzerindeki Çalışma Alanı sekmesi üzerinde belirtilen klasörler için zorlanan kayır ilkelerini yürütür. Eğer kayıt ilkeleri başarısız olursa ve derlemenin sebebi CheckInShelveset (etrafı çevrili bir kayıt derlemesi) ya da ValidateShelveset (özel derleme) ise derleme başarısız olur.
Önemli
Kayıt ilkeleri derleme sunucusunda değerlendirilir, geliştiricinin istemci bilgisayarında değil.
Bu etkinliğin en etkili kullanımı onu etrafı çevrili kayıt derlemeleri ile birlikte kullanarak daha kuvvetli kaliteli kapıları zorlamaktır. Bu yolla etkinliği kullanırsanız, kullanıcının kayıt ilkelerini atlaması engellenir. Bu etkinlik kayıt ilkelerinin aşağıdaki türleri için kullanışlıdır:
Yerleşik Work Items kayıt ilkesi
Derleme sunucusunda değerlendirilecek şekilde tasarlanan özel kayıt ilkeleri
Bu etkinlik yerleşik değerlendirmek için yararlı değil Builds veya Code Analysis iade ilkeleri doğrudan kullanarak bu işlemleri bir yapı içinde daha verimli çalışabilir çünkü MSBuild ve MSTest etkinlikleri.
Daha fazla bilgi için aşağıdaki kaynaklara bakın:
Yerleşik kayıt ilkeleri hakkında daha fazla bilgi için bkz: Add Check-In Policies.
Özel kayıt ilkeleri hakkında daha fazla bilgi için bkz: Nasıl yapılır: Visual Studio Team Foundation Server'da Özel Kayıt İlkeleri Oluştur.
Etrafı çevrili kayıt derlemeleri hakkında bilgi için bkz: Değişiklikleri doğrulamak üzere Gated onay oluşturma işlemini tanımla .
Özel derlemeler hakkında daha fazla bilgi için, bkz. Sıra bir yapı.
EvaluateCheckInPolicies Bağımsız Değişkeni Özellikleri
- Workspace (Workspace): Değerlendirmek istediğiniz çalışma alanını belirtmeniz gerekir. Çoğu durumda, bu özelliği CreateWorkspace etkinliğinin Sonuç özelliği içinde başlattığınız değere ayarlamanız gerekir. DefaultTemplate.xaml 'de temellenmiş bir derleme işlemi oluşturuyorsanız,büyük olasılıkla Workspace değişkenini kullanmanız gerekir.
Başa dön
Sürüm kontrolündeki dosyaları etiketleyin
Team Foundation Yapısı etkinliklerini kullanarak dosyaları etiketleyebilirsiniz:
Derlemekte olduğunuz kaynak kodu etiketleyin
Dosyaları etiketleyin
Derlemekte olduğunuz kaynak kodu etiketleyin (LabelWorkspace etkinliği)
Ekibinizin her dosyanın hangi sürümünün verilen tamamlanmış derlemeye eklenmiş olduğunu tanımlaması için kaynak kod dosyalarını sürüm denetiminde etiketlemelisiniz. Bu adımı derleme işleminize dahil etmek için LabelWorkspace etkinliğini kullanın.
LabelWorkspace Bağımsız Değişkeni Özellikleri
Name (String): Etiket adını belirtmeniz gerekir.
Child (LabelChildOption): Belirttiğiniz etiketle eşleşen etiketi olan öğelerle nasıl baş edeceğinizi belirtebilirsiniz. Bu özellik, tf label komutunun /child seçeneğine eşdeğerdir.
Workspace (Workspace): Derlemenin çalışma alanına başvuru sağlamanız gerekir. Çoğu durumda, bu özelliği CreateWorkspace etkinliğinin Sonuç özelliği içinde başlattığınız değere ayarlamanız gerekir. DefaultTemplate.xaml 'de temellenmiş bir derleme işlemi oluşturuyorsanız,büyük olasılıkla Workspace değişkenini kullanmanız gerekir.
Comment (String): Etiket için bir açıklama belirtebilirsiniz. Bu özellik, tf label komutunun /comment seçeneğine eşdeğerdir.
Scope (String): Etiket için bir kapsam belirtebilirsiniz. Bu özellik tf label komutunun @scope bağımsız değişkenine eş değerdir.
tf label parametreleri hakkında daha fazla bilgi için bkz. Label Command (Team Foundation Version Control).
Başa dön
Etiket dosyaları (LabelSources etkinliği)
Dosyaları sürüm denetiminde etiketlemek için LabelSources etkinliğini kullanın.
İpucu
LabelWorkspace etkinliğini kullanıyorsanız daha etkili derlemekte olduğunuz kaynak kod dosyalarını daha sık bir şekilde etiketleyebilirsiniz.
LabelSources Bağımsız Değişkeni Özellikleri
Items (IEnumerable<String>): Etiketlemek istediğiniz öğeleri belirtmeniz gerekir. Her String tf label komutunun itemspec bağımsız değişkenine eş değerdir.
Name (String): Etiket adını belirtmeniz gerekir.
Scope (String): Etiket için bir kapsam belirtmelisiniz. Bu özellik tf label komutunun @scope bağımsız değişkenine eş değerdir.
Recursion (RecursionType): Dizin sıradüzeni içindeki tüm dosyaları etiketlemek istiyorsanız Microsoft.TeamFoundation.VersionControl.Client.RecursionType.Full 'ı belirtebilirsiniz. Veya Microsoft.TeamFoundation.VersionControl.Client.RecursionType.OneLevel öğesini belirtebilirsiniz.
Version (String): Etiketlemek istediğiniz öğelerin sürümünü sağlamanız gerekir. Bu özellik, tf label komutunun /version seçeneğine eşdeğerdir.
Child (LabelChildOption): Belirttiğiniz etiketle eşleşen etiketi olan öğelerle nasıl baş edeceğinizi belirtebilirsiniz. Bu özellik, tf label komutunun /child seçeneğine eşdeğerdir.
Comment (String): Etiket için bir açıklama belirtebilirsiniz. Bu özellik, tf label komutunun /comment seçeneğine eşdeğerdir.
tf label parametreleri hakkında daha fazla bilgi için bkz. Label Command (Team Foundation Version Control).
Başa dön
Bekleme kümelerinin (QueryShelvesets etkinliği) listesini alın
Ölçütünüze uygun olan bekletme kümelerinin listesini almak için QueryShelvesets etkinliğini kullanın. Daha sonra, herhangi bir bekletme kümesinin içeriğini almak için TfUnshelve etkinliğini kullanabilirsiniz.
QueryShelvesets Sonucu (IList<T><Shelveset>)
QueryShelvesets Bağımsız Değişkeni Özellikleri
VersionControlServer (VersionControlServer): Bir VersionControlServer belirtmeniz gerekir.
TfGet etkinliği
Bu etkinlik Get Komutu 'i sarar.
TfResolve etkinliği
Bu etkinlik Resolve Command 'i sarar.
TfShelve etkinliği
Bu etkinlik Shelve Komutu 'i sarar.
TfUndo etkinliği
Bu etkinlik Komutu geri alır 'i sarar.
TfUnshelve etkinliği
Bu etkinlik Raftan Alma Komutu 'i sarar.
TfWorkfold etkinliği
Bu etkinlik Workfold Command 'i sarar.
İş öğeleriyle çalışın
Team Foundation Yapısı etkinliklerini kullanarak çalışma öğeleri ile çalışabilirsiniz.
Değişiklik kümesini ve çalışma öğelerini derleme ile ilişkilendirin
İş öğesi oluşturma
İş öğesi (OpenWorkItem etkinliği) oluşturun
Bir iş öğesi oluşturmak için OpenWorkItem etkinliğini kullanın.
OpenWorkItem Sonucu (WorkItem) Özelliği
Yeni iş öğesini döndürür.
OpenWorkItem Bağımsız Değişkeni Özellikleri
AssignedTo (String): Çalışma öğesini atamak istediğiniz kişiyi belirtmeniz gerekir.
Title (String): Çalışma öğesinin başlığını belirtmelisiniz.
Type (String): Çalışma öğesinin türünü belirtmeniz gerekir. Normal Tür değerleri aşağıdaki örnekleri içerir: “Bug” , “Issue” , ve “Task” .
Comment (String): Çalışma öğesi geçmişine açıklama ekleyebilirsiniz.
CustomFields (IDictionary<TKey, TValue><String,String>): Çalışma öğesinin bir ya da daha fazla alanının değerini belirtebilirsiniz.
Başa dön
Sembol verileri ile çalışın
İki Team Foundation Yapısı etkinliğini kullanarak sembol verileri ile çalışabilirsiniz: IndexSources ve PublishSymbols .
Bu etkinliklerin normal kullanımı IntelliTrace hata ayıklamasını etkin kılmaktır. IntelliTrace hata ayıklamayı etkinleştirmek istiyorsanız, öncelikle, sembol verilerini hazırlamak için IndexSources etkinliğini çağırmanız gerekir. Ardından verileri SymStore sembol deposuna yayımlamak için PublishSymbols etkinliğini çağırmanız gerekir.
IntelliTrace hata ayıklama hakkında daha fazla bilgi için, bkz. IntelliTrace ile Kod Yürütmeyi Kaydederek Uygulamanızda Hata Ayıklama .
Sürüm denetim yolları ve sürümlerini PDB dosyalarındaki sembol verilerine gömün (IndexSources etkinliği)
Sürüm denetim yolları ve sürümleri .pdb dosyalarındaki sembol verilerinin içine gömmek için IndexSources etkinliğini kullanın.
IndexSources Bağımsız Değişkeni Özellikleri
FileList (IEnumerable<String>): Her simge dosyasının adını ve tam yolunu belirtmeniz gerekir. Bu bağımsız değişkeni sağlamak için FindMatchingFiles etkinliğini kullanabilirsiniz.
Öz yinelemeli arama belirtmek için ** kullanabilirsiniz. Örneğin, FindMatchingFiles 'ı MatchPattern özelliğinde bulunan aşağıdaki değerle birlikte çağırabilirsiniz: String.Format("{0}\**\*.pdb", BinariesDirectory) .
Başa dön
Sembolleri SymStore sembol deposuna (PublishSymbols etkinliği) yayımlayın
PDB dosyalarınızdaki sembol verilerini SymStore sembol deposuna yayımlamak için PublishSymbols etkinliğini kullanın. Bu etkinlik aslında SymStore.exe üzerindeki bir sarmalayıcıdır. SymStore sembol deposu ve bir tane hazırlama hakkında daha fazla bilgi için bkz: Testler .
Önemli
Eş zamanlı derlemeler aynı sembol dosya paylaşımına yayımlamayı denerse, veriler bozulabilir.Bu riski azaltmak için bu etkinliği sadece SharedResourceScope etkinliği içinde çağırmalısınız.
PublishSymbols Sonucu (String) Özelliği
SymStore.exe döndüren hareket kodunu döner.
PublishSymbols Bağımsız Değişkeni Özellikleri
FileList (IEnumerable<String>): Her simge dosyasının adını ve tam yolunu belirtmeniz gerekir. Bu bağımsız değişkeni sağlamak için FindMatchingFiles etkinliğini kullanabilirsiniz.
Örneğin, FindMatchingFiles 'ı MatchPattern özelliğinde bulunan aşağıdaki değerle birlikte çağırabilirsiniz: String.Format("{0}\**\*.pdb", BinariesDirectory) .
StorePath (String): SymStore sembol deposunun kök klasörüne olan UNC dosya yolunu belirtmelisiniz.
CommandLineArguments (String): SymStore.exe 'e geçirebileceğiniz bağımsız değişkenler hakkında daha fazla bilgi için, bkz: SymStore komut satırı seçenekleri.
Comments (String): Sembol deposundaki hareket tarihi dosyası içinde kaydedilen hareket yorumlarını belirtebilirsiniz. Bu özellik, SymStore.exe komutunun /c Comment parametresine eşdeğerdir. Daha fazla bilgi için bkz. SymStore Komut Satırı Seçenekleri.
ProductName (String): Sembol deposundaki hareket geçmişi dosyasında kaydedilen ürün adını belirtebilirsiniz. Örneğin, GetBuildDetail 'i çağırarak BuildDefinition özelliğinden elde edebileceğiniz derleme tanımı ismine (Name) bu özelliği ayarlayabilirsiniz. Bu özellik, SymStore.exe komutunun /t Product parametresine eşdeğerdir. Daha fazla bilgi için bkz. SymStore Komut Satırı Seçenekleri.
StoreCompressed (Boolean): Dosyaları sembol deposu içerisinde sıkıştırılmış dosya olarak depolamak için bu değeri True 'ya ayarlayın. Aksi takdirde dosyalar sıkıştırılmadan saklanır. Bu özellik, SymStore.exe komutunun /compress parametresine eşdeğerdir. Daha fazla bilgi için bkz. SymStore Komut Satırı Seçenekleri.
Version (String): Örneğin, GetBuildDetail 'i çağırarak elde edebileceğiniz derleme numarasına (BuildNumber) bu değeri ayarlayabilirsiniz. Bu özellik, SymStore.exe komutunun /v Version parametresine eşdeğerdir. Daha fazla bilgi için bkz. SymStore Komut Satırı Seçenekleri.
Başa dön
Yararlı Nesnelere Başvurular alın
Team Foundation Yapısı etkinliklerini kullanarak yararlı nesnelere başvuru alabilirsiniz.
Bir ekip proje koleksiyonu için (GetTeamProjectCollection etkinliği) nesneye bir başvuru alın
Sonuç özelliğinden TfsTeamProjectCollection nesnesine bir başvuru almak için GetTeamProjectCollection etkinliğini kullanın. Bu başlatıcı nesne önemlidir; örneğin, Team Foundation için bunu uygulama sunucusuna bağlamak için kullanabilirsiniz.
(GetBuildAgent etkinliği) IBuildAgent nesnesine bir başvuru alın
Sonuç özelliğinden IBuildAgent nesnesine bir başvuru almak için GetBuildAgent etkinliğini kullanın. Bu etkinliği yalnızca AgentScope etkinliği içerisinde kullanabilirsiniz.
(GetBuildDetail etkinliği) IBuildDetail nesnesine bir başvuru alın
Sonuç özelliğinden IBuildDetail nesnesine bir başvuru almak için GetBuildDetail etkinliğini kullanın. Bu nesneyi geçerli derleme hakkında veri almak ve bazı durumlarda ayarlamak için kullanabilirsiniz.
Başa dön
(GetBuildEnvironment etkinliği) BuildEnvironment nesnesine bir başvuru alın
Sonuç özelliğinden BuildEnvironment nesnesine bir başvuru almak için GetBuildEnvironment etkinliğini kullanın. Genellikle aşağıdaki görevleri gerçekleştirmek için bu özelliği kullanabilirsiniz:
İş akışının geçerli kesiminin derleme denetleyicisinde mi yoksa derleme aracısı üzerinde mi çalıştığına karar vermek için Environment nesnesini kullanın.
Derleme aracısındaki özel etkinlikleri içeren derlemelere olan yolu almak için CustomAssemblyPath nesnesini kullanın.
Başa dön
Özel derleme işleminde değiştirmeniz için amaçlanmamış etkinlikler
Özel derleme işleminde değiştirmeniz için amaçlanmamış bazı etkinlikler
ApproveRequestForCheckIn
Bu etkinliğini göz ardı edin.
Başa dön
CreateWorkspace etkinliği
Bu etkinliğini göz ardı edin.
Başa dön
DeleteWorkspace
Bu etkinliğini göz ardı edin.
Başa dön
GenerateRunSettings
Bu etkinliğini göz ardı edin.
Başa dön
GetApprovedRequests
Bu etkinliğini göz ardı edin.
Başa dön
GetPendingChanges
Bu etkinliğini göz ardı edin.
Başa dön
GetRejectedRequests
Bu etkinliğini göz ardı edin.
Başa dön
GetReshelvedShelveset
Bu etkinliğini göz ardı edin.
Başa dön
GetShelvedChanges
Bu etkinliğini göz ardı edin.
Başa dön
GetWorkspace
Bu etkinliğini göz ardı edin.
Başa dön
ParseWorkspaceSpec
Bu etkinliğini göz ardı edin.
Başa dön
RejectRequestFromCheckIn
Bu etkinliğini göz ardı edin.
Başa dön
RetryRequest
Bu etkinliğini göz ardı edin.
Başa dön
RetryRequests
Bu etkinliğini göz ardı edin.
Başa dön
RevertWorkspace
Bu etkinliğini göz ardı edin.
Başa dön
RunOnce
Geçerli yayında belgelenmemiştir.
SyncWorkspace
Bu etkinliğini göz ardı edin.
Başa dön
SynchronizeRequests
Bu etkinliğini göz ardı edin.
Başa dön
TfsBuild etkinliği
Bu etkinliğini göz ardı edin.
Başa dön
TfQueryConflicts
Bu etkinliğini göz ardı edin.
Başa dön
Ayrıca bkz.
Kavramlar
Karmaşık bir Windows iş akışı içinde gezinme
Varsayılan şablonu temel yapı işlemi tanımla
Yapı Denetleyicisini Dağıtma ve Yapılandırma
Yapı Aracıları Dağıtma ve Yapılandırma