docs/release.md
Welcome to wxWidgets, a free and open source cross-platform C++ framework for writing advanced GUI applications using native controls.
wxWidgets 3.3.3 is the fourth release in the 3.3 development branch, bringing many new features and improvements compared to the stable 3.2 branch while remaining mostly API-compatible with it.
Please note that even this is not a "stable" release, it is still considered to be suitable to be used in production, the only difference with the stable releases is that API and ABI compatibility are not guaranteed for the releases in this series. In practice, however, backwards-incompatible API changes are expected to be rare.
Please see README for more information about this release and the change log for more details of the changes in it. In particular, please read the "INCOMPATIBLE CHANGES" section in the change log if you are upgrading from a previous version of wxWidgets.
If you intend to build wxWidgets from sources (which is recommended), please do NOT download the files using the "Source code" links just above, which are automatically generated by GitHub and don't contain the submodules sources which are necessary for building wxWidgets.
Instead, download one of wxWidgets-3.3.3.zip or wxWidgets-3.3.3.7z, for much smaller size, for Microsoft Windows systems or wxWidgets-3.3.3.tar.bz2 for Unix ones, including macOS. These archives have exactly the same contents, but use the line endings appropriate for the corresponding platform.
In addition, we provide archives containing the documentation in either HTML or Microsoft CHM formats. Notice that the documentation is also available online.
Finally, Microsoft Windows users may download Setup.exe file containing both sources and documentation, however please note that this file does not contain any binaries, please see below for those.
To verify your download please use the following SHA-1 checksums:
0000000000000000000000000000000000000000 wxMSW-3.3.3-Setup.exe
0000000000000000000000000000000000000000 wxWidgets-3.3.3-docs-chm.zip
0000000000000000000000000000000000000000 wxWidgets-3.3.3-docs-html.tar.bz2
0000000000000000000000000000000000000000 wxWidgets-3.3.3-docs-html.zip
0000000000000000000000000000000000000000 wxWidgets-3.3.3-headers.7z
0000000000000000000000000000000000000000 wxWidgets-3.3.3.7z
0000000000000000000000000000000000000000 wxWidgets-3.3.3.chm
0000000000000000000000000000000000000000 wxWidgets-3.3.3.tar.bz2
0000000000000000000000000000000000000000 wxWidgets-3.3.3.zip
We provide pre-built binary files for x86-64 Windows for the following compilers:
For developing applications with wxWidgets you need to download the compiler-independent wxWidgets-3.3.3_Headers.7z file and one of wxMSW-3.3.3-vc14x_x64_Dev.7z or wxMSW-3.3.3_gcc1510_x64_Dev.7z files depending on your compiler.
Unpack both files into the same directory so that include and lib directories are at the same level after unpacking. You should be able to compile and link applications using wxWidgets in both debug and release modes but the debug symbols are provided only for debug libraries in this archive, see below for the release build debug symbols.
Note that if you're setting up a new project using these binaries, the simplest way to do it is to use the provided wxwidgets.props file: for this, open the View|Property Manager menu item in the IDE, select "Add Existing Property Sheet..." from the project context menu and browse to this file in the file open dialog.
Please see the instructions in the manual for more details.
End users may download one of wxMSW-3.3.3_vc14x_x64_ReleaseDLL.7z or wxMSW-3.3.3_gcc1510_x64_ReleaseDLL.7z files to get just the DLLs required for running the applications using wxWidgets.
wxMSW-3.3.3_vc14x_x64_ReleasePDB.7z contains the debug symbols for the release build of the DLLs. Download it if you want to debug your own applications in release build or if you want to get meaningful information from mini-dumps retrieved from your users machines.To verify your download please use the following SHA-1 checksums:
0000000000000000000000000000000000000000 wxMSW-3.3.3_gcc1420UCRT_x64_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.3.3_gcc1420UCRT_x64_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.3.3_gcc1520_x64_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.3.3_gcc1520_x64_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.3.3_vc14x_x64_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.3.3_vc14x_x64_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.3.3_vc14x_x64_ReleasePDB.7z
Please report bugs to the issue tracker or the wx-users mailing list.