wxWidgets/docs/release.md

110 lines
8.8 KiB
Markdown
Raw Normal View History

Welcome to wxWidgets, a free and open source cross-platform C++ framework for writing advanced GUI applications using native controls.
wxWidgets 3.2.0 is the first release in the 3.2 stable branch. This means that it will remain ABI-compatible with all the 3.2.x releases in the future, i.e. the applications using it will continue to work with the future releases in this series even without recompiling.
We recommend using this version for any new wxWidgets applications. Existing applications using wxWidgets 3.0 or 3.1 shouldn't require any special effort to upgrade to this version too, so please try upgrading them to it.
Please see [**README**](https://raw.githubusercontent.com/wxWidgets/wxWidgets/v3.2.0/docs/readme.txt) for more information about this release and the [change log](https://raw.githubusercontent.com/wxWidgets/wxWidgets/v3.2.0/docs/changes.txt) for more details of the changes in it.
2015-10-31 16:45:00 -04:00
## Source Files and Documentation
2015-10-31 16:45:00 -04:00
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.2.0.zip](https://github.com/wxWidgets/wxWidgets/releases/download/v3.2.0/wxWidgets-3.2.0.zip) or [wxWidgets-3.2.0.7z](https://github.com/wxWidgets/wxWidgets/releases/download/v3.2.0/wxWidgets-3.2.0.7z), for much smaller size, for Microsoft Windows systems or [wxWidgets-3.2.0.tar.bz2](https://github.com/wxWidgets/wxWidgets/releases/download/v3.2.0/wxWidgets-3.2.0.tar.bz2) for Unix ones, including macOS. These archives have exactly the same contents, but use the line endings appropriate for the corresponding platform.
2015-10-31 16:45:00 -04:00
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.2.0).
Finally, Microsoft Windows users may download [Setup.exe file](https://github.com/wxWidgets/wxWidgets/releases/download/v3.2.0/wxMSW-3.2.0-Setup.exe) containing both sources and documentation, however please note that this file does _not_ contain any binaries, please see below for those.
2015-10-31 16:45:00 -04:00
To verify your download please use the following SHA-1 checksums:
2015-10-31 16:45:00 -04:00
f688858b580f29e9ea0650ee4289d980f68fe2cd wxMSW-3.2.0-Setup.exe
d87c0a3647efb8a6f303d51ddab7e3b01ba2829d wxWidgets-3.2.0-docs-chm.zip
9c9caa3b3ce30b7f8b1e30b7a6cc70353b21761d wxWidgets-3.2.0-docs-html.tar.bz2
ba5c838174132a1267458a12713de16ff1fc5cce wxWidgets-3.2.0-docs-html.zip
75b5271d1a3f08f32557c7a8ca1782310ee279b4 wxWidgets-3.2.0-headers.7z
14b14fc4c5f19f8a0892e09bf3dd115e188540de wxWidgets-3.2.0.7z
412e6aad037417527fa79fda028c89df685aacbd wxWidgets-3.2.0.tar.bz2
29f70fb17f42345a281375b4219fa0b8e8c5dfcd wxWidgets-3.2.0.zip
2015-10-31 16:45:00 -04:00
## Binaries
We provide pre-built binary files for the following compilers:
2015-10-31 16:45:00 -04:00
* 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](https://jmeubank.github.io/tdm-gcc/) 9.2.0.
2015-10-31 16:45:00 -04:00
### For Developers
For developing applications with wxWidgets you need to download the compiler-independent `wxWidgets-3.2.0_Headers.7z` file and one of `wxMSW-3.2.0-vcXXX_Dev.7z` or `wxMSW-3.2.0_gccXXX_Dev.7z` files depending on your compiler, its version and the target architecture (x86 if not specified or x64).
2015-10-31 16:45:00 -04:00
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.
2015-10-31 16:45:00 -04:00
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.
2015-10-31 16:45:00 -04:00
### For End Users
End users may download one of `wxMSW-3.2.0_vcXXX_ReleaseDLL.7z` or `wxMSW-3.2.0_gccXXX_ReleaseDLL.7z` files to get just the DLLs required for running the applications using wxWidgets.
2015-10-31 16:45:00 -04:00
### For Debugging
* Microsoft Visual C++ users: Files `wxMSW-3.2.0_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).
2015-10-31 16:45:00 -04:00
### Binary File Download Verification
To verify your download please use the following SHA-1 checksums:
5e2fda4170d5deeb43d84ddb1d841fafa9f1e968 wxMSW-3.2.0_gcc730_Dev.7z
36a95d7d32e751e62421b5673da01ed47fcdd032 wxMSW-3.2.0_gcc730_ReleaseDLL.7z
90386b94b7cdf5e8cbf63fa8609964fd63df1d0f wxMSW-3.2.0_gcc730_x64_Dev.7z
43332969b4ce531022c4c28d4393cc11395671e4 wxMSW-3.2.0_gcc730_x64_ReleaseDLL.7z
8e4bda49b3c7c52217ee62b597adf0fa87a5ebb5 wxMSW-3.2.0_gcc810_Dev.7z
3d6716c719598a19604a4ee93e83bf8b3851bd4b wxMSW-3.2.0_gcc810_ReleaseDLL.7z
a7c3112872bcc786bf61f730ceff63f9c3bb77f7 wxMSW-3.2.0_gcc810_x64_Dev.7z
542a765802c62c58ad7d66dc35d3b3c792703f5b wxMSW-3.2.0_gcc810_x64_ReleaseDLL.7z
3b63e46a2de7220155756298eac1895ee354212e wxMSW-3.2.0_gcc1030TDM_Dev.7z
b639357e0d74c89fe707c088a8b8d40b6357038d wxMSW-3.2.0_gcc1030TDM_ReleaseDLL.7z
40fc23fbc168322f38d1da03fe10109179bff80f wxMSW-3.2.0_gcc1030TDM_x64_Dev.7z
08df87a0d8a136dddfab2f6e58617a6c4f4c5a54 wxMSW-3.2.0_gcc1030TDM_x64_ReleaseDLL.7z
8bf871dbda2d159e114f963efa6fb7d8e4a8788e wxMSW-3.2.0_gcc1210_Dev.7z
9d74c23a8c22c4fb026a0b365a9edd6c311d064f wxMSW-3.2.0_gcc1210_ReleaseDLL.7z
26a58b3dc1135163921910b69e0ac94f2cbd18a0 wxMSW-3.2.0_gcc1210_x64_Dev.7z
ca15f4ddc1d9ebf68a6a7764eda60a6369285b2d wxMSW-3.2.0_gcc1210_x64_ReleaseDLL.7z
e86a599ca5fac4f9fd478c5df03056461a9f2a99 wxMSW-3.2.0_vc90_Dev.7z
14b32b2d319d5cb97e20e0c862ebe931afcc8c88 wxMSW-3.2.0_vc90_ReleaseDLL.7z
07c706e4f380163a9262b1fc2cc71e4bbc430dc0 wxMSW-3.2.0_vc90_ReleasePDB.7z
6004c2c904e37d0ad65f071076635b775b1b34af wxMSW-3.2.0_vc90_x64_Dev.7z
b3af03e39640e55bca80026dcb28267571bb9459 wxMSW-3.2.0_vc90_x64_ReleaseDLL.7z
dbd356908ace8ac511c767bb334eb4194d8f199f wxMSW-3.2.0_vc90_x64_ReleasePDB.7z
b0da257e3d8d05a1e13aeb9e4cc714fea4accde7 wxMSW-3.2.0_vc100_Dev.7z
740d0d000632ca4da66876827036809bc0714141 wxMSW-3.2.0_vc100_ReleaseDLL.7z
11e362e791c8aae6f6fe214774531473a6f27571 wxMSW-3.2.0_vc100_ReleasePDB.7z
2531fbfdee223a33a0d62bf969df362e53757a9a wxMSW-3.2.0_vc100_x64_Dev.7z
68683b0bfacd1175a6dd9d16bf8cf98816f7209d wxMSW-3.2.0_vc100_x64_ReleaseDLL.7z
3c4825dca2fe3324afceff5a09c553faf76a4c0f wxMSW-3.2.0_vc100_x64_ReleasePDB.7z
6154a3317c439727b660e7390a440e15bd2738b1 wxMSW-3.2.0_vc110_Dev.7z
2d1df83bcdbe6363f1069c8e749192a9f7e358b8 wxMSW-3.2.0_vc110_ReleaseDLL.7z
0bd9ecd2817b778bd491dd76e5c98984c6cc33ec wxMSW-3.2.0_vc110_ReleasePDB.7z
041c2793b4aea3268b4543be8bfd54e57578be81 wxMSW-3.2.0_vc110_x64_Dev.7z
73392738d8fe6cfb7d093735a27e008379494bf3 wxMSW-3.2.0_vc110_x64_ReleaseDLL.7z
13a0fa165e4d943fb358a87baf9d9ccb2fc2fcfa wxMSW-3.2.0_vc110_x64_ReleasePDB.7z
e600cdb0b7a465cad0dba6c5252d1d7f492bdc9d wxMSW-3.2.0_vc120_Dev.7z
32b8559cf7fbc02653b8f5c74cc93403bf8818d4 wxMSW-3.2.0_vc120_ReleaseDLL.7z
b9a7df848aa004ad8d24e2ac144975b477cfa73d wxMSW-3.2.0_vc120_ReleasePDB.7z
8bda0f0b9f7dd0ab43cb9d15c69faf397e378465 wxMSW-3.2.0_vc120_x64_Dev.7z
99cd367545ef3a7bf294af122530ec800e144cee wxMSW-3.2.0_vc120_x64_ReleaseDLL.7z
13b023a9b7baa6e400dc708b226cadcbad89babb wxMSW-3.2.0_vc120_x64_ReleasePDB.7z
20683c6b954947679cd8e80d118d713ec7437412 wxMSW-3.2.0_vc14x_Dev.7z
8aba6c91aad911723a3470e20574b2976594551a wxMSW-3.2.0_vc14x_ReleaseDLL.7z
f4dedf7159b35b4d2a1ba4e92c7d7a93be0bfdb2 wxMSW-3.2.0_vc14x_ReleasePDB.7z
65ad095d125dea942b9a74339e0476d14a53e6af wxMSW-3.2.0_vc14x_x64_Dev.7z
c5164b52771aac9973123cfdbeecc5fe8606faba wxMSW-3.2.0_vc14x_x64_ReleaseDLL.7z
61549c7f12ec7c3398160be3445476a812987f9f wxMSW-3.2.0_vc14x_x64_ReleasePDB.7z
## Reporting Problems
Please report bugs to the [issue tracker](https://github.com/wxWidgets/wxWidgets/issues/new) or the [wx-users mailing list](http://groups.google.com/group/wx-users).