共用方式為

逐步解說：使用 BuildStep 工作加入建置步驟

  • 發行項

更新：2007 年 11 月

BuildStep 工作是專為 Team Foundation Server 所撰寫的 MSBuild 工作。您可以將一個或多個 BuildStep 項目加入方案組建定義中 TFSBuild.proj 檔案的 Target 項目，便可在組建中新增 BuildStep 工作。

必要條件

將 BuildStep 工作加入組建定義前，您必須先完成或確認下列項目：

必要的使用權限

若要執行本主題說明的程序，您必須將 [簽入] 及 [簽出] 權限設定為 [允許]。如需詳細資訊，請參閱 Team Foundation Server 使用權限。

若要使用 BuildStep 工作加入建置步驟，請執行下列步驟：

  • 將工作加入至專案檔

  • 將建置步驟資訊通知加入至專案檔

將工作加入至專案檔

您可以使用 BuildStep 工作新增與更新建置步驟。下列程序會說明如何修改 TFSBuild.proj 檔案：

  1. 新增建置步驟。

  2. 執行工作。

  3. 如果工作順利進行，將建置步驟狀態更新為 [成功]，反之，則標明為 [失敗]。

範例中的建置步驟會將原始檔案複製到新的位置。

若要在 TFSBuild.proj 檔案中新增及更新建置步驟

  1. 啟動 Visual Studio。

  2. 將要修正的 TFSBuild.proj 檔案從 Team Foundation 版本控制簽出，然後在 Visual Studio XML 編輯中開啟。

  3. 將下列樣 XML 加入至 <ItemGroup> 項目。您可以將這段 XML 加入現有的 <ItemGroup> 項目，或者也可以新增 <ItemGroup> 項目：

    注意事項：

    這個步驟中的程式碼會識別所複製之原始檔所在的資料夾。其他的 MSBuild 工作可能需要在 XML 中新增一些其他的內容。如需 MSBuild 工作必要條件的詳細資訊，請參閱 MSBuild 工作參考。

    		 
    <ItemGroup>
    <SourceFileFolder Include="C:\WorkingFolder\TeamBuildTypes\**\*.cs" />
</ItemGroup>

  4. 將下列 XML 加到 TFSBuild.proj 檔案的結尾，然後緊接著 </Project> 項目：

    </ItemGroup>
    <Target Name="BeforeCompile">        <BuildStep            TeamFoundationServerUrl="$(TeamFoundationServerUrl)"            BuildUri="$(BuildUri)"            Message="Working...">            <Output TaskParameter="Id" PropertyName="StepId" />        </BuildStep>        <!-- Perform a task... -->        <Copy SourceFiles="@(SourceFileFolder)"            DestinationFolder="C:\NewSourceFileFolder"        />        <BuildStep            TeamFoundationServerUrl="$(TeamFoundationServerUrl)"            BuildUri="$(BuildUri)"            Id="$(StepId)"            Status="Succeeded" />        <OnError ExecuteTargets="MarkBuildStepAsFailed" />    </Target>    <Target Name="MarkBuildStepAsFailed">        <BuildStep            TeamFoundationServerUrl="$(TeamFoundationServerUrl)"            BuildUri="$(BuildUri)"            Id="$(StepId)"            Status="Failed" />    </Target>
</Project>
    注意事項：

    如需 Team Foundation Build 目標的詳細資訊與可自訂的目標清單，請參閱可自訂的 Team Foundation Build 目標。

  5. 儲存變更，然後關閉 TFSBuild.proj。

  6. 將 TFSBuild.proj 檔簽入回版本控制中。

  7. 執行組建定義。

    如需詳細資訊，請參閱 HOW TO：佇列或啟動組建定義。

    您可以在 Build 總管中檢視建置步驟訊息，然後，您可以在建置記錄中看到完整的建置步驟產生過程與更新程序。您也可以在指定的目錄中看到所複製的檔案。如需詳細資訊，請參閱 HOW TO：監視建置進度。

將建置步驟資訊通知加入至專案檔

如果您不需要執行任何工作，但是仍然想要新增建置步驟資訊通知，請勿使用 Id Output 屬性，而要立即設定狀態。這個程序只會將訊息加入建置程序，而當您在 Build 總管中開啟組建時會看到這則訊息。

若要在 TFSBuild.proj 檔案中新增建置步驟資訊通知

  1. 啟動 Visual Studio。

  2. 將要修正的 TFSBuild.proj 檔案從 Team Foundation 版本控制簽出，然後在 Visual Studio XML 編輯中開啟。

  3. 將下列 XML 加到 TFSBuild.proj 檔案的結尾，然後緊接著 </Project> 標籤：

    </ItemGroup>
    <Target Name="AfterCompile">        <BuildStep            TeamFoundationServerUrl="$(TeamFoundationServerUrl)"            BuildUri="$(BuildUri)"            Message="Compile step complete."            Status="Succeeded" />    </Target>
</Project>
    注意事項：

    如需 Team Foundation Build 目標的詳細資訊與可自訂的目標清單，請參閱可自訂的 Team Foundation Build 目標。

  4. 儲存變更，然後關閉 TFSBuild.proj。

  5. 將 TFSBuild.proj 檔簽入回版本控制中。

  6. 執行組建定義。

    如需詳細資訊，請參閱 HOW TO：佇列或啟動組建定義。

    您可以在 Build 總管與建置記錄中檢視訊息。如需詳細資訊，請參閱 HOW TO：監視建置進度。

請參閱

參考

BuildStep 工作

其他資源

MSBuild 工作參考

MSBuild 專案檔案結構描述參考