Publish a new version of Falcon Application - FalconFT/FalconDocs GitHub Wiki

Publish new app version (MINOR)

[!NOTE] After migrating to NET 8 and leaving the classic framework behind, the way of publishing new versions has changed.

We'll continue using the Publisher utility, but before we've to:

  1. Update the new version number of Falcon
  2. Publish a new version from Visual Studio (release optimized code)

After that, we can now open the Publisher utility, select 'Publish application' as usual. This is, selecting the channel (preview, public or both) and start publishing. This will create a new container in Azure Storage with the version number automatically if not exists.

Setting the new version number in Falcon project

In Visual Studio, in the solution explorer, go to main project 'Falcon.Client' project (under 01.UI\Client\Multitarget).

There is a resource file named App.cs in folder's folder (typical C++ resource file). This file contains the definition of the VERSION_INFO structure and all the ICON resources added to the generated assembly.

[!WARNING] In order to edit this file in Visual Studio -> right click and select 'Open With' and then 'Source Code (Text) Editor' instead of double-click the file, because it launches the default Resource Editor.

image

The resource file looks like:

1 VERSIONINFO
FILEVERSION             2024, 3, 1, 101
PRODUCTVERSION          2024, 3, 1, 101
BEGIN
BLOCK "StringFileInfo"
BEGIN
BLOCK "040904b0"
BEGIN
VALUE "Comments", "FalconFT\0"
VALUE "CompanyName", "Falcon Financial Technologies\0"
VALUE "FileDescription", "Falcon Application\0"
VALUE "FileVersion", "2024.03.01.101\0"
VALUE "ProductVersion", "2024.03.01.101\0"
VALUE "InternalName", "GAMORA\0"
VALUE "LegalCopyright", "© 2024\0"
VALUE "OriginalFilename", "Falcon.exe\0"
VALUE "ProductName", "Falcon\0"
END
END
BLOCK "VarFileInfo"
BEGIN
VALUE "Translation", 0x0409, 1200
END
END

100 ICON "Resources\\FalconBlueTransparent.ico"
101 ICON "Icons\\FalconAppLogoSolid_Blue.ico"
102 ICON "Icons\\FalconAppLogoSolid_Cyan.ico"
103 ICON "Icons\\FalconAppLogoSolid_Green.ico"
104 ICON "Icons\\FalconAppLogoSolid_Lime.ico"
105 ICON "Icons\\FalconAppLogoSolid_Orange.ico"
106 ICON "Icons\\FalconAppLogoSolid_Red.ico"
107 ICON "Icons\\FalconAppLogoSolid_Rose.ico"
108 ICON "Icons\\FalconAppLogoSolid_Violet.ico"
109 ICON "Icons\\FalconAppLogoSolid_Yellow.ico"
111 ICON "Icons\\FalconAppLogoBorder_Blue.ico"
112 ICON "Icons\\FalconAppLogoBorder_Cyan.ico"
113 ICON "Icons\\FalconAppLogoBorder_Green.ico"
114 ICON "Icons\\FalconAppLogoBorder_Lime.ico"
115 ICON "Icons\\FalconAppLogoBorder_Orange.ico"
116 ICON "Icons\\FalconAppLogoBorder_Red.ico"
117 ICON "Icons\\FalconAppLogoBorder_Rose.ico"
118 ICON "Icons\\FalconAppLogoBorder_Violet.ico"
119 ICON "Icons\\FalconAppLogoBorder_Yellow.ico"
121 ICON "Icons\\FalconAppLogoBorderTransparent_Blue.ico"
122 ICON "Icons\\FalconAppLogoBorderTransparent_Cyan.ico"
123 ICON "Icons\\FalconAppLogoBorderTransparent_Green.ico"
124 ICON "Icons\\FalconAppLogoBorderTransparent_Lime.ico"
125 ICON "Icons\\FalconAppLogoBorderTransparent_Orange.ico"
126 ICON "Icons\\FalconAppLogoBorderTransparent_Red.ico"
127 ICON "Icons\\FalconAppLogoBorderTransparent_Rose.ico"
128 ICON "Icons\\FalconAppLogoBorderTransparent_Violet.ico"
129 ICON "Icons\\FalconAppLogoBorderTransparent_Yellow.ico"

Steps to update Falcon version:

  1. Update the version number in 4 lines (FILEVERSION, PRODUCTVERSION, "FileVersion" and "ProductVersion")
  2. Save the resource file
  3. Recompile the resource to creating RES file from RC, opening a terminal and typing: rc App.cs
  4. Rebuild solution (not only build but full rebuild must be performed).

[!WARNING] Sometimes it's necessary a full delete of bin folder.

image

[!NOTE] In the project file, there's an entry: <Win32Resource>App.res</Win32Resource> that uses the generated RES file when building the assembly.

Publish a new version (release optimized code)

In Visual Studio, in the solution explorer, right click in 'Falcon.Client' project and select 'Publish' from the context menu. The project is configured for optimizing code using Release configuration, so the only thing we've to do is click on Publish button.

image

Once the project is published, we can close the publish window and proceed to the Publisher utility to upload the published version to the azure container as usual.

Publish new version using 'Publisher' internal tool

Publish new app version (MAJOR)

(under development)