Skip to content

Commit

Permalink
Preparing for 2.3 release.
Browse files Browse the repository at this point in the history
  • Loading branch information
dblock committed Jan 6, 2014
1 parent 68bc195 commit 5897a8b
Show file tree
Hide file tree
Showing 21 changed files with 592 additions and 592 deletions.
960 changes: 480 additions & 480 deletions CHANGELOG.md

Large diffs are not rendered by default.

20 changes: 10 additions & 10 deletions LICENSE
@@ -1,10 +1,10 @@
MIT License (MIT)

Copyright (c) 2009-2012 Davide Icardi, Daniel Doubrovkine and Contributors.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

MIT License (MIT)
Copyright (c) 2009-2012 Davide Icardi, Daniel Doubrovkine and Contributors.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
136 changes: 68 additions & 68 deletions README.md
@@ -1,68 +1,68 @@
dotNetInstaller Setup Bootstrapper
==================================

![dotNetInstaller](https://github.com/dblock/dotnetinstaller/raw/master/Documentation/Images/Logo.gif)

dotNetInstaller is a widely used, general-purpose setup bootstrapper for Microsoft Windows 95, 98, 2000, XP, 2003, Vista, 2008, Windows 7 and 8.

Essentials
----------

* [Need Help? Google Group](http://groups.google.com/group/dotnetinstaller)
* Download Version 2.2
[[installer](http://code.dblock.org/downloads/dotnetinstaller/dotNetInstaller.2.2.msi)]
[[zip](http://code.dblock.org/downloads/dotnetinstaller/dotNetInstaller.2.2.zip)]
* [Older Versions on CodePlex](http://dotnetinstaller.codeplex.com/).

Bootstrapper
------------

dotNetInstaller enables the developer to define the application prerequisites and install the correct version(s) of these components in a predictable order based on the processor architecture, user operating system type and language, allow the user to download these components from the web, install these components directly from a single packaged setup, local media or both. dotNetInstaller is very feature rich and runs on all known Windows operating systems with a very tiny footprint.

A boostrapper doesn't replace tools like InstallShield, Wise, Visual Studio Setup and Deployment Project or Wix. The goal is to create an application to help users with installing the correct prerequisites. Most real world applications need to install several components to work properly, including Windows Service Packs, Internet Explorer, MDAC or .NET Framework. This kind of applications are most commonly known as bootstrappers. dotNetInstaller is such a bootstrapper.

Getting Started
---------------

1. Download and install dotNetInstaller.
2. Launch InstallerEditor.exe and create a configuration file.
3. Add configurations, components and installed checks. Edit messages and various options.
4. Deploy your installer. This may involve linking a single executable package or copying support files onto fixed media.

dotNetInstaller ships with a CHM help file with a detailed Getting Started section and a complete configuration reference. If you have trouble viewing the help file content, Right Click on it and choose *Unblock* in Properties.

Bootstrapper Scenarios
----------------------

A bootstrapper enables additional scenarios not supported by the installer alone.

* Distribute a single, compressed, executable packaged setup with all pre-requisites.
* Distribute multiple installers that compose a large and complex application in a single package and enforce a well-defined installation workflow and dependencies.
* Package frequently required components or components with a small footprint, and download less frequently used or larger ones only when necessary.
* Provide additional parameters to existing package technologies, eg. automatically enabling logging in MSI installers.
* Support workflow that includes a reboot in the middle of an installation between interdependent components.
* Support web-based scenarios that include on-demand downloading the latest versions of the installed software and prerequisites.
* Uninstall applications composed of several packages in a single sequence.

dotNetInstaller Components
--------------------------

This project consists of the following elements:

* *dotNetInstaller* and *htmlInstaller*: main bootstrapper applications, written in C++. This is the raw setup which presents a GUI in front of the user that displays which components to install depending on which components are already installed on the operating system. The bootstrapper is statically linked with the CRT and has no prerequisites.
* *InstallerEditor*: an application for editing configuration files and bootstrapper resources, written in C# for the .NET Framework 2.0. The editor is also capable of importing older versions of dotNetInstaller configuration files and converting them into the current/newer format.
* *InstallerLinker*: a command-line bootstrapper linker that can be used in a build process, written in C# for the .NET Framework 2.0.
Several samples and dependency templates that can be reused as-is and that demonstrate sometimes complex checks which verify whether, for example, MDAC or .NET framework are already installed.

Project History
---------------

This project began as a [CodeProject article](http://www.codeproject.com/KB/install/dotNetInstaller.aspx) and was maintained on the [DevAge website](http://www.devage.com/) and [SourceForge](https://sourceforge.net/projects/dotnetinstaller) by David Icardi. It continued its journey through [CodePlex](http://dotnetinstaller.codeplex.com) and is now officially maintained on [Github](https://github.com/dblock/dotnetinstaller).

License and Copyright
---------------------

Copyright (c) 2009-2012 Davide Icardi, Daniel Doubrovkine and Contributors.

This project is licensed under the [MIT License](https://github.com/dblock/dotnetinstaller/blob/master/LICENSE).

dotNetInstaller Setup Bootstrapper
==================================

![dotNetInstaller](https://github.com/dblock/dotnetinstaller/raw/master/Documentation/Images/Logo.gif)

dotNetInstaller is a widely used, general-purpose setup bootstrapper for Microsoft Windows 95, 98, 2000, XP, 2003, Vista, 2008, Windows 7 and 8.

Essentials
----------

* [Need Help? Google Group](http://groups.google.com/group/dotnetinstaller)
* Download Version 2.3
[[installer](http://code.dblock.org/downloads/dotnetinstaller/dotNetInstaller.2.3.msi)]
[[zip](http://code.dblock.org/downloads/dotnetinstaller/dotNetInstaller.2.3.zip)]
* [Older Versions on CodePlex](http://dotnetinstaller.codeplex.com/).

Bootstrapper
------------

dotNetInstaller enables the developer to define the application prerequisites and install the correct version(s) of these components in a predictable order based on the processor architecture, user operating system type and language, allow the user to download these components from the web, install these components directly from a single packaged setup, local media or both. dotNetInstaller is very feature rich and runs on all known Windows operating systems with a very tiny footprint.

A boostrapper doesn't replace tools like InstallShield, Wise, Visual Studio Setup and Deployment Project or Wix. The goal is to create an application to help users with installing the correct prerequisites. Most real world applications need to install several components to work properly, including Windows Service Packs, Internet Explorer, MDAC or .NET Framework. This kind of applications are most commonly known as bootstrappers. dotNetInstaller is such a bootstrapper.

Getting Started
---------------

1. Download and install dotNetInstaller.
2. Launch InstallerEditor.exe and create a configuration file.
3. Add configurations, components and installed checks. Edit messages and various options.
4. Deploy your installer. This may involve linking a single executable package or copying support files onto fixed media.

dotNetInstaller ships with a CHM help file with a detailed Getting Started section and a complete configuration reference. If you have trouble viewing the help file content, Right Click on it and choose *Unblock* in Properties.

Bootstrapper Scenarios
----------------------

A bootstrapper enables additional scenarios not supported by the installer alone.

* Distribute a single, compressed, executable packaged setup with all pre-requisites.
* Distribute multiple installers that compose a large and complex application in a single package and enforce a well-defined installation workflow and dependencies.
* Package frequently required components or components with a small footprint, and download less frequently used or larger ones only when necessary.
* Provide additional parameters to existing package technologies, eg. automatically enabling logging in MSI installers.
* Support workflow that includes a reboot in the middle of an installation between interdependent components.
* Support web-based scenarios that include on-demand downloading the latest versions of the installed software and prerequisites.
* Uninstall applications composed of several packages in a single sequence.

dotNetInstaller Components
--------------------------

This project consists of the following elements:

* *dotNetInstaller* and *htmlInstaller*: main bootstrapper applications, written in C++. This is the raw setup which presents a GUI in front of the user that displays which components to install depending on which components are already installed on the operating system. The bootstrapper is statically linked with the CRT and has no prerequisites.
* *InstallerEditor*: an application for editing configuration files and bootstrapper resources, written in C# for the .NET Framework 2.0. The editor is also capable of importing older versions of dotNetInstaller configuration files and converting them into the current/newer format.
* *InstallerLinker*: a command-line bootstrapper linker that can be used in a build process, written in C# for the .NET Framework 2.0.
Several samples and dependency templates that can be reused as-is and that demonstrate sometimes complex checks which verify whether, for example, MDAC or .NET framework are already installed.

Project History
---------------

This project began as a [CodeProject article](http://www.codeproject.com/KB/install/dotNetInstaller.aspx) and was maintained on the [DevAge website](http://www.devage.com/) and [SourceForge](https://sourceforge.net/projects/dotnetinstaller) by David Icardi. It continued its journey through [CodePlex](http://dotnetinstaller.codeplex.com) and is now officially maintained on [Github](https://github.com/dblock/dotnetinstaller).

License and Copyright
---------------------

Copyright (c) 2009-2012 Davide Icardi, Daniel Doubrovkine and Contributors.

This project is licensed under the [MIT License](https://github.com/dblock/dotnetinstaller/blob/master/LICENSE).

2 changes: 1 addition & 1 deletion Samples/CustomInputSetup/Configuration.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!--Packaged setup demo that adds custom input GUI.-->
<configurations lcid_type="UserExe" show_language_selector="False" language_selector_title="" language_selector_ok="OK" language_selector_cancel="Cancel" configuration_no_match_message="" ui_level="full" fileversion="1.0.0.1" productversion="1.0.0.0" log_enabled="True" log_file="#TEMPPATH\#GUID.log ">
<schema version="2.3.1031.0" generator="dotNetInstaller InstallerEditor" />
<schema version="2.3.16.0" generator="dotNetInstaller InstallerEditor" />
<fileattributes>
<fileattribute name="FileDescription" value="Custom input setup sample" />
</fileattributes>
Expand Down
2 changes: 1 addition & 1 deletion Samples/DownloadSetup/Configuration.xml
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<configurations lcid_type="UserExe" show_language_selector="False" language_selector_title="" language_selector_ok="OK" language_selector_cancel="Cancel" configuration_no_match_message="" ui_level="full" fileversion="1.0.0.0" productversion="1.0.0.0" log_enabled="False" log_file="#TEMPPATH\dotNetInstallerLog.txt">
<schema version="2.3.1031.0" generator="dotNetInstaller InstallerEditor" />
<schema version="2.3.16.0" generator="dotNetInstaller InstallerEditor" />
<configuration dialog_caption="Download Installer" dialog_message="In order to install this application you must first install these components:" dialog_message_uninstall="" dialog_bitmap="#APPPATH\banner.bmp" skip_caption="Skip" install_caption="Install" uninstall_caption="Install" cancel_caption="Close" status_installed=" (Installed)" status_notinstalled="" failed_exec_command_continue="Failed to install %s. Continue with other components?" installation_completed="Demo application installed successfully !" uninstallation_completed="Demo application installed successfully !" installation_none="APPLICATION_NAME is already installed!" uninstallation_none="APPLICATION_NAME is not installed!" installing_component_wait="Installing %s . Wait, this operation could take some time ..." uninstalling_component_wait="Installing %s . Wait, this operation could take some time ..." reboot_required="To continue the installation you must restart your computer. Restart now?" must_reboot_required="False" dialog_otherinfo_caption="" dialog_otherinfo_link="" complete_command="" complete_command_silent="" complete_command_basic="" wait_for_complete_command="True" prompt_for_optional_components="False" auto_close_if_installed="True" auto_close_on_error="False" reload_on_error="True" dialog_show_installed="True" dialog_show_uninstalled="True" dialog_show_required="True" cab_dialog_message="%s" cab_cancelled_message="" cab_dialog_caption="" cab_path="#TEMPPATH\#GUID" cab_path_autodelete="True" dialog_default_button="cancel" dialog_position="" dialog_components_list_position="" dialog_message_position="" dialog_bitmap_position="" dialog_otherinfo_link_position="" dialog_osinfo_position="" dialog_install_button_position="" dialog_cancel_button_position="" dialog_skip_button_position="" auto_start="False" auto_continue_on_reboot="False" reboot_cmd="" show_progress_dialog="True" show_cab_dialog="True" disable_wow64_fs_redirection="False" administrator_required="False" administrator_required_message="APPLICATION_NAME installation requires administration rights." type="install" lcid_filter="" language_id="" language="" os_filter="" os_filter_min="" os_filter_max="" processor_architecture_filter="" supports_install="True" supports_uninstall="True">
<component command="#TEMPPATH\AdbeRdr910_en_US_Std.exe" command_silent="" command_basic="" uninstall_command="" uninstall_command_silent="" uninstall_command_basic="" returncodes_success="" returncodes_reboot="" hide_window="False" disable_wow64_fs_redirection="False" execution_method="CreateProcess" id="acrobat" display_name="Adobe Acrobat Reader 9" uninstall_display_name="" os_filter="" os_filter_min="" os_filter_max="" os_filter_lcid="" type="cmd" installcompletemessage="" uninstallcompletemessage="" mustreboot="False" reboot_required="" must_reboot_required="False" failed_exec_command_continue="" allow_continue_on_error="True" default_continue_on_error="False" required_install="True" required_uninstall="True" selected_install="True" selected_uninstall="True" note="" processor_architecture_filter="" status_installed="" status_notinstalled="" supports_install="True" supports_uninstall="False" show_progress_dialog="True" show_cab_dialog="True">
<downloaddialog dialog_caption="Adobe Acrobat - Download Components" dialog_message="Please wait ..." dialog_message_downloading="Downloading %s ..." dialog_message_copying="Copying %s ..." dialog_message_connecting="Connecting to %s ..." dialog_message_sendingrequest="Sending request to %s ..." autostartdownload="True" buttonstart_caption="Start" buttoncancel_caption="Cancel">
Expand Down
2 changes: 1 addition & 1 deletion Samples/ExeSetup/Configuration.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!--Packaged setup demo that embeds an MSI component.-->
<configurations lcid_type="UserExe" show_language_selector="False" language_selector_title="" language_selector_ok="OK" language_selector_cancel="Cancel" configuration_no_match_message="" ui_level="full" fileversion="1.0.0.1" productversion="1.0.0.0" log_enabled="True" log_file="#TEMPPATH\#GUID.log ">
<schema version="2.3.1031.0" generator="dotNetInstaller InstallerEditor" />
<schema version="2.3.16.0" generator="dotNetInstaller InstallerEditor" />
<fileattributes>
<fileattribute name="FileDescription" value="Standalone setup sample" />
<fileattribute name="CompanyName" value="DevAge, Vestris Inc. &amp; Contrbutors (Thank You)" />
Expand Down
2 changes: 1 addition & 1 deletion Samples/InstallCheckOperators/Configuration.xml
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<configurations lcid_type="UserExe" show_language_selector="False" language_selector_title="" language_selector_ok="OK" language_selector_cancel="Cancel" configuration_no_match_message="" ui_level="full" fileversion="1.0.0.0" productversion="1.0.0.0" log_enabled="True" log_file="#TEMPPATH\#GUID.log">
<schema version="2.3.1031.0" generator="dotNetInstaller InstallerEditor" />
<schema version="2.3.16.0" generator="dotNetInstaller InstallerEditor" />
<fileattributes>
<fileattribute name="FileDescription" value="InstallCheckOperators setup sample" />
</fileattributes>
Expand Down
2 changes: 1 addition & 1 deletion Samples/InstallCheckProduct/Configuration.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!--Packaged setup demo that embeds an MSI component.-->
<configurations lcid_type="UserExe" show_language_selector="False" language_selector_title="" language_selector_ok="OK" language_selector_cancel="Cancel" configuration_no_match_message="" ui_level="full" fileversion="1.0.0.0" productversion="1.0.0.0" log_enabled="True" log_file="#TEMPPATH\#GUID.log ">
<schema version="2.3.1031.0" generator="dotNetInstaller InstallerEditor" />
<schema version="2.3.16.0" generator="dotNetInstaller InstallerEditor" />
<fileattributes>
<fileattribute name="FileDescription" value="InstallCheckProduct setup sample" />
</fileattributes>
Expand Down
2 changes: 1 addition & 1 deletion Samples/Invalid/NoMatchingOSFilter.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!--Packaged setup demo that embeds an MSI component.-->
<configurations lcid_type="UserExe" show_language_selector="False" language_selector_title="" language_selector_ok="OK" language_selector_cancel="Cancel" configuration_no_match_message="Expected error: no match in %s setup configuration(s)." ui_level="full" fileversion="1.0.0.1" productversion="1.0.0.0" log_enabled="True" log_file="#TEMPPATH\#GUID.log ">
<schema version="2.3.1031.0" generator="dotNetInstaller InstallerEditor" />
<schema version="2.3.16.0" generator="dotNetInstaller InstallerEditor" />
<fileattributes>
<fileattribute name="FileDescription" value="Standalone setup sample" />
</fileattributes>
Expand Down

0 comments on commit 5897a8b

Please sign in to comment.