Wix toolset как установить

Как установить WiX — Полное руководство и шаги по установке WiX

WIX обозначает установщик Windows XML — это набор инструментов, который поддерживает сборку пакетов установки Windows из исходного кода, который находится в файлах XML. WIX также поддерживает командную строку, поэтому разработчики могут интегрировать командную строку в процесс сборки для создания пакетов MSI и MSM для среды Windows. С помощью загрузчика, доступного в WiX, мы можем создать сборку установки, которая установит необходимые компоненты, такие как .NET Framework и другое связанное программное обеспечение, которое должно быть там во время выполнения. Комплект для разработки программного обеспечения WiX включает библиотеки, которые управляются и являются собственными и позволяют разработчикам писать код и приложения, которые будут работать с установщиком Windows.

Шаги по установке WiX на Windows

Давайте обсудим шаги, необходимые для установки WiX.

Шаг 1. Чтобы загрузить и установить WiX на Windows, перейдите на официальный веб-сайт WiX, как указано ниже, https://wixtoolset.org/releases и выберите рекомендуемый номер сборки, здесь мы выбрали V3.11.1 и нажмите кнопку загрузки.

Шаг 2: Вы будете перенаправлены к исходному коду, присутствующему в системе контроля версий GIT, и нам нужно выбрать соответствующий файл .exe и нажать «Загрузить». Здесь мы выбрали wix311.exe и нажмите на него, а затем он будет загружен

Шаг 3: После завершения загрузки нажмите на загруженный файл / запустите файл .exe, и мы получили ошибку, говорящую о том, что сначала необходимо установить .NET framework 3.5.1, как показано ниже:

Шаг 4: Теперь мы установим .NET Framework для Windows, чтобы мы могли двигаться дальше в установке WiX, и наберите .NET Framework 3.1.5 для Windows в Google и нажмите на первую ссылку, как показано ниже

Шаг 5: Теперь выберите соответствующий язык и нажмите на кнопку загрузки, как показано ниже

Шаг 6: После завершения загрузки запустите файл .exe, чтобы он выполнил поиск необходимых файлов, загрузил необходимые файлы и завершил установку, как показано ниже:

Шаг 7. Чтобы установить загруженные функции Windows в качестве .NET Framework 3.1.5, нам нужно включить функции Windows, что можно сделать следующим образом:

Сначала выберите панель управления, а затем в поиске панели управления введите функции Windows Turn, а затем вы получите вариант, а затем нажмите на него, а затем вы получите, как показано ниже:

Установите флажки для фьючерсов, которые вы хотите включить, и нажмите «ОК» и «применить». Так что загруженные функции Windows будут установлены.

Шаг 8: После установки функций Windows, необходимых для Wix. Теперь нажмите на .exe-файл WiX и запустите его, затем нажмите «Установить», появится запрос «Да» или «Нет», выберите вариант «Да», и он настроит и завершит процесс установки, как показано ниже:

Шаг 9: Мы успешно установили WiX в нашей операционной системе Windows 10, и теперь, если мы хотим посетить основной веб-сайт WiX, вам просто нужно нажать набор инструментов WiX на приведенном выше рисунке, чтобы он перенаправил на основной веб-сайт WiX http: // wixtoolset.org/

Шаг 10: Если мы хотим взглянуть на лицензию и прочитать ее, тогда мы можем щелкнуть страницу лицензии, затем она откроется, как показано ниже, и прочитает соглашение, а пример выходных данных будет следующим:

Visual Studio Интеграция WiX

• После успешной установки WiX на компьютере с Windows, если мы хотим настроить и интегрировать WiX с Visual Studio, нам нужно выполнить процедуру, описанную ниже: Во-первых, нам нужно нажать «Нажмите здесь, чтобы просмотреть доступные расширения», чтобы увидеть Visual Studio. интеграция с расширениями WiX, затем он будет перенаправлен на веб-сайт загрузок и выпусков WiX, а затем нам нужно выбрать желаемое расширение visual studio из доступных расширений, как показано ниже:

