Using the VS Templates for Composite-WPF-Guidance

  • Article

This is about using the templates for a new project.

First of all you need to download the templates and install them from the links below.

Download the ZIP-File containing sources and built binaries here.

See the post on how to install the binaries or build the sources here.

 

Let's start setting up our new project:

  1. Create a new root folder for your solution (e.g. C:\temp\DemoClient\).
  2. Within the root folder create a Libraries (or other named) folder for the P&P assemblies, like Unity and Composite App Library.
  3. Copy the necessary assemblies to the Libraries folder (build the Composite Application Guidance projects to get them):
     image
  4. Now open Visual Studio choose "File - New Project" and select "Composite WPF Solution" from "Visual C# > Composite App Guidance".
    image_thumb[1][1]
  5. Enter the name of your overall solution (like "CompositeClient") and specify the root folder created before.
    image 
    Important: "Create directory for solution" should be unchecked, to automatically insert references later. Press "OK" then.
  6. A new wizard pops up:
    image
    You can now change your root namespace or the namespaces for the shell and infrastructure project.
    It's important to specify the relative path to the Library folder (starting from the specified root folder). In this case it's Libraries. After that, the new solution is going to be created.
    image 
  7. Select "Add New Project" on the Modules folder.
    image
  8. Choose "Composite WPF Module" and enter the Modules path of the solution as the location
    (e.g. C:\temp\DemoClient\CompositeClient\Modules\).
    Enter a name for the module (e.g. CompositeClient.Modules.Foo) .
  9. The New Module Wizard pops up.
    image 
    Press Finish (or change the IModule class name or module namespace).
  10. A new project is created, containing an IModule implementation and a module controller class.
    image
  11. When choosing Add-New Item,you can add a new Composite WPF View and Presentation Model to the module.
    image 
    Enter a name for the new items (not containing "View" or any other types). Just use "DoFoo" for instance.
  12. The New View Wizard pops up, letting you choose the names for view, presentation model and interfaces.
    image
  13. Choose Finish.
  14. A new subfolder is created, containing the files necessary for the view.
    image

Note 1: When using the item template for the first time, you might get a dialog requesting to trust the template. Press trust there!

Note 2: The wizards say "Composite WPF Guidance Contrib", as I hope to get into the Contrib project with this ;-)