Yapı numaraları Özelleştir

Makale
08/01/2011

Bu konuda nasıl yükseltme şablonu kullandığınızda yapı numaraları özelleştirileceği açıklanmaktadır. Yükseltme şablonu ile ilgili daha fazla bilgi için bkz: Yükseltme şablonu kullanarak bir yapı tanımlar. Bu yordamı varsayılan şablonunu kullanarak daha kolay gerçekleştirebilirsiniz. Daha fazla bilgi için bkz. Varsayılan şablonu kullanarak bir yapı tanımlar.

Özelleştirebileceğiniz Team Foundation Yapısı oluşturarak kendi özel görevleri, çalıştırma sırasında bir yapı. Bu konu, özelleştirmek için izlemeniz gereken adımları açıklar bir Team Foundation Yapısı , oluşturan görev tanımı oluşturmayapı numaraları.

Önkoşullar

Yapı numaraları özelleştirmek için görev oluşturmadan önce aşağıdaki yerde olduğundan emin olun:

Özelleştirmek istediğiniz yapı tanımı TFSBuild.proj dosyasına erişimi.

TFSBuild.proj dosyası birden çok derleme tanımıyla ilişkili olabilir. TFSBuild.proj dosya kaynak denetim konumunu belirlemek için build tanımında seçin oluşturur klasöründe Ekip Gezgini, onu sağ tıklatın ve sonra ' düzenleme. TFSBuild.proj dosya kaynak denetim konumu görüntülenir Projesinin bölmesinde Yapı tanımı iletişim kutusu. Varsayılan olarak, TFSBuild.proj dosyası $ klasör bulunur /MyTeamProject/TeamBuildTypes/MyBuildName , Team Foundation sürüm denetimi. MyTeamProject ekip proje adı ve tüm ekip proje kaynaklarının kök düğümdür. MyBuildName TFSBuild.proj dosyasıyla ilişkili olan ilk yapı tanımına verdiğiniz addır. Nasıl oluşturulacağı hakkında daha fazla bilgi için Team Foundation Yapısı , yapý türleri Bkz: Temel yapı tanımı oluşturma.

Önemli

TFSBuild.proj dosya özelleştirdiğinizde, kendisiyle ilişkilendirilmiş her yapı tanımı özelleştirin.
Ekip proje dosyalarına ve yerel bilgisayarınızda yapı dosyalarını içeren yerel çalışma alanıdır.

Daha fazla bilgi için bkz:Çalışma Alanı Oluşturma ve Dosya Alma ve Takım Projeniz için Kaynak Alma.
Gerekli İzinler (bu sayfa İngilizce içeriğe sahip olabilir)

Bu görevi gerçekleştirmek için bilgisayarınızda olması yönetici bir yapý ve yönetici çalışma alanları izni ayarlamak Ver. De olmalıdır kontrol ve teslim izinlerini ayarlamak Ver. Daha fazla bilgi için bkz. Takım Kuruluş Sunucusu İzinleri.

Yapı numarası görev yazma

Sizin göreviniz yazmak ya da uygulamak için ITask , doğrudan arabirim ya da bir yardımcı sınıf kendi sınıfından türer Task. ITaskMicrosoft.Build.Framework.dll derlemede tanımlanmış ve Task tanımlanmış Microsoft.Build.Utilitites.dll derleme.

Tarafından üretilen yapı numarası özelleştirmek için Team Foundation Yapısı, görevinizi içine eklemelisiniz BuildNumberOverrideTarget hedef. BuildNumberOverrideTargetadlı bir çıkış özellik gerektirir BuildNumber. Output öznitelik özelliği, özel görev. çıkış olduğunu gösterir Hakkında daha fazla bilgi için Team Foundation Yapısı Bkz: hedefleri, Özelleştirilebilir Team Foundation yapı hedefleri.

Özel görev yazmak için

Oluşturma bir Visual C# class library adlı MyTask içeren özel bir görevi bilgisayarınızda.

Daha fazla bilgi için bkz. Bileşen Sınıflar.
Üzerinde Proje menüsünde tıklatın Add Reference, Microsoft.Build.Framework ve Microsoft.Build.Utilities gelen seçin Add Reference iletişim kutusu.

Class.cs dosyasına aşağıdaki kodu ekleyin.

Bu örnek devraldığı Task yardımcı sınıfı ve kullanımları DateTime Özellikler UtcNow ve Ticks için generate yapı numarası.

using System;
using Microsoft.Build.Utilities;
using Microsoft.Build.Framework;

namespace BuildNumberGenerator
{
    public class BuildNumberGenerator:Task
    {
        public override bool Execute()
        {            
            m_buildNumber = DateTime.UtcNow.Ticks.ToString();
            return true;
        }
        private string m_buildNumber;

        [Output]
        public string BuildNumber
        {
            get { return m_buildNumber; }
        }
    }
}

MyTask.dll üretmek için sınıf kitaplığınızı oluşturun.
Yerleşik dll da yapı tanımınızı TFSBuild.proj dosyasının bulunduğu yerel çalışma klasörüne kopyalayın.