Теперь мы выбрали расширение WiX Toolset Visual Studio 2017, а затем оно будет перенаправлено на рынок Visual Studio, а затем нам нужно нажать на кнопку «загрузить и установить», как показано ниже:

• После успешной инициализации и проверки всех требований к системе, которые нужно установить, она выдаст запрос, как показано ниже, и нам нужно нажать кнопку установки, чтобы интеграция Visual Studio с пакетом расширения WiX установилась, как показано ниже:

• После нажатия на кнопку установки он проверит существующую версию Visual Studio в нашей системе и изменит установку, загрузив необходимые пакеты и установив пакет Microsoft.NET.Core, расширение набора инструментов WiX для Visual Studio.

• Поскольку WiX создает пакеты MSI, WiX использует механизм установщика Windows, тогда как WiX можно установить другим способом, используя расширение Visual Studio, но это не так хорошо, как оригинальный WiX, поскольку он имеет только базовые функции и множество ограничений. Поэтому лучше остаться с установкой WiX, и мы можем использовать визуальную студийную интеграцию WiX, если есть требование.

Как установить WiX с помощью командной строки в Windows:

• WiX можно установить в Windows, используя командную строку или Power shell, используя следующую команду:

Choco установить WiX инструментарий

Приведенная выше команда установит набор инструментов WiX на компьютер под управлением Windows с помощью командной строки.

• WiX можно обновить до последней версии в Windows с помощью командной строки, используя следующую команду:

Choco апгрейд wixtoolset

Приведенная выше команда обновит набор инструментов WiX до последней версии на платформе Windows через командную строку или Power Shell.

• Преимущества с помощью установщика WiX заключаются в том, что мы можем добиться транзакционных операций, модулей слияния, автоматизации, API-интерфейсов, проверки пакетов, управления перезапуском и локализации.
• Недостаток установщика WiX заключается в его сложности, обновлениях, командной строке, архитектуре, более крутой кривой обучения, отсутствии возможности перетаскивания и автоматического включения зависимостей.

• В наборе инструментов WiX будут инструменты для преобразования исходных файлов в пакеты MSI и утилиты с документацией.

• Обету представляет собой расширение Visual Studio, которое интегрирует набор инструментов WiX с Visual Studio и будет иметь шаблоны проектов WiX и Intellisense.

Вывод — Как установить WIX

Наконец, краткий обзор того, как установить WiX на Windows с помощью командной строки и загрузить исполняемый файл с основного веб-сайта WiX, и мы также увидели, как интегрировать набор инструментов WiX с Visual Studio. Я надеюсь, что после прочтения этой статьи вы сможете без проблем установить WiX на свои машины.

Рекомендуемые статьи

Это было руководство о том, как установить WiX. Здесь мы обсудили базовую концепцию, интеграцию Visual Studio и различные этапы установки Wix с помощью командной строки Windows. Вы также можете посмотреть следующие статьи, чтобы узнать больше —

wix учебник
Начало работы с wix

Набор инструментов WiX позволяет разработчикам создавать установщики для установщика Windows, механизма установки Windows. Это открытый исходный код и часть .NET Foundation .

Ядром WiX является набор инструментов сборки, которые создают пакеты установщика Windows, используя те же концепции построения, что и остальная часть вашего продукта: исходный код скомпилирован и затем связан с созданием исполняемых файлов; в этом случае пакеты установки .exe, пакеты установки .msi, модули слияния .msm и исправления .msp. Инструменты построения командной строки WiX работают с любой автоматизированной системой сборки. Кроме того, MSBuild поддерживается из командной строки, Visual Studio и Team Build.

WiX включает в себя несколько расширений, которые предлагают функциональные возможности, помимо функций Windows Installer. Например, WiX может устанавливать веб-сайты IIS, создавать базы данных SQL Server и регистрировать исключения в брандмауэре Windows и другие.

С Burn, загрузчиком WiX, вы можете создавать установочные пакеты, которые устанавливают такие предварительные требования, как .NET Framework и другие среды выполнения вместе с вашим собственным продуктом. Burn позволяет загружать пакеты или объединять их в один загружаемый файл .exe.

