PupNet-Deploy

NUGET
You can install or update using Nuget:

dotnet tool install -g KuiperZone.PupNet

or update:

dotnet tool update -g KuiperZone.PupNet

The "PupNet tool" targets .NET8 LTS (this does not restrict the dotnet version of your own projects).

OTHER INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Once installed, launch Command Prompt under Programs Menu to use.

RECENT CHANGES

• VERSION 1.8.0; 2024-03-18

• Built with .NET8
• Added -j,--project command line argument.
• Added SetupGroupName configuration parameter.
• Now detects the $DOTNET_HOST_PATH environment variable and uses it if defined.
• Updated documentation concerning NETSDK1194. #27
• Updated default FlatpakPlatformVersion to latest 23.08 at time of writing.
• Removed dependency on Yaap.
• Bugfix: Added trailing ';' to Categories value of desktop file. #33
• BugFix: Use of ';' between property values did not work. Should now use ',' with pupnet.

NUGET
You can install or update using Nuget:

dotnet tool install -g KuiperZone.PupNet

or update:

dotnet tool update -g KuiperZone.PupNet

The "PupNet tool" targets .NET6 LTS (this does not restrict the dotnet version of your own projects).

OTHER INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Once installed, launch Command Prompt under Programs Menu to use.

RECENT CHANGES

• VERSION 1.7.1; 2023-10-26

• Bugfix: Fix upgrade-conf bug introduced in 1.7.0.

VERSION 1.7.0; 2023-10-25
Feature #24: Automatically skips confirmation if environment variable "CI=true" is defined.
Other minor tweaks.

NUGET
You can install or update using Nuget:

dotnet tool install -g KuiperZone.PupNet

or update:

dotnet tool update -g KuiperZone.PupNet

The "PupNet tool" targets .NET6 LTS (this does not restrict the dotnet version of your own projects).

OTHER INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Once installed, launch Command Prompt under Programs Menu to use.

RECENT CHANGES

• VERSION 1.7.0; 2023-10-25

• Feature #24: Automatically skips confirmation if environment variable "CI=true" is defined.
• Other minor tweaks.

NUGET
You can now also install using Nuget:

dotnet tool install -g KuiperZone.PupNet

The "PupNet tool" targets .NET6 LTS (this does not restrict the dotnet version of your own projects).

INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Once installed, launch Command Prompt under Programs Menu to use.

RECENT CHANGES

• VERSION 1.6.0; 2023-07-22

• IMPORTANT: RPM now creates output file directly under output directory, rather than under "RPMS/arch" sub-directory.
• Bugfix #21: Inno Setup fails with x86 (dotnet runtime "win-x32")
• Bugfix #23: AppImage desktop file broken (macros ${INSTALL_BIN} and ${INSTALL_EXEC} now have leading forward slash for AppImage)

NUGET
You can now also install using Nuget:

dotnet tool install -g KuiperZone.PupNet

The "PupNet tool" targets .NET6 LTS (this does not restrict the dotnet version of your own projects).

INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Once installed, launch Command Prompt under Programs Menu to use.

RECENT CHANGES

• VERSION 1.5.0; 2023-05-07

• Added ability to parse list items in 'AppDescription' configuration and transpose to HTML.
• Added XML validation of AppStream metadata (will now warn if invalid prior to build).
• Bugfix: The configuration property 'IconFiles' handled icon names of form "name.NxN.png", but failed with "name.N.png".
• The ${PRIME_CATEGORY} macro now defaults to "Utility" if PrimeCategory' configuration is omitted.
• Added extensive new unit testing
• Minor changes to configuration documentation
• Other minor changes
• Ships with: appimagetool 13 (2020-12-31)
• Tested against: rpmbuild RPM version 4.18.1, dpkg 1.21.21, flatpak-builder 1.2.3, InnoSetup 6.2.2

NUGET
You can now also install using Nuget:

dotnet tool install -g KuiperZone.PupNet

The "PupNet tool" targets .NET6 LTS (this does not restrict the dotnet version of your own projects).

INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Once installed, launch Command Prompt under Programs Menu to use.

RECENT CHANGES

• VERSION 1.4.1; 2023-05-06

• Bugfix #16: AppImage and Flatpak builds rejected AppStream metadata if conf.AppDescription was empty. Now defaults to AppShortSummary.
• Bugfix #15: AppImage and Flatpak builds rejected AppStream metadata if conf.AppChangeFileEmpty.
• Bugfix #14: AppImage failed if conf.IconPaths empty. On Linux a default icon will be used (previously worked but was broken due to change).
• Bugfix #13: Incorrect tag in AppStream example text (may be uncommented by user)
• Updated to show CHANGELOG on console only with --verbose command option

Ships with: appimagetool 13 (2020-12-31)
Tested against: rpmbuild RPM version 4.18.1, dpkg 1.21.21, flatpak-builder 1.2.3, InnoSetup 6.2.2

NUGET
You can now also install using Nuget:

dotnet tool install -g KuiperZone.PupNet

The "PupNet tool" targets .NET6 LTS (this does not restrict the dotnet version of your own projects).

INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Once installed, launch Command Prompt under Programs Menu to use.

RECENT CHANGES

• VERSION 1.4.0; 2023-05-05

• Added 'AppDescription' property to configuration (IMPORTANT NEW FEATURE - see website for information)
• Added ${APPSTREAM_DESCRIPTION_XML} macro to support release information in AppStream metadata
• Updated AppStream metadata template to include ${APPSTREAM_CHANGELOG_XML}
• Now uses 'AppDescription' content when building both RPM and DEB packages
• Added 'AppChangeFile' property to configuration (IMPORTANT NEW FEATURE - see website for information)
• Added ${APPSTREAM_CHANGELOG_XML} macro to support release information in AppStream metadata
• Updated AppStream metadata template to include ${APPSTREAM_DESCRIPTION_XML}
• The AppChangeFile file is now packaged verbatim to the bin directory of deployments
• Added 'InfoBeforeFile' to Windows Setup in order to show AppChangeFile file content
• Added CHANGELOG section to console output when building a package (contains parsed changes only)
• Added MACRO section (verbose only) to console output when building a package (useful for debugging)
• Extensive updates to README documentation
• Other minor corrections and changes

Ships with: appimagetool 13 (2020-12-31)
Tested against: rpmbuild RPM version 4.18.1, dpkg 1.21.21, flatpak-builder 1.2.3, InnoSetup 6.2.2

INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Once installed, launch Command Prompt under Programs Menu to use.

NUGET
You can now also install using Nuget:

dotnet tool install -g KuiperZone.PupNet

RECENT CHANGES

• VERSION 1.3.1; 2023-05-01

• Bugfix: Fix package creation when file path of contents contain spaces (enclose file path with quotes when executing chmod)

Ships with: appimagetool 13 (2020-12-31)
Tested against: rpmbuild RPM version 4.18.0, dpkg 1.21.21, flatpak-builder 1.2.3, InnoSetup 6.2.2

INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Launch Command Prompt under Programs Menu.

You can now also install using Nuget:

dotnet tool install -g KuiperZone.PupNet

• VERSION 1.3.0; 2023-04-18

• Added RpmAutoProv and RpmAutoReq properties to configuration
• Added RpmRequires property to configuration to allow specification of RPM dependencies
• Added DebianRecommends property to configuration to allow specification of Debian dependencies
• Now ensures execute permission is set on main executable after dotnet publish (.NET6 does not seem to guarantee this)
• Now ensures that all files after dotnet publish have "other read" permissions (.NET6 does not seem to guarantee this)
• Removed desktop and metainfo validity checks in RPM build as non-essential but problematic where dependencies not met
• Bug fix: The name of the pupnet.conf file was not always displayed when building a package
• Bug fix: Debian Copyright file was not packaged
• Bug fix: May have listed previous build files when building RPM package (display issue only)

Ships with: appimagetool 13 (2020-12-31)
Tested against: rpmbuild RPM version 4.18.0, dpkg 1.21.21, flatpak-builder 1.2.3, InnoSetup 6.2.2

INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Launch Command Prompt under Programs Menu.

• VERSION 1.2.2; 2023-04-14

• Now supplied as .NET6 tool (explicitly built against .NET6 LTS rather than .NET7)
• Bug fix: AppImage failed to run on some systems (updated AppImage runtimes)
• Bug fix: Added 'BuildRequires: desktop-file-utils' to RPM spec file

Ships with: appimagetool 13 (2020-12-31)
Tested against: rpmbuild RPM version 4.18.0, dpkg 1.21.21, flatpak-builder 1.2.3, InnoSetup 6.2.2

INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Launch Command Prompt under Programs Menu.

• VERSION 1.2.1; 2023-04-13

• Bug fix: Unable to show --help or --version due to recent changes

Ships with: appimagetool 13 (2020-12-31)
Tested against: rpmbuild RPM version 4.18.0, dpkg 1.21.21, flatpak-builder 1.2.3, InnoSetup 6.2.2

• VERSION 1.2.0; 2023-04-13

• Now ships as a dotnet tool (.NET7)
• Added upgrade-conf CLI option to upgrade existing pupnet.conf file
• Added SetupAdminInstall to configuration to all install with admin privileges in Windows Setup
• Added SetupSuffixOutput to configuration to allow control of naming of Windows Setup
• Added ${LOCAL_DIRECTORY} macro
• Windows Setup now removes (re-writes) existing program group entries on upgrade
• Windows Setup console window now echos command name and version on launch
• Improved Windows Setup console icon
• Fixed trivial bug in --new command
• Tweaks to formatting of --help output
• Other minor changes

INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Launch Command Prompt under Programs Menu.

• VERSION 1.2.0; 2023-04-13

• Now ships as a dotnet tool (.NET7)
• Added upgrade-conf CLI option to upgrade existing pupnet.conf file
• Added SetupAdminInstall to configuration to all install with admin privileges in Windows Setup
• Added SetupSuffixOutput to configuration to allow control of naming of Windows Setup
• Added ${LocalDirectory} macro
• Windows Setup now removes (re-writes) existing program group entries on upgrade
• Windows Setup console window now echos command name and version on launch
• Improved Windows Setup console icon
• Fixed trivial bug in --new command
• Tweaks to formatting of --help output
• Other minor changes
• Ships with: appimagetool 13 (2020-12-31)

Tested against: rpmbuild RPM version 4.18.0, dpkg 1.21.21, flatpak-builder 1.2.3, InnoSetup 6.2.2

INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Launch Command Prompt under Programs Menu.

• VERSION 1.1.0; 2023-03-30

• Now ships internally with fuse run-times to allow cross-build for: x64, arm64 (aarch64) and Arm (32-bit) architectures.
• Support for building AppImages on 32-bit Arm development platforms

Tested against: appimagetool 13 (2020-12-31), rpmbuild RPM version 4.18.0, dpkg 1.21.20, flatpak-builder 1.2.3, InnoSetup 6.2.0

INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Launch Command Prompt under Programs Menu

If you like this project, don't forget to like and share.

• VERSION 1.0.1; 2023-03-22

• Now shows AppImageTool version only on Linux.
• Minor updates to built-in help information.
• Added screenshot to metainfo.xml

Tested against: appimagetool: 13 (2020-12-31); rpmbuild: RPM version 4.18.0; dpkg: 1.21.20;flatpak-builder: 1.2.3;InnoSetup: 6.2.0

INSTALLATION ASSETS
For AppImage - Set execute permission before running. Put file in Path.
For Windows - Launch Command Prompt under Program Menu

If you like this project, don't forget to like and share.

NOTE
Arm64/Aarch64 variants untested in this initial release. Feedback welcome.

• VERSION 1.0.0; 2023-03-22

• Initial Release
• Tested against: appimagetool: 13 (2020-12-31); rpmbuild: RPM version 4.18.0; dpkg: 1.21.20;flatpak-builder: 1.2.3;InnoSetup: 6.2.0