WixSharp 项目教程

WixSharp 项目教程

wixsharpFramework for building a complete MSI or WiX source code by using script files written with C# syntax.项目地址:https://gitcode.com/gh_mirrors/wi/wixsharp

1. 项目的目录结构及介绍

WixSharp 项目的目录结构如下：

wixsharp/
├── Documentation/
│   ├── Source/
│   └── docs/
├── Samples/
│   ├── Common/
│   ├── Setup/
│   └── VSProjectTemplates/
├── Source/
│   ├── WixSharp/
│   └── WixSharp.Samples/
├── .gitattributes
├── .gitignore
├── LICENSE
├── README.md
├── appveyor.yml

目录介绍

• Documentation/: 包含项目的文档源文件和生成的文档。
• Samples/: 包含各种示例项目，展示如何使用 WixSharp 进行不同类型的安装程序开发。
• Source/: 包含 WixSharp 的核心源代码和示例代码。
• .gitattributes: Git 属性配置文件。
• .gitignore: Git 忽略配置文件。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• appveyor.yml: AppVeyor 持续集成配置文件。

2. 项目的启动文件介绍

WixSharp 项目的启动文件主要是 Program.cs 文件，通常位于示例项目的根目录下。以下是一个典型的启动文件示例：

using System;
using WixSharp;

class Program
{
    static void Main()
    {
        var project = new Project("MyProduct",
                          new Dir(@"%ProgramFiles%\My Company\My Product",
                              new File("Program.cs")));

        project.GUID = new Guid("6f330b47-2577-43ad-9095-1861ba25889b");
        project.PreserveTempFiles = true;
        project.OutDir = "output";

        project.BuildMsi();
    }
}

启动文件介绍

• Project 类: 定义安装程序的主要结构和内容。
• Dir 类: 定义安装目录和文件。
• File 类: 定义要安装的文件。
• project.BuildMsi(): 生成 MSI 安装包。

3. 项目的配置文件介绍

WixSharp 项目的配置文件主要是 appveyor.yml 文件，用于配置 AppVeyor 持续集成服务。以下是一个典型的 appveyor.yml 文件示例：

version: '{build}'
image: Visual Studio 2019
configuration: Release
before_build:
- cmd: nuget restore
build:
  project: WixSharp.sln
  verbosity: minimal
after_build:
- cmd: nuget pack WixSharp -Prop Configuration=Release -OutputDirectory artifacts
artifacts:
- path: 'artifacts\*.nupkg'
  name: NuGet Packages
deploy:
- provider: NuGet
  api_key:
    secure: <your_secure_api_key>
  artifact: /.*\.nupkg/
  on:
    branch: master

配置文件介绍

• version: 定义构建版本。
• image: 指定使用的 Visual Studio 镜像。
• configuration: 指定构建配置（如 Release）。
• before_build: 构建前的准备工作，如还原 NuGet 包。
• build: 指定要构建的项目解决方案文件。
• after_build: 构建后的操作，如打包 NuGet 包。
• artifacts: 定义构建产物。
• deploy: 定义部署操作，如发布 NuGet 包。

以上是 WixSharp 项目的基本教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些内容能帮助你更好地理解和使用 WixSharp 项目。

wixsharpFramework for building a complete MSI or WiX source code by using script files written with C# syntax.项目地址:https://gitcode.com/gh_mirrors/wi/wixsharp