105 lines
8.7 KiB
Markdown
105 lines
8.7 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.1 is the second 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. 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.1/docs/readme.txt) for more information about this release and the [change log](https://raw.githubusercontent.com/wxWidgets/wxWidgets/v3.1.1/docs/changes.txt) for 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.1.zip](https://github.com/wxWidgets/wxWidgets/releases/download/v3.1.1/wxWidgets-3.1.1.zip) or [wxWidgets-3.1.1.7z](https://github.com/wxWidgets/wxWidgets/releases/download/v3.1.1/wxWidgets-3.1.1.7z), for much smaller size, for Microsoft Windows systems or [wxWidgets-3.1.1.tar.bz2](https://github.com/wxWidgets/wxWidgets/releases/download/v3.1.1/wxWidgets-3.1.1.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](http://docs.wxwidgets.org/3.1).
|
|
|
|
Finally, Microsoft Windows users may download [Setup.exe file](https://github.com/wxWidgets/wxWidgets/releases/download/v3.1.1/wxMSW-3.1.1-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:
|
|
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1-Setup.exe
|
|
0000000000000000000000000000000000000000 wxWidgets-3.1.1-docs-chm.zip
|
|
0000000000000000000000000000000000000000 wxWidgets-3.1.1-docs-html.tar.bz2
|
|
0000000000000000000000000000000000000000 wxWidgets-3.1.1-docs-html.zip
|
|
0000000000000000000000000000000000000000 wxWidgets-3.1.1-headers.7z
|
|
0000000000000000000000000000000000000000 wxWidgets-3.1.1.7z
|
|
0000000000000000000000000000000000000000 wxWidgets-3.1.1.tar.bz2
|
|
0000000000000000000000000000000000000000 wxWidgets-3.1.1.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 and 14.1 (corresponding to marketing product names of Microsoft Visual Studio 2008, 2010, 2012, 2013, 2015 and 2017 respectively).
|
|
* TDM-GCC version 5.1 and MinGW-w64 version 7.2 (with the default SJLJ exceptions propagation method, using C++11). Please note that you need to use the very latest MinGW-w64 7.2 compiler release with this version of the compiler which can be downloaded from [here for 32 bits](https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win32/Personal%20Builds/mingw-builds/7.2.0/threads-win32/sjlj/i686-7.2.0-release-win32-sjlj-rt_v5-rev1.7z/download) and [here for 64 bits](https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win64/Personal%20Builds/mingw-builds/7.2.0/threads-win32/seh/x86_64-7.2.0-release-win32-seh-rt_v5-rev1.7z/download), the older "rev0" release has a known bug affecting building wxWidgets in some scenarios.
|
|
|
|
### For Developers
|
|
|
|
For developing applications with wxWidgets you need to download the compiler-independent `wxWidgets-3.1.1_Headers.7z` file and one of `wxMSW-3.1.1-vcXXX_Dev.7z` or `wxMSW-3.1.1_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.
|
|
|
|
### For End Users
|
|
|
|
End users may download one of `wxMSW-3.1.1_vcXXX_ReleaseDLL.7z` or `wxMSW-3.1.1_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.1_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:
|
|
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_gcc510TDM_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_gcc510TDM_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_gcc510TDM_x64_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_gcc510TDM_x64_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_gcc720_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_gcc720_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_gcc720_x64_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_gcc720_x64_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc90_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc90_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc90_ReleasePDB.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc90_x64_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc90_x64_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc90_x64_ReleasePDB.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc100_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc100_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc100_ReleasePDB.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc100_x64_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc100_x64_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc100_x64_ReleasePDB.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc110_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc110_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc110_ReleasePDB.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc110_x64_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc110_x64_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc110_x64_ReleasePDB.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc120_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc120_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc120_ReleasePDB.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc120_x64_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc120_x64_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc120_x64_ReleasePDB.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc140_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc140_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc140_ReleasePDB.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc140_x64_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc140_x64_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc140_x64_ReleasePDB.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc141_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc141_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc141_ReleasePDB.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc141_x64_Dev.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc141_x64_ReleaseDLL.7z
|
|
0000000000000000000000000000000000000000 wxMSW-3.1.1_vc141_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).
|