WiX SDK включает в себя управляемые и собственные библиотеки, которые упрощают запись кода, который работает с установщиком Windows, включая пользовательские действия как на C #, так и на C ++.

Как работает WiX?

Исходный код WiX написан в формате XML с расширением .wxs. Инструменты WiX следуют традиционной модели компиляции и ссылок, используемой для создания исполняемых файлов из исходного кода.

Во время сборки исходные файлы WiX проверяются против базовой схемы WiX, а затем обрабатываются препроцессором, компилятором и компоновщиком для создания конечного результата. Существует набор инструментов WiX, которые можно использовать для создания разных типов вывода.

Требования к системе WiX

WiX поддерживает как .NET 3.5, так и более поздние версии. Поддержка MSBuild для WiX требует .NET 3.5, который по умолчанию не установлен в Windows 8 и Windows Server 2012 и более поздних версиях.

В следующей версии WiX (v3.11) потребуется .NET 4.0; построение с использованием .NET 3.5 больше не будет поддерживаться.

Версии

Установка или настройка

Загрузите и установите набор инструментов WiX с сайта wixtoolset.org .

Установщик для WiX Toolset также обеспечивает интеграцию с Visual Studio , после установки вы сможете создавать проекты, специфичные для WiX.

Предупреждения

Права администратора необходимы.

Некоторые версии WiX совместимы только с конкретной версией Visual Studio:

• V3.11 и впоследствии не включает расширения для Visual Studio, вам необходимо загрузить расширения для своих версий Visual Studio
• V3.10 и ниже не работает с Visual Studio 2017, но включает в себя шаблоны проектов для Visual Studio

подробности

Установщик построен с самим WiX и представляет собой необычное окно:

Он состоит из 6 частей:

WiX Toolset: покажите версию, установленную установщиком, и запустите веб-сайт Wix Toolset

Лицензия: показать лицензию

Установить: запустить установку

До даты: проверьте, доступна ли новая версия

Выход: закрыть установщик

Простая настройка

В этом примере предполагается, что решение с приложением с именем MyApp уже существует.

• Добавьте новый проект в решение:

• В проекте установки добавьте новую ссылку на MyApp со вкладки «Проекты»:

• В Product.wxs файле, ревалоризировать в Manufacturer атрибут Product узла с HelloWorld :

В узле « Fragment содержащем узлы « Directory , оберните последнее с помощью нового Directory :

В узле ComponentGroup раскомментируйте узлы с комментариями и удалите TODO затем добавьте узел File в Component :

Атрибут Source указывает, где найти файл для упаковки во время сборки. Вместо значений жесткого кода для этих атрибутов в нашем исходном коде мы используем переменные препроцессора WiX, которые передаются компилятору WiX.

• Постройте проект WiX.

Это оно! Теперь у вас есть рабочий установщик, который устанавливает и удаляет приложение.

WiX Toolset: How to Create a Setup Package to Install a Windows Service

When Microsoft dropped support for the traditional Windows setup projects in Visual Studio 2012, I was stuck with Visual Studio 2010 for programs that relied on setup projects. I needed a new way of installing Windows services, and the recommended alternative was the WiX Toolset. In this post, weӬl learn how to use WiX to create a Windows installation package that installs a Windows service.

In a previous post, I discussed how to create a basic windows service, and how to install it using InstallUtil. We will continue where we left off by adding a WiX setup project, and configuring it to install our TestService.

If you don’t want to follow the steps in the previous post, you can download the TestService solution and follow thesteps in this post.

What is the WiX Toolset?

Since Visual Studio 2012, the traditional Windows setup project has been removed. WiX is the recommended alternative, and has been used by Microsoft to package products like Office, SQL Server and Visual Studio.

WiX, (Windows Installer XML) is a free open source toolset by Microsoft that builds Windows installer packages from XML source code. Installing the WiX Toolset will add the ability to create WiX setup projects with Visual Studio.

