wxWidgets/docs/release.md
2021-04-14 16:25:27 +02:00

113 lines
8.8 KiB
Markdown

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**](https://raw.githubusercontent.com/wxWidgets/wxWidgets/v3.1.5/docs/readme.txt) for more information about this release and the [change log](https://raw.githubusercontent.com/wxWidgets/wxWidgets/v3.1.5/docs/changes.txt) 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](https://github.com/wxWidgets/wxWidgets/releases/download/v3.1.5/wxWidgets-3.1.5.zip) or [wxWidgets-3.1.5.7z](https://github.com/wxWidgets/wxWidgets/releases/download/v3.1.5/wxWidgets-3.1.5.7z), for much smaller size, for Microsoft Windows systems or [wxWidgets-3.1.5.tar.bz2](https://github.com/wxWidgets/wxWidgets/releases/download/v3.1.5/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](https://docs.wxwidgets.org/3.1.5).
Finally, Microsoft Windows users may download [Setup.exe file](https://github.com/wxWidgets/wxWidgets/releases/download/v3.1.5/wxMSW-3.1.5-Setup.exe) 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 and 14.2 (corresponding to marketing product names of Microsoft Visual Studio 2008, 2010, 2012, 2013, 2015, 2017 and 2019 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](https://jmeubank.github.io/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
To verify your download please use the following SHA-1 checksums:
5ebc1b0582bce8d701a57b02e6a2fba349321b0e wxMSW-3.1.5_gcc730_Dev.7z
82e40b67049a952c5e030973909125471c4e0fee wxMSW-3.1.5_gcc730_ReleaseDLL.7z
5cdffc4fbafa12d84666f6a6c64960fe7d2e8d02 wxMSW-3.1.5_gcc730_x64_Dev.7z
ab2d354c6fdec2cde0e7c42ef85235d6461c77f0 wxMSW-3.1.5_gcc730_x64_ReleaseDLL.7z
ad1c0cc2eda897894ae904c2a4a52ca9ac2c8c4b wxMSW-3.1.5_gcc810_Dev.7z
dd51936f6c9c9c03c0c1688476cbd171a7d00242 wxMSW-3.1.5_gcc810_ReleaseDLL.7z
c9d8b6183880d5babff36b92d16f083a35747feb wxMSW-3.1.5_gcc810_x64_Dev.7z
d0743d33ceef99d151750303c09ce03206b19716 wxMSW-3.1.5_gcc810_x64_ReleaseDLL.7z
f45e4422104057bc306d2841cf3edd2566a9321b wxMSW-3.1.5_gcc920TDM_Dev.7z
b2f97add892697b9d9ca44eff37c377fd99c0091 wxMSW-3.1.5_gcc920TDM_ReleaseDLL.7z
ea7542359df9aa836ccb5b5bd2acf1d342f1d552 wxMSW-3.1.5_gcc920TDM_x64_Dev.7z
aa17b32d798a858821cb736fc8bd3717eb1e0705 wxMSW-3.1.5_gcc920TDM_x64_ReleaseDLL.7z
6460c066909f2bef2126e03fe3fa624c84f3a80f wxMSW-3.1.5_gcc1020_Dev.7z
2a078d693e883a4ee6f456a7f4e62db7d057dbc6 wxMSW-3.1.5_gcc1020_ReleaseDLL.7z
ddc8237d1142e27c7caf20a618a67dfca292bc3e wxMSW-3.1.5_gcc1020_x64_Dev.7z
efff40d1a8daa8cdc70338e7c08429e6bada650c wxMSW-3.1.5_gcc1020_x64_ReleaseDLL.7z
d04068d7a9908820c53baa54b793ac9c288b812e wxMSW-3.1.5_vc90_Dev.7z
cf2f63efd2896894a687870ac6555335a9285f54 wxMSW-3.1.5_vc90_ReleaseDLL.7z
e32668f005338bf331dee10d1e59bf65ddb90799 wxMSW-3.1.5_vc90_ReleasePDB.7z
dc8e6bb959f7eec8826a077d3f307e0eb46542cf wxMSW-3.1.5_vc90_x64_Dev.7z
f5592a7beaeb8fab7f14603643daa450bbafefe4 wxMSW-3.1.5_vc90_x64_ReleaseDLL.7z
cd102f77207ec0342e527c7524a9e1290f604aa2 wxMSW-3.1.5_vc90_x64_ReleasePDB.7z
8fb912b537438f693b26c5c56264f24871941024 wxMSW-3.1.5_vc100_Dev.7z
29c7feb422db624b578b76ecdb2cec9d09aa0b65 wxMSW-3.1.5_vc100_ReleaseDLL.7z
e6e12d373d3135e98ccd8701c8107ce69157b6a6 wxMSW-3.1.5_vc100_ReleasePDB.7z
75ae81d87aeeaaf37ab5542f347f1a4e1e54b02e wxMSW-3.1.5_vc100_x64_Dev.7z
8ff1b1ed997a940274b5bbb1203170f11d8e13cc wxMSW-3.1.5_vc100_x64_ReleaseDLL.7z
6afd3c8d47f6994a1adec0f2ccd60ed44bbd84b0 wxMSW-3.1.5_vc100_x64_ReleasePDB.7z
f5c9dc6c1c67b28f19696d713dc9cd28c1899bed wxMSW-3.1.5_vc110_Dev.7z
36e5687913ca3cae8c0d6435921f777d508e8950 wxMSW-3.1.5_vc110_ReleaseDLL.7z
89423a7dcb8302d72aacb9cdba067622cdc28800 wxMSW-3.1.5_vc110_ReleasePDB.7z
24bde7032e0869acd585dc7363112bf51630e7ee wxMSW-3.1.5_vc110_x64_Dev.7z
893c6b02429e9fac715e1ff645ef7e65e4ad47f0 wxMSW-3.1.5_vc110_x64_ReleaseDLL.7z
69776baba10b0b436e577c366cdb6c7b12723fd0 wxMSW-3.1.5_vc110_x64_ReleasePDB.7z
d054ed0af0996892d75d4a14028f027a06fda8df wxMSW-3.1.5_vc120_Dev.7z
8d0a66e65a91e2b1ecb602a516edb053fdca803c wxMSW-3.1.5_vc120_ReleaseDLL.7z
34059b0f3b88aa1db1aea89476b4c1d57a873e7a wxMSW-3.1.5_vc120_ReleasePDB.7z
bc0d980dab0d6c87d8f0edc88a1569313a1ac285 wxMSW-3.1.5_vc120_x64_Dev.7z
437e8394c0bf4cb13a5406aac84260aee6cb7833 wxMSW-3.1.5_vc120_x64_ReleaseDLL.7z
6a43784877cb83cef8250da71b7c0f28a264248a wxMSW-3.1.5_vc120_x64_ReleasePDB.7z
6153ecaef9105c2aec786bf20121df149d6115a0 wxMSW-3.1.5_vc14x_Dev.7z
da90397fad661ea8bbdf499fe0b87857d0d07340 wxMSW-3.1.5_vc14x_ReleaseDLL.7z
99bdb43cfd7c2182c0b3890f7e12a071762e2541 wxMSW-3.1.5_vc14x_ReleasePDB.7z
928ebff47e307eb56d3e1930dcd3d16f24b355bc wxMSW-3.1.5_vc14x_x64_Dev.7z
92fbc1b9cb408d424497946c8e8453fd8f40d46d wxMSW-3.1.5_vc14x_x64_ReleaseDLL.7z
a6abd53b92e2378504948560dcac4e6fa77019ae wxMSW-3.1.5_vc14x_x64_ReleasePDB.7z
## Reporting Problems
Please report bugs to the [issue tracker](https://trac.wxwidgets.org/newticket) or the [wx-users mailing list](http://groups.google.com/group/wx-users).