Team Foundation Build 環境變數

  • 發行項

您可以使用 TF BUILD 環境變數取得建置流程邏輯所需的資料金鑰位元。 例如，您可以取得來源資料夾的路徑，也可以取得包含欲置放輸出之資料夾的路徑。

  • TF_BUILD 環境變數

  • 在 MSBuild 中使用環境變數

  • 在程式或指令碼中使用環境變數

  • 在自訂建置流程中使用環境變數

TF_BUILD 環境變數

  • TF_BUILD：TFBuild 將其設定為 True，以便您可以基於 TFBuild 是否執行指令碼，將部分指令碼設定為條件。

  • TF_BUILD_BINARIESDIRECTORY：建置流程從中將輸出檔案複製到預備環境位置的目錄。 這個目錄是組建代理程式工作目錄的子目錄。 例如：C:\Build\BuildBot3\CoolApp\CIBuild\bin。

    TFBuild 會自動建立這個目錄並將組建輸出放在其中，除非您將輸出位置設為 AsConfigured。 在這種情況下，您可以使用指令碼複製要置放到這個目錄中的檔案。

    注意事項注意事項

    您的指令碼也應該可以視需要處理建立或清除這個目錄。如需範例，請參閱 在建置流程中執行指令碼。

  • TF_BUILD_BUILDDEFINITIONNAME：組建定義的名稱。

  • TF_BUILD_BUILDDIRECTORY：組建代理程式工作目錄。 例如：C:\Build\BuildBot3\CoolApp\CIBuild。

  • TF_BUILD_BUILDNUMBER：組建的組建編號。 例如：CIBuild_20130613.6。

  • TF_BUILD_BUILDREASON：組建的組建原因。 例如：IndividualCI。

  • TF_BUILD_BUILDURI：組建的 URI。 例如：vstfs:///Build/Build/35。

  • TF_BUILD_COLLECTIONURI Team 專案集合的 URI。 例如：http://fabrikam-2:8080/tfs/DefaultCollection (您必須已安裝 Visual Studio 2012 Update 2 或後續版本才能使用此環境變數。)

  • TF_BUILD_DROPLOCATION：置放位置。 置放到 UNC 路徑的範例：\\fabrikam-1\Drops\CIBuild\CIBuild_20130613.6。 置放到 Team Foundation Server 的範例：#/11/drop。

  • TF_BUILD_SOURCEGETVERSION：建置的版本 (TFVC 變更集或 Git 認可)。

  • TF_BUILD_SOURCESDIRECTORY：組建代理程式工作目錄的來源子目錄。 這個目錄包含原始程式碼。 例如：C:\Build\BuildBot3\CoolApp\CIBuild\src。

    如需範例，請參閱 在建置流程中執行指令碼。

  • TF_BUILD_TESTRESULTSDIRECTORY：組建代理程式工作目錄的測試結果子目錄。 例如：C:\Build\BuildBot3\CoolApp\CIBuild\tst。

在 MSBuild 中使用環境變數資料

當您使用 MSBuild 編譯您的程式碼 (透過預設範本或使用 MSBuild 活動的自訂建置流程) 時，可以傳入引數控制它的運作方式。 此外，有些程式碼專案包含特殊目標，您可以使用這些引數叫用。 您可以使用 TF_BUILD 環境變數啟用這些選項，而不必編輯程式碼專案檔的 XML。

例如，您要使用預設範本建置 ASP.Net Web 應用程式專案，但您只要將 Web 封裝放入至預備環境位置。 若要這麼做，請編輯組建定義和：

  • 將 [輸出位置] 流程參數設定為 AsConfigured。

  • 將類似下列選項加入至 [MSBuild 引數]：

    /p:DeployOnBuild=true;DeployMethod=Package /p:DefaultPackageOutputDir=”$(TF_BUILD_BINARIESDIRECTORY)”\WebPackage

在程式或指令碼中使用環境變數資料

您也可以將 TF_BUILD 環境變數傳遞至不屬於您的程式或指令碼。 只要您的指令碼使用以上的指定名稱存取它們，您不需要將它們傳遞至您的指令碼。 如需範例，請參閱在建置流程中執行指令碼。

在自訂建置流程中使用環境變數資料

如果您需在 自訂建置流程範本使用環境變數，可以使用 GetEnvironmentVariable 活動取得資料。 您可以從任何 WellKnownEnvironmentVariables 取得資料。

例如，若要取得二進位檔目錄的路徑，請將GetEnvironmentVariable 活動的 Name 屬性設為 Microsoft.TeamFoundation.Build.Activities.Extensions.WellKnownEnvironmentVariables.BinariesDirectory。