Wine for Android (development)

The Wine team is proud to announce that the stable release Wine 7.0 is now available.

AdvertisementRemove ads, dark theme, and more with Premium

This release represents a year of development effort and over 9,100 individual changes. It contains a large number of improvements that are listed in the release notes below. The areas of major changes are:

• Most modules converted to PE format.
• Better theming support, with a bundled theme for a more modern look.
• Vastly improved HID stack and joystick support.
• New WoW64 architecture.

The source is available now. Binary packages are in the process of being built, and will appear soon at their respective download locations.

The Wine team is proud to announce that the stable release Wine 7.0
is now available.

This release represents a year of development effort and over 9,100
individual changes. It contains a large number of improvements that
are listed in the release notes below. The areas of major changes are:

- Most modules converted to PE format.
- Better theming support, with a bundled theme for a more modern look.
- Vastly improved HID stack and joystick support.
- New WoW64 architecture.

The source is available from the following locations:

https://dl.winehq.org/wine/source/7.0/wine-7.0.tar.xz
http://mirrors.ibiblio.org/wine/source/7.0/wine-7.0.tar.xz

Binary packages for various distributions will be available from:

https://www.winehq.org/download

You will find documentation on https://www.winehq.org/documentation

You can also get the current source directly from the git
repository. Check https://www.winehq.org/git for details.

Wine is available thanks to the work of many people. See the file
AUTHORS in the distribution for the complete list.

----------------------------------------------------------------

What's new in Wine 7.0
======================

*** PE modules

- With a few exceptions, all modules can be built in PE format. The goal is to
convert the remaining modules after 7.0.

- For PE modules with an associated Unix library, the interface between the PE
part and the Unix part goes through a standard NT system call. This enables
hiding the Unix code from Windows debuggers, and switching the thread
register on platforms that require it.

- Builtin dlls are only loaded if there is a corresponding PE file on disk,
either a real binary or a fake PE module. This ensures that the application
always sees a valid PE file mapping. It can be disabled through the
WINEBOOTSTRAPMODE environment variable, used at prefix creation time.

*** WoW64

- The 64-bit Windows-on-Windows (WoW64) architecture is implemented, and
supports running a 32-bit Windows application inside a 64-bit Unix host
process, using thunks to map 32-bit NT system calls to the 64-bit NTDLL.

- WoW64 thunks are implemented for most Unix libraries, enabling a 32-bit PE
module to call a 64-bit Unix library. Once the remaining modules are
converted to PE, this will make it possible to run 32-bit applications
without installing 32-bit Unix libraries.

*** Theming

- A "Light" theme is included in Wine, with the color variants "Blue" and
"Classic Blue". It can be enabled through WineCfg.

- All the Common Controls support theming, and automatically refresh on theme
changes.

- All the builtin applications support theming, as well as High DPI rendering.

*** Graphics

- There's a new Win32u library implementing the kernel side of graphics and
window management support. Large portions of the GDI32 and USER32 libraries
are converted to use this new library. This work will continue after 7.0, and
the graphics drivers (winex11.drv, winemac.drv, etc.) will be migrated to
Win32u as well.

- The Vulkan driver supports up to version 1.2.201 of the Vulkan spec.

- Hit-testing stroked geometries using the Direct2D API is implemented.

- Some initial support for Direct2D effects (using the ID2D1Effect interface)
is implemented.

- The Direct2D API supports the ID2D1MultiThread interface.

- WindowsCodecs supports decoding images in WMP (Windows Media Photo) format,
as well as encoding images to the DDS (DirectDraw Surface) format.

- WindowsCodecs no longer supports encoding images to macOS ICNS format. This
is not supported on Windows, and was no longer used by Wine either.

*** Direct3D

- Various improvements have been made to the Vulkan renderer for the Wine
Direct3D implementation. In most cases, for Direct3D 10 and 11 applications
the Vulkan renderer should be about on-par with the older OpenGL renderer in
Wine 7.0. Like in Wine 6.0, the Vulkan renderer can be enabled by setting the
Direct3D "renderer" registry setting to "vulkan".

- The following Direct3D 10 and 11 features are implemented:
- Deferred device contexts.
- Device context state objects, and switching between them.
- Constant buffer offsetting.
- Resolving typeless multi-sample resources.
- Clearing unordered-access views of texture resources. When using the OpenGL
renderer, this requires the GL_ARB_clear_texture OpenGL extension.
- Resource copies between resources with "block-compatible" formats, like for
example DXGI_FORMAT_BC3_TYPELESS and DXGI_FORMAT_R32G32B32A32_TYPELESS.
- Clearing layered render-target views.

- Support for multiple displays ("multi-head") is implemented. In practice,
this tends to mean the ability to choose which monitor a Direct3D application
will use for full-screen mode. Note that this depends on the underlying
display drivers to accurately report the attached displays. For Wine's X11
driver, that requires proper support for version 1.4 or later of the X RandR
extension.

- Display gamma adjustment using the DXGI API is implemented. This is sometimes
used by Direct3D 10 and 11 applications to adjust screen "brightness".

- Direct3D 12 supports version 1.1 root signatures.

