Wix打包系列（五） 部署数据库

admin

    很多人在使用vs进行打包的时候，经常会为数据库部署的问题犯愁，即便是重写Installer类的方法，也不是很可靠方便，下面我们来看看在wix中如何部署数据库。

    5.1 创建数据库

    wix包含数据库的相关链接库，需要为wix添加如下命名空间：

1. <Wix xmlns="http://schemas.microsoft.com/wix/2006/wi"
   
2. xmlns:util='http://schemas.microsoft.com/wix/UtilExtension'
   
3. xmlns:sql='http://schemas.microsoft.com/wix/SqlExtension'>

复制代码

       接着在Product添加如下声明语句：

<util:User Id='SQLUser' Name='[DBUSERNAME]' Password='[DBPASSWORD]' />
   这里声明了连接数据库的用户名和密码，它们的值引用了DBConfigDlg对话框中用户名和密码输入框的属性值
   然后我们添加一个Component，作为安装数据库的组件，并且将它包含在单独的ComponentGroup下：

1. <Fragment>
   
2. <ComponentGroup Id="DataBaseGroup">
   
3. <Component KeyPath="yes" Id='SqlComponent' Directory ='INSTALLDIR' Guid='{94443B4E-46D4-4edb-A188-0C8074CFF946}'>
   
4. <sql:SqlDatabase Id='SqlDatabase' Database='[DBNAME]' User='SQLUser' Server='[SERVERNAME]' ConfirmOverwrite='yes'
   
5. 
   
6. CreateOnInstall='yes' CreateOnReinstall='no' DropOnUninstall='no' DropOnReinstall='no' ContinueOnError='no'>
   
7. <sql:SqlScript Id='CreateObjSQLScript' ExecuteOnInstall='yes' ExecuteOnReinstall='no' BinaryKey='CreateDBObj' Sequence='1' />
   
8. <sql:SqlScript Id='CreateRecordsSQLScript' ExecuteOnInstall='yes' ExecuteOnReinstall='no' BinaryKey='CreateDBRecords' Sequence='2' />
   
9. </sql:SqlDatabase>
   
10. </Component>
    
11. </ComponentGroup>
    
12. 
    
13. ...
    
14. </Fragment>

复制代码

    sql:SqlDatabase 标签的User属性是前面定义的util:User标签的Id标识；

    Database和Server属性是数据库名称和服务器名称，它们都引用了DBConfigDlg对话框中数据库和服务器输入框的属性值；
    CreateOnInstall属性设置是否在安装的时候创建数据库，设置为yes，如果服务器上不存在名为[DBNAME]的数据库，则会创建该数据库，因此我们不需要编写创建数据库的脚本；如果数据库已存在，则会在存在的数据库上执行标签内部数据库操作，不会出现重复创建数据库的错误。如果想要在数据库已存在的情况提示用户是否覆盖安装数据库，则将ConfirmOverwrite属性设置为yes。
    CreateOnReinstall属性设置是否在Reinstall的时候创建数据库，设置为no，Reinstall的时候不会创建数据库，但是会执行数据库标签内部的SqlScript 操作。这里的Reinstall是指修复、更改安装或者在命令行模式下使用Reinstall参数进行安装的情况下，而卸载后重新安装属于Install的范畴。
    DropOnUninstall属性设置是否在卸载程序的时候同时卸载安装数据库，这里最好设置为no，删除数据库可以直接在企业管理器中进行，如果设置为yes了，而数据库发生改变，会出现程序无法卸载的情况；DropOnReinstall也是一样。
    ContinueOnError属性设置数据库安装错误的时候是否能继续整个程序的安装进度，如果设置为yes，则数据库安装出错时会弹出提示，点击继续后可以继续安装，设置为no，则会终止并回滚安装。

    5.2 执行SQL脚本

    SqlDatabase 里定义了两个SqlScript，它是执行sql脚本文件的语句，因此还要添加2个Binary文件，里面包含我们执行数据库建表和初始数据的sql语句：
<Binary Id='CreateDBObj' SourceFile='$(var.Version)/CreateObject.sql' />
<Binary Id='CreateDBRecords' SourceFile='$(var.Version)/CreateRecords.sql' />
   
    CreateObject.sql是创建数据库对象的语句，可以直接使用从sql server中生成sql脚本，这里稍作修改，以便于更改或修复数据库的时候也使用该脚本。

1. if exists (select * from dbo.sysobjects where id = object_id(N'[dbo].[vw_People]') and OBJECTPROPERTY(id, N'IsView') = 1)
   
2. drop view [dbo].[vw_People]
   
3. GO
   
4. 
   
5. if not exists (select * from dbo.sysobjects where id = object_id(N'[dbo].[peopel]') and OBJECTPROPERTY(id, N'IsUserTable') = 1)
   
6. CREATE TABLE [dbo].[peopel] (
   
7.     [id] [int] NOT NULL ,
   
8.     [name] [varchar] (50) COLLATE Chinese_PRC_CI_AS NULL ,
   
9.     [sex] [varchar] (50) COLLATE Chinese_PRC_CI_AS NULL
   
10. ) ON [PRIMARY]
    
