如何写自己的Guidance Packages（一）

开发一个guidance package的步骤如下：

• 定义 recipes ，包括定义参数（arguments）, 向导页面（wizards） 和 所执行的操作（actions）
• 定义 Visual Studio 模板文件（Template）。
• 设计 actions 。
• 书写参数类型编辑器和转换器，即editors 和 converters 。
• 定义 T4 模板 (如果一个 action 需要使用 T4 template 生成代码) 。
• 测试 package。
• 绑定 package 安装文件。

一个guidance package 包含下面的部分或者全部的文件:

• Guidance package 配置文件(是一个XML文档,必须)
• Visual Studio 模板文件(可使用VS自动生成,然后对生成的模板再做稍微更改即可)
• T4 模板(以.T4结尾,用于生成代码)
• 一些DLL文件,包括 actions, type editors, value providers和type converters (建议使用单一的DLL)

 

以下是一份Guidance package 配置文件，其中有注释：

 

<?xml version="1.0" encoding="utf-8" ?>
<GuidancePackage xmlns="http://schemas.microsoft.com/pag/gax-core"
    Name="这里是Guidance package的名字" 
    Caption="这里是标题"
    Description="这里是描述"
    Guid="51FCD4D0-B90C-4f11-B868-E9D71D8B7746" 
        BindingRecipe="BindingRecipe"
    SchemaVersion="1.0">
    <Recipes>
        <Recipe Name="这里是Recipe 名" Bound="是否有限制可以是true或false" Recurrent="执行后是否重新呈现，可以是true或者false">
            <Caption>这里是Recipe 标题</Caption>
            <Description>这里是Recipe 的描述.</Description>
            <HostData>
                <Icon ID="1046"/>
                <CommandBar Name="这里是该Recipe 可以绑定的位置，可供选择的有Solution，Solution Folder，Solution Add，Solution Folder Add，Project，Project Add，Folder，Item，Web Project，Web Item，Web Folder"/>
            </HostData>         

<GatheringServiceData>
            <Wizard xmlns="http://schemas.microsoft.com/pag/gax-wizards" SchemaVersion="1.0">
                <Pages>
                    <Page>
                        <Title>这里是Page的标题</Title>
                        <LinkTitle>这里是收集参数的向导页面的左侧显示的标题</LinkTitle>
                        <Fields>
                            <Field ValueName="参数名" Label="显示名"  
                                InvalidValueMessage="无效输入时显示的信息.">
                                <Tooltip>提示信息</Tooltip>
                            </Field>                           

                        </Fields>
                    </Page>

                </Pages>
            </Wizard>
        </GatheringServiceData>

<Actions>
                <Action 
                    Name="Action名" 
                    Type="HoLPackage.Actions.HelloWorldAction, HoLPackage" />
            </Actions>
        </Recipe>

</Recipes>
</GuidancePackage>