- When the VK_EXT_host_query_reset Vulkan extension is available, query
handling in the Vulkan renderer is slightly more efficient.

- Retrieving swapchain present counts using the DXGI API is implemented.

- A fallback path using GDI is added for swapchain presentation. This is used
in cases where OpenGL or Vulkan can't be used to present the swapchain, for
example when presenting to a window of a different process. This path is much
slower, but is often sufficient for some common use cases, like for example
applications using the Chromium Embedded Framework ("CEF") with cross-process
rendering.

- The "precise" shader instruction modifier is respected when using the GLSL
shader backend.

- The DirectDraw API supports 3D rendering to system memory surfaces when using
software device types like the "RGB", "MMX", and "Ramp" devices.

- The following additional graphics cards are recognized by the Direct3D
graphics card database:
- AMD Radeon RX 5500M
- AMD Radeon RX 6800/6800 XT/6900 XT
- AMD Van Gogh
- Intel UHD Graphics 630
- NVIDIA GT 1030

- The following HKEY_CURRENT_USER\Software\Wine\Direct3D key is removed:
- "UseGLSL"
This setting was deprecated in favor of the "shader_backend" setting in
Wine 5.0, and has been removed in this release.

*** D3DX

- The support for version 10 of the D3DX effects framework is much improved.

- D3DX 10 supports the Windows Media Photo (JPEG XR) image file format.

- Various D3DX10 texture creation functions (D3DX10CreateTextureFromMemory()
and variants) are implemented.

- A partial implementation of the ID3DX10Sprite interface is added.

- A partial implementation of the ID3DX10Font interface is added.

*** Audio / video

- The DirectShow and Media Foundation GStreamer glue is unified into a single
backend, making it easier to implement new media decoding APIs.

- The Windows Media asynchronous and synchronous reader objects are implemented
based on the WineGStreamer backend. Like other multimedia decoding libraries,
they require a functioning GStreamer installation.

- The Media Foundation support is more complete, with notably:
- Basic functionality of IMFPMediaPlayer, media item properties, support for
audio and video tracks.
- Support for sample allocator in the Source Reader.
- Improved EVR sink integration with presenter and mixer.
- Improved SAR rendering buffer behavior.
- Video sample allocator, with support for d3d9, d3d11, and system memory
buffers.
- Further improvements to EVR's presenter and mixer implementation.
- D3D11 frame output for IMFMediaEngine.
- Improvements to generic media source implementation in WineGStreamer to
support stopped and paused states, refined output type configuration.

- The QuickTime decoder library (wineqtdecoder) is removed. GStreamer is
required for all built-in multimedia codecs also on macOS.

*** Input devices

- The HID (Human Interface Device) stack implementation is more complete. This
includes HID descriptor and report parsers, report processing, as well as HID
mini-driver support.

- The winebus.sys driver backends are improved, to better describe the devices
into HID reports when pass-through is not possible, and to add standard
Physical Interface Device reports to expose force-feedback capabilities over
HID.

- There's a new DirectInput joystick backend using the improved HID stack to
communicate with winebus.sys and host devices. This backend supports
force-feedback effects using the standard HID Physical Interface Device
reports, and is also compatible with pass-through HID device which implement
it. The SDL and evdev winebus.sys Linux backends are also supported as they
implement it too. This replaces and deprecates the legacy Linux js and evdev,
and macOS IOHID backends.

- The joystick control panel is improved, as well as the interaction with
XInput-compatible devices. For such devices the joystick control panel can be
used to force DInput as the primary interface instead of XInput. This
translates to the ""="override" (REG_SZ) registry value in
HKCU\Software\Wine\AppDefaults\\DirectInput (or
HKCU\Software\Wine\DirectInput for prefix-wide setting).

- The WinMM joystick support is implemented using DInput instead of Linux evdev
or macOS IOHID, and the old joystick driver (winejoystick.drv) is removed.

- Many tests are added to the DInput module, using a virtual HID device to not
require a physical device anymore. The code is extensively and automatically
tested, including force-feedback effects with HID input / output report
validation.

*** Text and fonts

- Arabic shaping is implemented in DirectWrite, currently enabled for Arabic
and Syriac.

- The Font Set object is implemented in DirectWrite.

- The TextHost interface is properly implemented in RichEdit.

*** Mono / .NET

- The Mono engine is updated to version 7.0.0, with the following changes:
- IDispatch interface supported on COM Callable Wrappers.
- Improved support for SafeArray marshaling.
- Many other marshaling and COM interop improvements.
- Code imports from .NET Core: System.Drawing.Printing,
System.Security.Principal, WindowsFormsApplicationBase, parts of
Microsoft.VisualBasic.Interaction
- WMA and WMV support in FNA using mfplat.
- Debug symbols available separately in PDB form.
- Old VBNC compiler for Visual Basic .NET replaced with the VBC compiler from
.NET Core.
- Mono's JIT compiler generates code compatible with 64-bit macOS.
- WPF built with support for media controls.
- A replacement for the Managed DirectX API is included.
- Fixes for various bugs that prevented most WPF applications from working.

*** Internationalization