Önemli

Bu dizin yapısı istemci bilgisayarda var önce TFSBuild.proj dosya kaynak denetim konumunu yerel çalışma alanına eşlediğiniz gerekir. Daha fazla bilgi için bkz. Takım Projeniz için Kaynak Alma.

TFSBuild.proj dosyanızı kaynak denetimi varsayılan klasöründe saklanan, dosyanın yerel kopyasını bulunan <kök>: \Yerel çalışma\TeamBuildTypes\MyBuildName istemci bilgisayarda. Yerel çalışma olduğu, ekip projeniz eşleştirilmiş, yerel klasör MyTeamProject ekip proje adıdır ve MyBuildName bu TFSBuild.proj dosyasıyla ilişkili olan ilk yapı tanımına verdiğiniz addır.

dll dosyasını kaynak denetimi ekleme

Özel görev içeren dll Dosyasının oluşturduktan sonra onu eklemeniz gerekir Team Foundation sürüm denetimi. Kullanabileceğiniz tf add ve tf checkin ekleyin ve yapı tanımı TFSBuild.proj dosyasıyla aynı konuma dll kontrol komutları Daha fazla bilgi için bkz:Ekle Komutu ve Checkin Komutu.

Sizin derlemede denetleyin ve eklemek için

Tıklatın Start, üzerine Programlar, Microsoft Visual Studio 9.0, Visual Studio Araçlarıve i Visual Studio 2008 komut istemi. Eşleştirdiğiniz özelleştirmek isteyebilirsiniz yapý türü içeren ekip proje için yerel çalışma alanını açın.

Örneğin, aşağıdaki komut istemine yazın.

> cd c:\MyTeamProject

Burada MyTeamProject adı ekip proje.
TFSBuild.proj dosyasının depolandığı konuma taşıyın.

Örneğin, aşağıdaki komut istemine yazın.

c:\MyTeamProject>cd TeamBuildTypes\MyBuildName

Burada MyBuildName adı yapı tanımı.
Dosyaya eklemek için Team Foundation sürüm denetimi, türü aşağıdaki komutu.

c:\MyTeamProject\TeamBuildTypes\MyBuildName> tf add MyTask.dll
Dosyanızı denetlemek için Team Foundation sürüm denetimi, türü aşağıdaki komutu.

c:\MyTeamProject\TeamBuildTypes\MyBuildName> tf checkin MyTask.dll

Ayrıca Ekip Gezgini için dll ekleme Team Foundation sürüm denetimi. Daha fazla bilgi için bkz. Sürüm kontrolü için dosyaları Ekle.

Görev kaydı yapılıyor

Görevi oluşturduktan sonra bunu sizin göreviniz belirterek kaydetmeniz gerekir bir UsingTask öğesi TFSBuild.proj dosyası. UsingTask Öğesi içeren derleme göreve eşleştirirgörev uygulaması. Daha fazla bilgi için bkz. UsingTask öğe (MSBuild).

TFSBuild.proj dosyasını değiştirerek görevi kaydetmek için

Visual Studio uygulamasını başlatın.
Dan değiştirmek istediğiniz TFSBuild.proj dosyayı kullanıma Team Foundation sürüm denetimi ve içinde açın Visual Studio xml-Düzenleyicisi.

Ekleme UsingTask öğesi TFSBuild.proj dosyasının hemen sonra Al deyimi.

<UsingTask 
    TaskName="BuildNumberGenerator.BuildNumberGenerator" 
    AssemblyFile="MyTask.dll"/>

Göreviniz içine eklemek için BuildNumberOverrideTarget içine aşağıdaki xml eklemek, hedef <Target></Target> etiketler, sonuna kadar TFSBuild.proj dosyası.

</ItemGroup>
  <Target Name = "BuildNumberOverrideTarget" >
    <BuildNumberGenerator> 
    <Output TaskParameter="BuildNumber" PropertyName="BuildNumber"/> 
    </BuildNumberGenerator> 
  </Target>
</Project>

Tıklatın Dosya,'ı kaydetmek yaptığınız değişiklikleri kaydedin ve sonra TFSBuild.proj kapatın.

Not

TFSBuild.proj dosyasına bu değişiklikleri yaptıktan sonra xml şemasına uyarılarla alırsınız. Bu uyarılar yok sayabilirsiniz.
TFSBuild.proj denetlemek için kaynak denetimi yeniden.
TFSBuild.proj Dosya değiştirilmiş ve kaydedilen değişiklikleri sonra Team Foundation sürüm denetimi, çalıştırın yapı tanımı.

Daha fazla bilgi için bkz. Sıra bir yapı.

Özel Yapı numarası oluşturmak Explorer'da görüntüleyebilirsiniz. Daha fazla bilgi için bkz. Çalışan yapı ilerlemesini izleme.

Ayrıca bkz.

Kavramlar

Yükseltme şablonu kullanarak bir yapı tanımlar

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

Diğer Kaynaklar

Uygulama oluşturma

Aracılığıyla paylaş