The Microsoft .NET Framework version 3.0 redistributable package (released 2006-11-06) is the new managed code programming model for Windows. It combines the power of the .NET Framework version 2.0 with new technologies for building applications
that have visually compelling user experiences, seamless communication across technology boundaries, and the ability to support a wide range of business processes. These new technologies are Windows Presentation Foundation, Windows Communication Foundation, Windows Workflow Foundation, and Windows CardSpace.
Selected Test Results (selected in 'Test Results' table below)
What works
Installation using 'winetricks', e.g. 'winetricks dotnet30' (will install required .NET 2.0 prerequisite automatically)
.NET Framework Setup Verification Tool from Aaron Stebner (Microsoft) which checks for proper installation of .NET assemblies and registry entries reports success.
WPF applications are mostly now working thanks to recent client side window rendering code.
Example: http://www.codeproject.com/Articles/16775/NET-3-0-WPF-Tools-and-Examples (you need 'winetricks corefonts')
What does not
n/a
What was not tested
n/a
Additional Comments
Use 'winetricks' script for installation of .NET Framework 3.0 - especially if the app wants to install it on its own!
Always use a clean 32-bit WINEPREFIX for .NET installs (Framework + .NET based app)!
Multiple Microsoft development tools online/web installers fail to skip "$shtdwn$.req" with FILE_ATTRIBUTE_HIDDEN (Visual Studio Express Editions, .NET Framework 3.0)
Microsoft .NET Framework: GAC API for managed assembly installation needs reparse point/junction API support (.NET Framework 2.0, 3.0, 4.0 installers and other apps that make use of GAC API)
Use the following winetricks verb to automatically download and install .NET 3.0 Framework:
$ bash winetricks dotnet30
Be patient until it finishes.
.NET Framework 2.0 which is needed prerequisite will be automatically installed by winetricks.
Microsoft .NET Framework 3.0 Service Packs (SP1, SP2) installation
Make sure you operate on a clean 32-bit WINEPREFIX (~/.wine)!
Installation by using 'winetricks' script
Use this option for easy installation of .NET 3.0 Framework Service Pack(s).
Winetricks
will take care of all needed installation prerequisites and work around
some problems (.NET 3.0 already installed, Service Packs already
applied...).
There is no need to manually install .NET Framework 3.0 before. Winetricks does this as part of service pack install!
.NET Framework 3.0 Service Pack 2:
There is no separate installer for this service pack. It is part of .NET 3.5 Framework Service Pack 1 installer. Refer to .NET 3.5 Framework appdb entry.
Mono uninstallation
Mono (free alternative .NET Implementation) and Microsoft .NET Framework don't mix well in same WINEPREFIX.
If you intend to manually install .NET Frameworks make sure you removed any previous install of 'MONO' package from WINEPREFIX before.
To verify .NET Framework installation(s) in WINEPREFIX you can use the .NET Framework Setup Verification Tool from Aaron Stebner (Microsoft) which checks for proper installation of .NET assemblies and registry entries.
Some errors (while loading dependent modules that are not GAC'd yet) are expected and can be ignored.
Installer dialog window disappears after pressing install button
This is expected. The installer is minimized to systray (there is a balloon tooltip, indicating the action). Double click installer icon in systray to restore the dialog window.
fixme:shell:URL_ParseUrl failed to parse ...
URL_ParseUrl FIXME messages on console when running/installing .NET apps are harmless and can be safely ignored. Example console output:
fixme:shell:URL_ParseUrl failed to parse L"mscorlib"
dotnet20sp1 install completed, but installed file ... /c:/windows/assembly/NativeImages_v2.0.50727_32/indexb.dat not found
If you encounter this error while trying to run 'winetricks dotnet20sp1' recipe:
dotnet20sp1 install completed, but installed file
/home//.wine/dosdevices/c:/windows/assembly/NativeImages_v2.0.50727_32/indexb.dat
not found
"indexXX.dat" files get changed (number increments) each time a native assembly is generated and installed into GAC (ngen run).
It's an error in older winetricks versions that relied on these numbers.
You can verify this by running full GAC rebuild (optional):
After this command new index files have been generated.
Please update your winetricks script to a newer version (see main HOWTO)
Amount of data to be downloaded from .NET Framework 3.0 web (online) installer is large (250 MiB)
The .NET 3.0 web installer detects Wine as Windows MUI with
lots of language packs. Wine returns quite a number of supported user
interface languages hence the installer tries to download a large
number of .NET 3.0 language packs. This will later lead to problem
because .NET 3.0 language packs require the corresponding .NET 2.0
language packs to be installed. These don't get automatically
downloaded and installed which will lead to failure when the installer
tries to install .NET 3.0 language packs.
Use the full (offline) installer
(see download link). Be aware the full installer also has MUI (language
packs) related problem, leading to large delay near the end of
installation (see other note).
/home/yourlogin/.wine is not owned by you / (Permission denied)
Never run wine as root (su, sudo)! Wine doesn't require to be run as root!
You will screw your WINEPREFIX and possibly other things up. If you have run Wine as root you need to:
$ sudo rm -rf ~/.wine
and then run winecfg to set Wine folder structure back up. If you used winetricks script as root you might also need to:
$ sudo rm -rf ~/.cache/winetricks/
Again: Just run wine as regular user and all should be fine.
Setup has encountered a problem while trying to copy $shtdwn$.req (web installer)
This is Bug 9158 encountered in .NET Framework 3.0 web installer. Either use full (offline) installer (see download link) or the following workaround in console:
err:eventlog:ReportEventW .NET Runtime version 2.0.50727.42 - Unrecoverable system error
If a .NET application exits with the following message in console:
fixme:shell:URL_ParseUrl failed to parse L"WindowsBase.resources"
fixme:advapi:ReportEventW (0xcafe4242,0x0001,0x0000,0x000003ff,(nil),0x0001,0x00000000,0x33b6e8,(nil)): stub
err:eventlog:ReportEventW L".NET Runtime version 2.0.50727.42 - Unrecoverable system error.
fixme:advapi:DeregisterEventSource (0xcafe4242) stub
This 'Unrecoverable system error'
is pretty general and can be caused by many things. For instance by bad truetype fonts. Some of Wine's truetype fonts are still not in shape of being a complete replacement for Windows ones, causing errors. You must use winetricks corefonts steps to work around this problem!
System.Window.Markup.XmlParseException when starting .NET apps
If a .NET application exits with the following message in console:
err:secur32:SECUR32_initSchannelSP TLS library not found, SSL connections will fail
err:winediag:SECUR32_initNTLMSP ntlm_auth was not found or is outdated. Make sure that ntlm_auth >= 3.0.25 is in your path. Usually, you can find it in the winbind package of your distribution.
fixme:rpc:RpcBindingSetAuthInfoExW unsupported AuthnSvc 10
You are missing the samba/winbind component which is essential for certain Wine functionality.
Please install winbind with your distribution package manager!
The application requested process termination through System.Environment.FailFast
If a .NET application exits with the following message in console:
err:eventlog:ReportEventW ...
Description: The application requested process termination through System.Environment.FailFast(string message).\n
Message: Unrecoverable system error.\n
Stack:\n
at System.Environment.FailFast(System.String)\n
at MS.Internal.Invariant.FailFast...
Some of Wine's truetype fonts are still not in shape of being a
complete replacement for Windows ones, causing errors.
You must use 'winetricks corefonts' recipe to work around this problem!