- Unicode character tables are based on version 14.0.0 of the Unicode Standard.

- The timezone data is updated, based on the information from the Olson and
Unicode CLDR databases.

- Codepages 720 (Arabic, Farsi and Urdu) and 20949 (Korean Wansung) are
supported.

- The sr-Latn-RS locale is supported.

*** Kernel

- Launching applications with the 'wine' executable invokes start.exe for any
unrecognized binary. This means that file associations work also from the
Unix command line, e.g. 'wine foo.msi'.

- The low-level NtAlertThreadByThreadId / NtWaitForAlertByThreadId
synchronization mechanism (roughly equivalent to Linux futexes) is supported,
and used to implement the higher-level synchronization primitives.

- NT debug objects are implemented and used by the kernel debugger functions.

- The dynamic registry keys for performance data are implemented.

*** C runtime

- There's a full math library implementation in the C runtime, mostly imported
from the Musl C library. The Unix math library is no longer used.

- The floating point environment functions are supported properly on all CPU
platforms.

*** Internet and networking

- IE11 compatibility mode is improved and used by default for
standard-compliant HTML documents.

- JScript EcmaScript compliant mode supports 'let' statements, Map object,
object freezing, object sealing and mutable prototype chains.

- Gecko add-on MSI packages are installed into the prefix on demand, instead of
during prefix update, to make updates faster and reduce disk space usage.

- The DTLS communication protocol is supported.

- The NSI device (Network Store Interface) is implemented, and used to provide
higher-level network services in IpHlpAPI.

- The Windows Sockets support is reimplemented to go through NTDLL and the Afd
device, following the Windows architecture.

- The various network database files (/etc/protocols, /etc/networks, etc.) are
provided and installed in the prefix. The equivalent Unix databases are no
longer used for network queries.

*** Alternative platforms

- The new Apple Silicon Macs are supported, including running x86-64 binaries
under Rosetta 2.

- GnuTLS is required on macOS for BCrypt and Secur32 support; the
macOS-specific backend implementations have been removed.

- 32-bit ARM binaries are built in Thumb-2 mode, like on Windows.

- The preloader is also used on 32-bit ARM, for a more compatible address space
layout.

- Stack unwinding is implemented on 32-bit ARM.

- More low-level system information queries like memory and battery status are
supported on FreeBSD.

*** Builtin applications

- The REG registry tool supports operating on either the 32- or 64-bit view of
the registry.

- The REG registry tool supports copying registry keys.

- The WineDump tool supports dumping Windows Metafiles, and shows more detailed
information for CodeView records.

- The Wine Debugger (winedbg) supports debugging a 32-bit target process from
the 64-bit debugger.

*** Development tools

- The IDL compiler (widl) supports loading type libraries embedded inside PE
files.

- The IDL compiler searches for type libraries in the per-platform library
search path instead of the include search path.

- The IDL compiler supports many more WinRT-specific constructs and attributes.

*** Build infrastructure

- All libraries are installed in architecture-specific directories, using names
like 'i386-windows' for PE binaries, and 'x86_64-unix' for the Unix
libraries. This enables supporting multiple architectures with a single Wine
installation, as well as Winelib cross-compilation.

- Static (.a) import libraries are used on all platforms. Wine no longer
generates the old-style .def libraries, though they are still supported for
backwards compatibility.

- The option to prefer a native DLL by default is specified through a flag in
the PE header, which can be set by passing the '--prefer-native option' to
winebuild. The previous method, handling DLL_WINE_PREATTACH in DllMain, is no
longer supported.

- The Dwarf debugging format is supported up to version 4. The Wine libraries
are built with version 4 by default.

- Unique build identifiers can be stored in the binaries by passing the
'--enable-build-id' option to configure.

- The Clang compiler in MSVC mode is supported.

*** Miscellaneous

- The Shell Folder naming is converted to use the Windows Vista+ scheme; for
instance 'My Documents' becomes 'Documents', and most things are saved under
the 'AppData' directory.

- The OpenCL library wrapper supports versions up to OpenCL 1.2.

- Paper forms are supported in various sizes in the WinSpool printer driver.

- There is initial support for MSDASQL, a Microsoft OLE DB provider for ODBC
drivers.

*** External dependencies

- The following libraries are bundled in the source tree and built as PE
libraries, so they are no longer required at the Unix level:
- Faudio
- GSM
- LCMS2
- LibJPEG
- LibJXR
- LibMPG123
- LibPng
- LibTiff
- LibXml2
- LibXslt
- Zlib

- The libraries above can still be imported as external libraries instead of
using the bundled copy, provided that they are available in PE format. This
behavior is requested with the '--with-system-dllpath' configure option,
which specifies the Unix search path for such dependencies.

- Direct3D 12 support now requires version 1.2 or later of the vkd3d library.
Version 1.2 or later of the related vkd3d-shader library was already required
by Wine 6.0 for translation of Direct3D shader to SPIR-V in the Vulkan
renderer for the Direct3D implementation.

- The deprecated HAL library is no longer supported or needed.

- The macOS QuickTime library is no longer used.

--
Alexandre Julliard
julliard@winehq.org