wxWidgets/release.md at 49c508c7a978004c73f40b9b7e4097706befa723

Vadim Zeitlin 2f0bce2979 Replace old Trac links with GitHub ones

Also update a couple of links to SF.

2022-01-13 16:52:58 +01:00

8.8 KiB

Raw Blame History

Welcome to wxWidgets, a free and open source cross-platform C++ framework for writing advanced GUI applications using native controls.

wxWidgets 3.1.5 is the latest release in the 3.1 development branch. This release is a "development" one as it makes (very few) incompatible API changes compared to 3.0 and does not guarantee the ABI stability, unlike the 3.0.x series. It is not inherently more buggy or less stable than the "stable" releases and you're encouraged to use it, including in production. If you're already using 3.0, upgrading shouldn't require any special effort, so please try it out.

Please see README for more information about this release and the change log for more details of the changes in it.

Source Files and Documentation

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.1.5.zip or wxWidgets-3.1.5.7z, for much smaller size, for Microsoft Windows systems or wxWidgets-3.1.5.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:

3f5bc4b1cc2c28646891b1dbce286966fff64feb  wxMSW-3.1.5-Setup.exe
e4deb54cbf506904072fb7540b039e4fc8d720ee  wxWidgets-3.1.5-docs-chm.zip
9935227c83ff730cd3d2f809d0cbe6c5fbcd13f9  wxWidgets-3.1.5-docs-html.tar.bz2
8ec0f4e99586ef6db43ddb218a2c2b05383b3667  wxWidgets-3.1.5-docs-html.zip
9613dfd0eb5e185f2cf227266583a8d9486b6156  wxWidgets-3.1.5-headers.7z
2113a3fe3245a9450f959358e6fec7bb9ffbf8a9  wxWidgets-3.1.5.7z
725455d6324baa808259b56a42199237327e0638  wxWidgets-3.1.5.tar.bz2
69e4dcf9be7cad0261ee5874064a8747a5585aaa  wxWidgets-3.1.5.zip

Binaries

We provide pre-built binary files for the following compilers:

Microsoft Visual C++ compiler versions 9.0, 10.0, 11.0, 12.0, 14.0, 14.1, 14.2 and 14.3 (corresponding to marketing product names of Microsoft Visual Studio 2008, 2010, 2012, 2013, 2015, 2017, 2019 and 2022 respectively). Please note that MSVC 14.x versions are ABI-compatible and the same set of binaries is used for all of them.
MinGW-w64 versions 7.3 and 8.1 (32-bit binaries use SJLJ exceptions, 64-bit ones use SEH, and all binaries use Win32 threads).
TDM-GCC 9.2.0.

For Developers

For developing applications with wxWidgets you need to download the compiler-independent wxWidgets-3.1.5_Headers.7z file and one of wxMSW-3.1.5-vcXXX_Dev.7z or wxMSW-3.1.5_gccXXX_Dev.7z files depending on your compiler, its version and the target architecture (x86 if not specified or x64).

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.

For End Users

End users may download one of wxMSW-3.1.5_vcXXX_ReleaseDLL.7z or wxMSW-3.1.5_gccXXX_ReleaseDLL.7z files to get just the DLLs required for running the applications using wxWidgets.

For Debugging

Microsoft Visual C++ users: Files wxMSW-3.1.5_vcXXX_ReleasePDB.7z contain the debug symbols for the release build of the DLLs. Download them 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.
MinGW-TDM users: Currently the debug symbols are not available for the release build of the DLLs (only the debug versions of the DLLs contains the debug symbols).

Binary File Download Verification