The main difference to the old Visual Studio setup projects, is with WiX, there is no user interface, and everything is configured using XML files. This increases the power and flexibility of your setup projects.

Installing the WiX Toolset

Before we can create the WiX setup project, we need to install the WiX Toolset. You can find a link to the latest download on the WiX Toolset website.

1. Download WiX Toolset v3.8 from the WiX Toolset Website.
2. Close all instances of Visual Studio and then run wix38.exe.
3. Click Install, and wait for the setup to complete.
   
4. Once complete, click Exit to finish the setup.

Create the WiX setup project

1. Open the TestService solution we created in the last post.
2. Right click on the TestService solution, click Add, and then click New Project.
3. In the Add New Project dialog, click on Windows Installer XML, and choose Setup Project.
4. Name the project TestService.Setup, and then click OK to create the project.
   

You should now have a setup project with a single Product.wxs file. Next, we need to add a reference to the TestService project.

Add a reference to TestService project

Adding a project reference toTestService, ensures the TestService.exe file will be generated when the setup project is built. It also generates a set of WiX preprocessor definitions that are required when configuring theProduct.wxs file.

Follow the steps below to add a reference to the TestService project:

1. Right click on References, and then click Add Reference.
2. In the Add Reference dialog, click on the Projects tab.
3. Select the TestService project, click Add, and then click OK to close the dialog.
   

Now that the project reference is added, we can configure the Product.wxs file.

Configuring the Product.wxs file

Replace the contents of the Product.wxs file with the following XML.

I won’t go into all the details of the Product.wxs file, because I have put comments before each element to explain what it does. Also, you can find much more detailed documentation on each of the elements on the WiX Toolset website.

What I will say, is if you use this Product.wxs file for your own custom built service, you will need to change the Name , Manufacturer , Version , and UpgradeCode variables at the top of the file. You will also need to change wherever it says var.TestService to the name of the service project you have referenced.

You will also need to add extra file elements for any extra files you need copied into the installation directory.

Building the setup project

You should now be able to right click on your TestService.Setup project and click Build. The Test Service.msi file will be generated inside the Debug or Release folder.

Installing the Windows service

Running the Test Service.msi file will copy the Test Service.exe file into “C:\Program Files (x86)\Talk Sharp\Test Service”, the service will be installed, and then started. If you have used the project from the previous post, you should see a log.txt file created inside the same folder as the TestService.exe file.

Uninstall the Windows service

You can remove the service by going to Start, Control Panel, and then clicking on Uninstall a program. The image below shows our installed service in the list of programs.

Notice the Name, Publisher and Version. These are the values that were specified in the <?define ?> variables at the start of the Product.wxs file.

Conclusion

WiX setup projects are not as straight forward as traditional setup projects because there is no user interface. However, there is a lot more you can do with the WiX Toolset.

This post has shown the most basic of configurations, and how easy it is to bundle and deploy a Windows service.

Get started with WiX

WiX v4 is available as a .NET tool for your command-line pleasure.

The wix.exe tool requires the .NET SDK, version 6 or later.

Wix.exe supports commands to perform particular operations. For example, the build command lets you build MSI packages, bundles, and other package types.

To install the Wix.exe .NET tool:

To verify Wix.exe was successfully installed:

See also​

MSBuild on the command line and CI/CD build systems​

WiX v4 is available as an MSBuild SDK for building from the command line using dotnet build from the .NET SDK or the .NET Framework-based MSBuild from Visual Studio. SDK-style projects have smart defaults that make for simple .wixproj project authoring. For example, here's a minimal .wixproj that builds an MSI from the .wxs source files in the project directory:

See also​

Visual Studio​

FireGiant has released HeatWave Community Edition to support WiX v4 SDK-style MSBuild projects in Visual Studio. HeatWave supports:

• Conversion of WiX v3 projects and authoring
• Building of WiX v4 SDK-style projects
• Project and item templates
• Property pages to control how the project builds

Using development builds​

WiX development builds with all the latest bug fixes are available in a NuGet package feed on GitHub. To add that feed as a package source: