Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

For now, we can develop the framework via Framework.sln and make sure to not change the API of the framework as much. Although, when we decide that something should go, there is nothing to stop you, since the product using that functionality has pinned its version of the framework and can work along just fine.

Building and Testing Debug version of Framework

If you have changed the framework and want to test this with a product you can use the following steps to verify the change in the framework for your product:

  1. You have changed something in the frame.sln solution and you have build the solution succesfully
  2. Open the product (NGHS.sln) you want to test / debug your new framwork with
  3. Restore all packages for this product
  4. Close the solution
  5. remove the generated bin folder for this solution
  6. Open powershell
  7. In Powershell go to the folder where you checked out the framework
  8. In Powershell goto subfolder sdk (so: svn://trunk/Framework/sdk)
  9. Run powershell script : ./copy-framework-bin-to-product.ps1 [PRODUCTNAME] [BUILDCONFIGURATION]
    1. This will copy the just build dlls from the frame work in the packages folder of the product
    2. Like: PS D:\svn\trunk\Framework\sdk> .\copy-framework-bin-to-product.ps1 NGHS Debug
    3. for more help on script use:  
      1. get-help .\copy-framework-bin-to-product.ps1
    4. for more examples: 
      1. get-help .\copy-framework-bin-to-product.ps1 -examples
    5. for more detail: 
      1. get-help .\copy-framework-bin-to-product.ps1 -detailed
  10. Open the product solution file again with visual studio
  11. Build your product with latest locally build framework

 

Warning

If you get build errors in your product like

  • Module 'DelftTools.Shell.Core, Version=X.X.X.XXXX, Culture=neutral, PublicKeyToken=NUll' should be referenced

The reference in the project of your product is probably

 

 

Building and Testing new Framework with all products in TeamCity

 

NuGet Specifications

The NuGet specifications can be found in svn under trunk/Framework/sdk. I'm not going into detail at the moment on how these specifications work. There is enough reference material on the interwebz. There are two folders in the sdk folder. packages and tools. The tools folder contains some utility functions that can be useful during the install.ps1 script that is run when the NuGet package is installed into the csproj.

...