Fake Assembly 無法自動產生 *.Fakes dll 及出現 build fail

在 如何 Mock System.Web.Hosting.HostingEnvironment.MapPath 虛擬路徑 提到同事想要 mock System.Web.Hosting.HostingEnvironment.MapPath 的值，試了半天決定用 fake dll 的方法來直接解決，但過程不太順利，所以留下紀錄

重現問題：無法出現 System.Web.Fakes/System.Web.Http.Fakes dll

  1. 加入 Fakes assembly

    • 開啟測試專案的 References 資料夾

    • System.Web.Http 上按右鍵 –> Add Fakes Assembly

      1addfake

  2. 未出現 System.Web.Http.Fakes/System.Web.Fakes dll

    • Fakes 資料夾已產生 System.Web.Http.fakes/System.Web.fakes 的設定檔

    • References 資料夾則沒有出現對應版本的 System.Web.Http.{版本}.Fakes/System.Web.{版本}.Fakes dll

      2without

錯誤訊息 1：CS0430

  1. 訊息內容

    1
    2
    3
    4
    5
    Error    CS0430    The extern alias 'swhod' was not specified in a /reference option [C:\Users\yowko.tsai\documents\visual studio 2015\Projects\DemoUnitTesting\DemoWebApiTesting.Tests\obj\Debug\Fakes\swh\f.csproj]    DemoWebApiTesting.Tests    C:\Users\yowko.tsai\documents\visual studio 2015\Projects\DemoUnitTesting\DemoWebApiTesting.Tests\f.cs    19    Active
       
    Error        project compilation failed with exit code 1    DemoWebApiTesting.Tests    C:\Users\yowko.tsai\documents\visual studio 2015\Projects\DemoUnitTesting\DemoWebApiTesting.Tests\GENERATEFAKES        
       
    Error        project compilation failed with exit code 1    DemoWebApiTesting.Tests    C:\Users\yowko.tsai\documents\visual studio 2015\Projects\DemoUnitTesting\DemoWebApiTesting.Tests\GENERATEFAKES

  2. 錯誤截圖

6buildfail

  1. 解決方式

    • System.Web.Http

      1. 開啟 Fakes 資料夾中的 System.Web.Http.fakes 設定檔

        3fakesconfig

        4fakesconfigcontent

      2. 加入下列設定

        1
        2
        3
        4
        5
        6
        7
        8
        <StubGeneration>
            <Clear />
            <Add Interfaces="true"/>
        </StubGeneration>
        <ShimGeneration>
            <Clear />
            <Add Namespace="System.Web.Http.ExceptionHandling"/>
        </ShimGeneration>

      3. 設定前後比較

        • 修改前

          1
          2
          3
          <Fakes xmlns="http://schemas.microsoft.com/fakes/2011/">
            <Assembly Name="System.Web.Http" Version="5.2.3.0"/>
          </Fakes>

        • 修改後

          1
          2
          3
          4
          5
          6
          7
          8
          9
          10
          11
          <Fakes xmlns="http://schemas.microsoft.com/fakes/2011/">
            <Assembly Name="System.Web.Http" Version="5.2.3.0"/>
            <StubGeneration>
              <Clear />
              <Add Interfaces="true"/>
            </StubGeneration>
            <ShimGeneration>
              <Clear />
              <Add Namespace="System.Web.Http.ExceptionHandling"/>
            </ShimGeneration>
          </Fakes>

    • System.Web

      1. 開啟 Fakes 資料夾中的 System.Web.fakes 設定檔

      2. 加入下列設定

        1
        2
        3
        4
        5
        6
        7
        8
        <StubGeneration>
            <Clear />
            <Add Interfaces="true"/>
        </StubGeneration>
        <ShimGeneration>
            <Clear />
            <Add Namespace="System.Web"/>
        </ShimGeneration>

      3. 設定前後比較

        • 修改前

          1
          2
          3
          <Fakes xmlns="http://schemas.microsoft.com/fakes/2011/">
            <Assembly Name="System.Web" Version="4.0.0.0"/>
          </Fakes>

        • 修改後

          1
          2
          3
          4
          5
          6
          7
          8
          9
          10
          11
          <Fakes xmlns="http://schemas.microsoft.com/fakes/2011/">
            <Assembly Name="System.Web" Version="4.0.0.0"/>
            <StubGeneration>
              <Clear />
              <Add Interfaces="true"/>
            </StubGeneration>
            <ShimGeneration>
              <Clear />
              <Add Namespace="System.Web"/>
            </ShimGeneration>
          </Fakes>

    • 重新執行產生 fake dll

      1. 找個任意其他的 dll 再執行 Add Fakes Assembly一次

      2. 可以使用測試目標的 dll or anyone else 執行後就會出現

        5anotherfake

      3. 刪除不需要的 fake dll 跟 設定檔

        7success

