How to work with 'With Sources' installations
From Visual WebGui Wiki
Contents |
Overview
When working with a "With Sources" installation of Visual WebGui (as opposed to without sources), you need to do a few things differently and make sure other are done right.
This article will discuss what you need to do differently and provides you with references to some relevant articles discussing the subject.
Preperations - required for 6.4.0P3 and later versions - and only when directly using SVN sources
As of version 6.4P3 the compilation process includes a build task that makes the resx resources safe for non full trust environments. This information is valuable only for you guys that are working directly with the SVN sources and it means that you will need to "install" a build task which is a folder that should be located in "C:\Program Files\MSBuild". The easiest way to do it is to create a folder named "Gizmox" with in the MSBuild directory and to checkout using tortoise from the following url "http://72.55.165.182/svn/Public/Build/Gizmox".
Detailed steps to follow:
- Ensure you have this folder (which you should have already): C:\Program Files\MSBuild
- Create a folder there and name it Gizmox
- Right click on that folder and select SVN Checkout (assuming Tortouise SVN client)
- The checkout path should be the one given: http://72.55.165.182/svn/Public/Build/Gizmox
Remember that this is only relavent when working with the SVN sources as installed versions do the job for you. Forum discussions follow:
- Initial announcement of 6.4.0P3, where this step became relevant
- Cannot build using version 6.4 sources
Extra references needed
When you create a new project in Visual WebGui, you get the following references added for you automatically:
- Gizmox.WebGUI.Common
- Gizmox.WebGUI.Forms
- Gizmox.WebGUI.Server
The above references are enough for you if you are working without sources. Using a "With Sources" installations, you need a few extra. The references you need for that type of installations as a minimum is listed below, with the new ones bolded:
- Gizmox.WebGUI.Client
- Gizmox.WebGUI.Common
- Gizmox.WebGUI.Common.Design
- Gizmox.WebGUI.Common.Design.Skins (Only if using version 6.4 or above)
- Gizmox.WebGUI.Forms
- Gizmox.WebGUI.Forms.Design
- Gizmox.WebGUI.Server
If the Office extension assembly is being used, remember to also include the "Design" assembly in your project references:
- Gizmox.WebGui.Forms.Office
- Gizmox.WebGui.Forms.Office.Design
Finally, in version 6.4, some functionality requires that you add the following to your list of referenced assemblies.
- Gizmox.WebGUI.Forms.Themes
Copy Local
As for all Visual WebGui application projects, make sure all the Gizmox DLLs you reference have their properties set with "Copy Local" = True.
Clearing Cache
To prevent caching issues, you should step through the Clear Cache procedure every now and then. This is especially important after you install a new / different version of Visual WebGui on your workstation.
