wxWidgets/docs/release.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

115 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
a1ff476367a888a86e70c93584f729f06b0f9f7f wxMSW-3.2.0-Setup.exe
f9010fd81b8a0013e50c6e0edce8b31a580fe7e1 wxWidgets-3.2.0-docs-chm.zip
b16a086e11af67163d066d47a1a11935b2f4fbfe wxWidgets-3.2.0-docs-html.tar.bz2
969beb10a9301f311f27c0fd90b770bbe8da9b04 wxWidgets-3.2.0-docs-html.zip
f4ae6a0d74ac79b3d6189ea9d512b342afce39c7 wxWidgets-3.2.0-headers.7z
ffa02d8d6c7d1e13d445bb3c59260e2b1df0a489 wxWidgets-3.2.0.7z
b50cfd49d2c8ce7870e28d11cb7810784eab2faf wxWidgets-3.2.0.tar.bz2
1c35ed0acf1c2991ce1de6a27e587cf3d0072e3c 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:
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc730_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc730_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc730_x64_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc730_x64_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc810_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc810_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc810_x64_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc810_x64_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc920TDM_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc920TDM_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc920TDM_x64_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc920TDM_x64_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc1020_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc1020_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc1020_x64_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_gcc1020_x64_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc90_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc90_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc90_ReleasePDB.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc90_x64_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc90_x64_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc90_x64_ReleasePDB.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc100_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc100_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc100_ReleasePDB.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc100_x64_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc100_x64_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc100_x64_ReleasePDB.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc110_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc110_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc110_ReleasePDB.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc110_x64_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc110_x64_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc110_x64_ReleasePDB.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc120_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc120_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc120_ReleasePDB.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc120_x64_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc120_x64_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc120_x64_ReleasePDB.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc14x_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc14x_ReleaseDLL.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc14x_ReleasePDB.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc14x_x64_Dev.7z
0000000000000000000000000000000000000000 wxMSW-3.2.0_vc14x_x64_ReleaseDLL.7z
0000000000000000000000000000000000000000 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).