錯誤訊息：CS0234

  1. 訊息內容

    1
    2
    3
    4
    Error    CS0234    The type or namespace name 'EventSourceCreatedEventArgs' does not exist in the namespace 'System.Diagnostics.Tracing' (are you missing an assembly reference?) [C:\Users\yowko.tsai\documents\visual studio 2015\Projects\TestFakeError\TestFakeError.Tests\obj\Debug\Fakes\m\f.csproj]    TestFakeError.Tests    C:\Users\yowko.tsai\documents\visual studio 2015\Projects\TestFakeError\TestFakeError.Tests\f.cs    17698    Active
    Error        project compilation failed with exit code 1    TestFakeError.Tests    C:\Users\yowko.tsai\documents\visual studio 2015\Projects\TestFakeError\TestFakeError.Tests\GENERATEFAKES        
    Error        project compilation failed with exit code 1    TestFakeError.Tests    C:\Users\yowko.tsai\documents\visual studio 2015\Projects\TestFakeError\TestFakeError.Tests\GENERATEFAKES

  2. 錯誤畫面

    8mscorliberror

  3. 解決方式

    • 開啟 Fakes 資料夾中的 mscorlib.fakes 設定檔

    • 加入下列設定

      1
      2
      3
      4
      5
      <StubGeneration>
          <Remove FullName="System.Diagnostics.Tracing"/>
          <Remove FullName="System.Text.Encoding"/>
          <Remove FullName="System.Security.Cryptography" />
      </StubGeneration>

    • 設定前後比較

      • 修改前

        1
        2
        3
        <Fakes xmlns="http://schemas.microsoft.com/fakes/2011/">
          <Assembly Name="mscorlib" Version="4.0.0.0"/>
        </Fakes>

      • 修改後

        1
        2
        3
        4
        5
        6
        7
        8
        <Fakes xmlns="http://schemas.microsoft.com/fakes/2011/">
          <Assembly Name="mscorlib" Version="4.0.0.0"/>
          <StubGeneration>
            <Remove FullName="System.Diagnostics.Tracing"/>
            <Remove FullName="System.Text.Encoding"/>
            <Remove FullName="System.Security.Cryptography" />
          </StubGeneration>
        </Fakes>

錯誤訊息：Unexpected error returned by SetDetourProvider

  1. 訊息內容

    1
    2
    Microsoft.QualityTools.Testing.Fakes.UnitTestIsolation.UnitTestIsolationException
    "Unexpected error returned by SetDetourProvider in profiler library 'C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\CommonExtensions\Microsoft\IntelliTrace\14.0.0\Microsoft.IntelliTrace.Profiler.14.0.0.dll'."

  2. 錯誤畫面

    9intellitrace

  3. 解決方式

    • 關閉 IntelliTrace 的 call information

      1. Visual Studio 主選單 Tools tab –> Options…

        10vstools

      2. IntelliTrace –> General (下列兩個方式擇一即可)

        11disablecallinfo

        • uncheck Enable IntelliTrace
        • IntelliTrace events only

參考資料

  1. Fakes issue with System.Web.Http
  2. Fakes Issue with System.Web