daohualiuxiang
/
dotnet
mirror of https://github.com/microsoft/dotnet.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Initial draft of .NET Native 1.7 release notes 

Initial draft of net-native1.7 notes.  refactored existing notes into
separate net-native{1.4, 1.6, 1.7} folders.
pull/461/head
Josh Free 2017-08-04 11:44:09 -07:00
parent 730b20e42d
commit 56df2ab8f0
4 changed files with 133 additions and 67 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

73
releases/UWP/README.md
View File

@ -1,79 +1,18 @@
# Microsoft.NETCore.UniversalWindowsPlatform NuGet Package Releases
# .NET Native (UWP) Releases
You can learn about Microsoft.NETCore.UniversalWindowsPlatform [releases](#releases), below. See [resources](#resources) for additional information.
## Release Notes
You can see what was included in each Microsoft.NETCore.UniversalWindowsPlatform release.
You can see what was included in each .NET Native (Microsoft.NETCore.UniversalWindowsPlatform) release.
### 5.3.4 (August 4, 2017)
When using Visual Studio this package requires Visual Studio 2017 or later.
- Corrected an issue where System.Threading.Thread.MemoryBarrier was implemented as no-op on x86 release builds.
### 5.3.3 (April 24, 2017)
When using Visual Studio this package requires Visual Studio 2017 or later.
- Corrected an [issue](http://stackoverflow.com/questions/43530071/how-to-fix-app-submission-error-of-1300) for projects that have Visual Studio configuration values that are not "DEBUG" or "RELEASE" that causes Windows Store submission failure (error code 1300). For example, most Unity apps use a configuration named "Master".
### 5.3.2 (April 6, 2017)
When using Visual Studio this package requires Visual Studio 2017 or later.
- Fixed an issue that caused MAKEPRI build warnings to be emitted when building app packages for UWP projects.
### 5.3.1 (March 7, 2017)
When using Visual Studio this package requires Visual Studio 2017 or later.
- Fixed an [issue](https://github.com/dotnet/corefx/issues/10374) that caused DataContractJsonSerializer to fail to serialize any [DataContract] type whose default constructor is not public.
- Fixed a regression in 5.3.0 where [4 Libraries were accidently no longer referenced by default](https://github.com/dotnet/corefx/issues/10338)
- System.Collections.NonGeneric
- System.Collections.Specialized
- System.Threading.Overlapped
- System.Xml.XmlDocument
### 5.3.0 (January 27, 2017)
When using Visual Studio this package requires Visual Studio 2017 or later. You can read more about these changes in our announcement blog [post](https://blogs.msdn.microsoft.com/dotnet/2017/01/30/announcing-net-core-net-native-and-nuget-updates-in-vs-2017-rc/).
- Added NuGet support for Visual Studio 2017 or later.
- Added hardware-accelerated support for System.Numerics.Vectors.
- Added the ability to inspect static fields that contain the ThreadStatic attribute.
- Added x64 support for Shared Library package with profile-guided optimizations which reduces the package size and improves startup time for x64 native apps. This change brings x64 to parity with x86 and ARM32.
- Integrated .NET Native garbage collector with Windows Runtime MemoryManager API to properly calculate memory load factor in UWP applications.
- Reduced compile times for applications that contain large and/or complex methods by ~25% in certain scenarios.
- Increased performance improvements in reverse p/invoke (up to 400%) and when accessing Windows Runtime objects (up to 135% in certain scenarios).
- Improvements to the relfection stack and metadata formats which result in up to 30% performance increase in some scenarios.
- Improvements to delegate invocation that reduce code size and give up to 7% faster performance.
- General code quality improvements which improve start up times, better steady-state performance, less memory usage and smaller app size.
- Resolved an issue that sometimes resulted in a 1300 error when submitting a package to the store after upgrading / cherry-picking .NET Core assembly packages.
- resolved an issue that caused a memory leak when interacting with certain Windows Runtime objects in a different process.
- significantly reduced global lock contention when accessing Windows Runtime objects from multiple threads.
- Resolved an issue that resulted in queries not executing properly in Entity Framework when enabling .NET Native. ([GitHub #6381](https://github.com/aspnet/EntityFramework/issues/6381))
- Resolved an issue with System.Linq.Expressions that resulted in unsupressable error messages. ([GitHub #5088](https://github.com/dotnet/corefx/issues/5088))
- .NET Native will now show a warning if you have a native DLL in a different CPU architecture than the application being built. This is a common mistake that results in the application not being able to launch.
#### Known issues
- .NET native does not currently support portable PDBs. When debugging managed components with portable PDBs in application compiled with .NET native, you may have trouble setting breakpoints, stepping in, and/or inspecting variables of related types in those components. You can delete the files from the local package directory (users\userName.nuget\packages) to workaround the warning. This change was also made in the servicing update for .NET Native 1.4 in the latest update to Visual Studio 2017 RC. Earlier versions of .NET native may incorrectly throw OutOfMemoryException and crash during build when consuming portable PDBs.
### 5.2.3 (March 7, 2017)
When using Visual Studio this package requires Visual Studio 2015 Update 3 or later.
- Fixed an [issue](https://github.com/dotnet/corefx/issues/10374) that caused DataContractJsonSerializer to fail to serialize any [DataContract] type whose default constructor is not public.
- Fixed a regression in 5.2.2 where [4 Libraries were accidently no longer referenced by default](https://github.com/dotnet/corefx/issues/10338)
- System.Collections.NonGeneric
- System.Collections.Specialized
- System.Threading.Overlapped
- System.Xml.XmlDocument
### 5.2.2 (July 14, 2016)
When using Visual Studio this package requires Visual Studio 2015 Update 3 or later. You can read more about these changes in the Visual Studio 2015 Update 3 blog [post](https://www.visualstudio.com/en-us/news/releasenotes/vs2015-update3-vs).
- Fixed several customer reported bugs.
- Improved release build compilation times of large applications.
- Improved runtime performance for XAML applications and Unity games.
- [.NET Native 1.7 (UWP 5.4.x)](net-native1.7/README.md)
- [.NET Native 1.6 (UWP 5.3.x)](net-native1.6/README.md)
- [.NET Native 1.4 (UWP 5.2.x)](net-native1.4/README.md)
## Resources
- [Getting Started with .NET Native](https://docs.microsoft.com/en-us/dotnet/framework/net-native/getting-started-with-net-native)
- [Microsoft.NETCore.UniversalWindowsPlatform NuGet Package Details](https://www.nuget.org/packages/Microsoft.NETCore.UniversalWindowsPlatform)
- [Windows Dev Center](https://developer.microsoft.com/en-us/windows/apps/getstarted)
- [Downloads and tools for Windows 10](https://developer.microsoft.com/en-us/windows/downloads)

28
releases/UWP/net-native1.4/README.md 100644
View File

@ -0,0 +1,28 @@
# .NET Native 1.4 (UWP 5.2.x) Release Notes
You can see what was included in each .NET Native 1.4 ([Microsoft.NETCore.UniversalWindowsPlatform 5.2.x](https://www.nuget.org/packages/Microsoft.NETCore.UniversalWindowsPlatform)) release, below.
When using Visual Studio these packages require Visual Studio 2015 Update 3 or later.
### 5.2.3 (March 7, 2017)
- Fixed an [issue](https://github.com/dotnet/corefx/issues/10374) that caused DataContractJsonSerializer to fail to serialize any [DataContract] type whose default constructor is not public.
- Fixed a regression in 5.2.2 where [4 Libraries were accidently no longer referenced by default](https://github.com/dotnet/corefx/issues/10338)
- System.Collections.NonGeneric
- System.Collections.Specialized
- System.Threading.Overlapped
- System.Xml.XmlDocument
### 5.2.2 (July 14, 2016)
You can read more about these changes in the Visual Studio 2015 Update 3 blog [post](https://www.visualstudio.com/en-us/news/releasenotes/vs2015-update3-vs).
- Fixed several customer reported bugs.
- Improved release build compilation times of large applications.
- Improved runtime performance for XAML applications and Unity games.
## Resources
- [Getting Started with .NET Native](https://docs.microsoft.com/en-us/dotnet/framework/net-native/getting-started-with-net-native)
- [Microsoft.NETCore.UniversalWindowsPlatform NuGet Package Details](https://www.nuget.org/packages/Microsoft.NETCore.UniversalWindowsPlatform)
- [Windows Dev Center](https://developer.microsoft.com/en-us/windows/apps/getstarted)
- [Downloads and tools for Windows 10](https://developer.microsoft.com/en-us/windows/downloads)

57
releases/UWP/net-native1.6/README.md 100644
View File

@ -0,0 +1,57 @@
# .NET Native 1.6 (UWP 5.3.x) Release Notes
You can see what was included in each .NET Native 1.6 ([Microsoft.NETCore.UniversalWindowsPlatform 5.3.x](https://www.nuget.org/packages/Microsoft.NETCore.UniversalWindowsPlatform)) release, below.
When using Visual Studio these packages require Visual Studio 2017 or later.
### 5.3.4 (August 4, 2017)
- Corrected an issue where System.Threading.Thread.MemoryBarrier was implemented as no-op on x86 release builds.
### 5.3.3 (April 24, 2017)
- Corrected an [issue](http://stackoverflow.com/questions/43530071/how-to-fix-app-submission-error-of-1300) for projects that have Visual Studio configuration values that are not "DEBUG" or "RELEASE" that causes Windows Store submission failure (error code 1300). For example, most Unity apps use a configuration named "Master".
### 5.3.2 (April 6, 2017)
- Fixed an issue that caused MAKEPRI build warnings to be emitted when building app packages for UWP projects.
### 5.3.1 (March 7, 2017)
- Fixed an [issue](https://github.com/dotnet/corefx/issues/10374) that caused DataContractJsonSerializer to fail to serialize any [DataContract] type whose default constructor is not public.
- Fixed a regression in 5.3.0 where [4 Libraries were accidently no longer referenced by default](https://github.com/dotnet/corefx/issues/10338)
- System.Collections.NonGeneric
- System.Collections.Specialized
- System.Threading.Overlapped
- System.Xml.XmlDocument
### 5.3.0 (January 27, 2017)
You can read more about these changes in our announcement blog [post](https://blogs.msdn.microsoft.com/dotnet/2017/01/30/announcing-net-core-net-native-and-nuget-updates-in-vs-2017-rc/).
- Added NuGet support for Visual Studio 2017 or later.
- Added hardware-accelerated support for System.Numerics.Vectors.
- Added the ability to inspect static fields that contain the ThreadStatic attribute.
- Added x64 support for Shared Library package with profile-guided optimizations which reduces the package size and improves startup time for x64 native apps. This change brings x64 to parity with x86 and ARM32.
- Integrated .NET Native garbage collector with Windows Runtime MemoryManager API to properly calculate memory load factor in UWP applications.
- Reduced compile times for applications that contain large and/or complex methods by ~25% in certain scenarios.
- Increased performance improvements in reverse p/invoke (up to 400%) and when accessing Windows Runtime objects (up to 135% in certain scenarios).
- Improvements to the relfection stack and metadata formats which result in up to 30% performance increase in some scenarios.
- Improvements to delegate invocation that reduce code size and give up to 7% faster performance.
- General code quality improvements which improve start up times, better steady-state performance, less memory usage and smaller app size.
- Resolved an issue that sometimes resulted in a 1300 error when submitting a package to the store after upgrading / cherry-picking .NET Core assembly packages.
- resolved an issue that caused a memory leak when interacting with certain Windows Runtime objects in a different process.
- significantly reduced global lock contention when accessing Windows Runtime objects from multiple threads.
- Resolved an issue that resulted in queries not executing properly in Entity Framework when enabling .NET Native. ([GitHub #6381](https://github.com/aspnet/EntityFramework/issues/6381))
- Resolved an issue with System.Linq.Expressions that resulted in unsupressable error messages. ([GitHub #5088](https://github.com/dotnet/corefx/issues/5088))
- .NET Native will now show a warning if you have a native DLL in a different CPU architecture than the application being built. This is a common mistake that results in the application not being able to launch.
#### Known issues
- .NET native does not currently support portable PDBs. When debugging managed components with portable PDBs in application compiled with .NET native, you may have trouble setting breakpoints, stepping in, and/or inspecting variables of related types in those components. You can delete the files from the local package directory (users\userName.nuget\packages) to workaround the warning. This change was also made in the servicing update for .NET Native 1.4 in the latest update to Visual Studio 2017 RC. Earlier versions of .NET native may incorrectly throw OutOfMemoryException and crash during build when consuming portable PDBs.
## Resources
- [Getting Started with .NET Native](https://docs.microsoft.com/en-us/dotnet/framework/net-native/getting-started-with-net-native)
- [Microsoft.NETCore.UniversalWindowsPlatform NuGet Package Details](https://www.nuget.org/packages/Microsoft.NETCore.UniversalWindowsPlatform)
- [Windows Dev Center](https://developer.microsoft.com/en-us/windows/apps/getstarted)
- [Downloads and tools for Windows 10](https://developer.microsoft.com/en-us/windows/downloads)

42
releases/UWP/net-native1.7/README.md 100644
View File

@ -0,0 +1,42 @@
# .NET Native 1.7 (UWP 5.4.x) Release Notes
You can see what was included in each .NET Native 1.7 ([Microsoft.NETCore.UniversalWindowsPlatform 5.4.x](https://www.nuget.org/packages/Microsoft.NETCore.UniversalWindowsPlatform)) release, below.
When using Visual Studio these packages require Visual Studio 2017 or later.
### 5.4.0 (TBD)
#### Improved Diagnostics and Better Support for Portable PDBs
- In .NET Native 1.7, we added support for the new [Portable PDB format](https://github.com/dotnet/corefx/blob/master/src/System.Reflection.Metadata/specs/PortablePdb-Metadata.md) for representing symbol information in the .NET Native UWP compiler. The portable PDB format was originally developed to support cross-platform symbol information for managed code as well as drastically reduce the size of debug info - the format makes use of the MSIL module metadata instead of duplicating it and, because of this, it is typically an order of magnitude shorter than the equivalent Windows PDB. In addition to that, the portable PDB format supports an "embedded" flavor in which the symbol information is directly attached to the MSIL executable in form of a binary blob, making it much easier to deploy such managed binaries, not having to care about two different files (with all the related problems of mutual compatibility, signing etc.). The debugging experience is on par with Windows PDB's - we encode the same debug information just in a more compact manner. The previous version of the .NET Native toolchain was oblivious of the portable PDB format. [1640097]
- Improved the debug experience for apps compiled with "/debug:embedded" [364639]
#### Fixes for Build Warnings and other Compilation Improvements
- Fixed an issue that caused MAKEPRI to emit a spurious build warning [378512]
- Fixed an issue that prevented embedding a win32 resource into a C# UWP project [370533]
- Fixed an MSBuild targets issue that caused UWP App Release builds to fail occasionally (Error MSB6003: The specified task executable "ilc.exe" could not be run. The handle is invalid) [401406]
- Fixed a build crash when using ValueTuple with embedded null values in the string[] passed to TupleElementNamesAttribute [409209]
#### Fixes for Localization and non-English Scenarios
- Fixed an issue where string resources emitted by Microsoft.NetNative.IL2IL were English-only and not localized [438193]
#### Fixes for Crashes and other Application Reliability Improvements
- Fixed an issue where System.Reflection would sometimes return two copies of every Attribute in an assembly [392708]
- Fixed an issue that caused System.ServiceModel.MessageParameterAttribute to not work properly in C# UWP projects [394307]
- Fixed a crash with obfuscated applications [396131]
- Fixed a WinMD data corruption issue [430881]
- Fixed Watson-reported crashes in .NET Native 1.6 [432913]
- Fixed a crash in Module::DoCustomImports [432987]
- Fixed incorrect data reported in telemetry [443373]
- Upgraded to newer VSTelemetry SDK and dependent package versions [442135]
- Improved telemetry handling of internal usage [444253]
- Fixed crash in optimizing compiler c2n.dll [300136, 300146]
- Fixed an issue where memory barrier is implemented as no-op on x86 [452729]
## Resources
- [Getting Started with .NET Native](https://docs.microsoft.com/en-us/dotnet/framework/net-native/getting-started-with-net-native)
- [Microsoft.NETCore.UniversalWindowsPlatform NuGet Package Details](https://www.nuget.org/packages/Microsoft.NETCore.UniversalWindowsPlatform)
- [Windows Dev Center](https://developer.microsoft.com/en-us/windows/apps/getstarted)
- [Downloads and tools for Windows 10](https://developer.microsoft.com/en-us/windows/downloads)