How does it work?

1) Install the extension into Visual Studio

2) Then, open a solution (Caitlyn only works for opened solutions).

Configuring Caitlyn

Configuring root projects

Caitlyn stores its configuration file (xml) in the root of your solution with the name "Caitlyn.xml".

Root projects are the projects that can be used as the base for other projects to link to. This can be any project, but by default all NET35 projects are added when there is no configuration file or when the configuration file is corrupted.

caitlyn_config_rootprojects.png

Then you can start configuring the rules:

caitlyn_config_rules.png

Configuration rules

By default, Caitlyn simply links to all files in each project, but sometimes you just don't want all files to be linked. For example, a Window isn't very useful in Windows Phone 7 and WinRT. Therefore, it is possible to add two types of rules:

DoNotAdd
This rule allows you to skip the adding of items. This can be single items or a whole project directory. You can select which target projects it should apply to.

For example, this is very useful when the Windows folder should not be linked in WP7 and WinRT.

DoNotRemove
This rule allows you to skip the removal of items. This can be single items or a whole project directory. You can select which target projects it should apply to.

For example, this is very usefull when you don't want to remove a linked file in an SL5 project because it uses a file from SL4, but your root project is currently NET35.

Adding a rule is very simple. Simply click the add button and type the name of the item, or even better, simply select it from your project structure). Then select the type of the rule and to which target projects it applies to.

You can add a rule via the following window:

caitlyn_config_ruledetails.png

Selecting the name is very easy using the "..." button:

caitlyn_projectitem_selector.png

Running Caitlyn

Once you have created the configuration (when you have items that need to be skipped), you can start running Caitlyn.

1) Select your root project (will be selected by default in the next window)
2) Choose "Caitlyn => Link projects..."
3) You will see the following window. Make sure that the right root project and the right target projects are selected. Then simply click OK and you are done!

caitlyn_linkprojects.png

Happy coding :)

Last edited Feb 9, 2012 at 9:31 PM by GeertvanHorrik, version 4

Comments

No comments yet.