11. GO
    
12. 
    
13. if not exists (select * from dbo.sysobjects where id = object_id(N'[dbo].[Country]') and OBJECTPROPERTY(id, N'IsUserTable') = 1)
    
14. CREATE TABLE [dbo].[Country] (
    
15.     [NameEn] [varchar] (50) COLLATE Chinese_PRC_CI_AS NULL ,
    
16.     [NameCn] [nvarchar] (50) COLLATE Chinese_PRC_CI_AS NULL ,
    
17.     [Short] [varchar] (50) COLLATE Chinese_PRC_CI_AS NULL
    
18. ) ON [PRIMARY]
    
19. GO
    
20. 
    
21. if exists (select object_name(parent_obj) from sysobjects where xtype='pk' and id = object_id(N'[dbo].[PK_peopel]'))
    
22. ALTER TABLE [dbo].[peopel] DROP CONSTRAINT [PK_peopel]
    
23. ALTER TABLE [dbo].[peopel] WITH NOCHECK ADD
    
24.     CONSTRAINT [PK_peopel] PRIMARY KEY  CLUSTERED
    
25.     (
    
26.         [id]
    
27.     )  ON [PRIMARY]
    
28. GO
    
29. 
    
30. 
    
31. SET QUOTED_IDENTIFIER ON
    
32. GO
    
33. SET ANSI_NULLS ON
    
34. GO
    
35. 
    
36. CREATE VIEW dbo.vw_People
    
37. AS
    
38. SELECT TOP 100 PERCENT id, name, sex
    
39. FROM dbo.peopel
    
40. ORDER BY id
    
41. 
    
42. GO
    
43. SET QUOTED_IDENTIFIER OFF
    
44. GO
    
45. SET ANSI_NULLS ON
    
46. GO

复制代码

    CreateRecords.sql是生成初始数据的脚本：

1. DELETE FROM [Country]
   
2. GO
   
3. 
   
4. INSERT INTO [Country] ([NameEn],[NameCn],[Short]) VALUES('China','中国','CN')
   
5. INSERT INTO [Country] ([NameEn],[NameCn],[Short]) VALUES('America','美国','US')
   
6. INSERT INTO [Country] ([NameEn],[NameCn],[Short]) VALUES('Japan','日本','JP')
   
7. GO

复制代码

    SqlScript  是sql脚本的语句，Sequence属性设置执行的顺序，ExecuteOnInstall和ExecuteOnReinstall设置是否在install或者Reinstall时执行；
    需要注意的是，这里的所有Reinstall操作都设置为no，也就是说在修复和更改安装的时候不会执行数据库脚本的语句，如果在安装的录入的数据库信息有修改，那么将不能把Reinstall相关的操作设置为yes，因为示例中Reinstall模式不会有数据库信息录入界面，那么数据库相关的属性将是我们定义的默认值，而不会是在Install模式下输入的值。要想在Reinstall模式下修复数据库，需要进行以下步骤操作：
    1、添加CustomAction，在Install的时候执行（即执行条件为Not Installed），执行顺序在InstallFinalize之后，该Action将用户修改后的数据库连接串保存到安装目录下的config配置文件中
    2、添加CustomAction，在ReInstall的时候执行（即执行条件为Installed），执行顺序在InstallInitialize之前，该Action将从安装在安装目录下的配置文件中读取数据库连接串，然后改变DBNAME等属性的值为连接串中相关属性的值
    3、设置ExecuteOnReinstall属性为yes
    这里我们就不提供示例了，理解了前面几章内容的话应该很容易实现的；另一种方法是将DBConfigDlg对话框插入到维护模式的UI列表中，让更改和修复安装时也可以录入数据库信息，不过感觉这么做不是很好。

    5.3  编译运行
    由于运行数据库的Component是放在单独的ComponentGroup中，   这个ComponentGroup并没有包含在安装的Feature列表中，因此我们需要在Feature列表中添加一项：

1. <Feature Id='SqlConfigFeature' Title='Database' Description='Sql Server Config.' Level='1'>
   
2. <ComponentGroupRef Id='DataBaseGroup'/>
   
3. </Feature>

复制代码

   最后我们就可以编译链接代码了，由于引用了数据库组件，因此编译时要添加相应的选项：
candle.exe -dVersion=1.0.0  -ext WixUtilExtension -ext WixSqlExtension Sample.wxs DbConfigDlg.wxs -out 1.0.0/
light.exe -loc WixUI_zh-cn.wxl  -ext WixUIExtension -ext WixUtilExtension -ext WixSqlExtension -out 1.0.0/Sample.msi 1.0.0/Sample.wixobj 1.0.0/DbConfigDlg.wixobj

    5.4  本地化
    WixSqlExtension是wix自带的组件，本身只包含英文的资源，要在安装时显示中文资源则需要从 WixSqlExtension组件中提取出英文的资源文件，然后翻译为中文的资源文件；WixSqlExtension的中文资源文件在网上找不到的。