This post was written by Lucian Wischik, Program Manager on the Managed Languages team.
As part of this update, we’re including a new opt-in pre-release feature that will shrink the size of your app:
In this article I’ll tell you the what and why and how of this new feature. Then I’ll tell you how it fits into the wider context — about how improvements in .NET make their way into your UWP apps.
UWP apps have included .NET app-locally
Until now, when you build a UWP app, it has included all the .NET APIs that it actually uses, app-locally.
“… But doesn’t this get a bit big?”
Here’s a concrete example. I wrote a Game of Life simulator that runs on Windows 10 devices, both desktop and mobile, and takes advantage of the Win2d library to run the simulation fast on each device’s graphics accelerator. My source code is here on github. This is what the simulator looks like:
And this is what I get when I build my app in Release mode. I’ve shown the “before” and “after” of the new feature:
What we’re delivering with Win10 Tools 1.1 is the ability to shave off that extra grey segment that comes from the .NET libraries.
How the feature works
The ability to reduce app-size is still in pre-release. We hope to make it the default experience soon, but for now in the Win10 Tools 1.1 release the feature is opt-in…
- This is the first public release of the feature, and we want to give it some time and testing before switching everyone over.
- For most apps, the feature delivers faster build times for Release builds. We observe build times are generally faster, up to about 30% — but there are a few apps actually take longer to build. We are working on making the flag deliver a more consistent improvement to build times.
- When you upgrade to VS2015 Update 1, if your project is using this flag, then you might need to upgrade your project in some way in order to open it. We haven’t closed on this.
- Any apps you submit to the store right now, using this flag, will continue to work.
How the feature works. When the feature is enabled, .NET Native release builds no longer include the bulk of .NET locally within the app. Instead .NET is delivered through a “Shared AppX Framework Package”. That means:
- When customers download your app from the Store, this download doesn’t contain the bulk of .NET
- Instead, the right version of .NET gets automatically downloaded on-demand from the Store, and is shared between all apps that use it.
You can see how it’s accomplished inside your app’s
binReleasex86ilcAppxManifest.xml file. It has a line like this, which is what the Store app obeys when installing your app:
Instructions to opt-in to using the SharedFramework
As mentioned, we plan make this feature the default so it will happen automatically. Until then, you must opt-in by a configuration flag as follows. Within Visual Studio, right-click on your UWP project and unload project. Right-click once again and Edit the .vbproj/.csproj. Within this proj file, look for all three occurrences of
and add a new directive under them as follows. By default, the three places that use the .NET Native toolchain are Release|x86, Release|x64 and Release|Arm.
<span style="font-family: 'courier new', courier;"><<span class="pl-ent">UseDotNetNativeToolchain</span>>true</<span class="pl-ent">UseDotNetNativeToolchain</span>> <<span class="pl-ent">UseDotNetNativeSharedAssemblyFrameworkPackage</span>>true</<span class="pl-ent">UseDotNetNativeSharedAssemblyFrameworkPackage</span>></span>
Next, right-click on your project once again, Reload, and rebuild.
Tip: you can also avoid unloading+reloading by editing the proj file outside VS, for instance in Notepad. VS will automatically detect when it needs to reload the project.
Guidance. Here are our recommendations for how to use this flag for now:
- Try it at least once: try turning on the flag at least once — see whether it improves your Release mode buildtimes, and whether you encounter any issues.
- Develop how you wish to submit: in the daily rhythm of development and testing, use the flag in the same way as you intend to submit.
- For store submission: it’s your call whether the benefits of smaller app-size and potentially faster build-times outweigh the risks of using a pre-release feature for you.
- For sample code: leave flag off, so that in the future you and others have an easier time building your sample.
- If you’re using out-of-band updates to .NET: leave flag off. Read the next section for an explanation.
How to take advantage of fixes in .NET
There are a lot of improvements being made to .NET on a regular basis. How do you as a developer take advantage of these improvements?
Let’s motivate this with a specific example. Suppose you’re writing a UWP app using VS2015 RTM and you write this code:
Don’t worry if this code is unfamiliar — it’s a small corner of the .NET framework using expression trees that’s not commonly used. But for those people who do use it, they need it, and were blocked when they discovered a .NET bug which prevents the call to Expression.Update from working.
In the past if you found an issue in .NET, you were basically stuck — you’d have to wait for the next public release of .NET, and even then you couldn’t depend on all your users installing that update onto their machines.
But now with UWP things are different. This particular Expression.Update issue was identified in the public open-source version of .NET on github, and was fixed with github changeset #2361, and is available in a new publically-available beta of the NuGet package System.Linq.Expressions. To use this beta in your UWP app, do Manage Nuget References, turn on the Include prerelease checkbox, and pick up the latest prerelease version of the package. Most people won’t need any of this. But those who do, who were blocked by this particular API, they now have a way forward.
What’s important with UWP is that you don’t have to depend on your users installing .NET updates onto their machines. Your app will always run on end-user machines against the exact same version of .NET you chose to develop with.
(Where can you find a list of all these pre-release packages and the fixes are inside them? Well, they’re all still in beta. Most developers won’t need to live at the “bleeding edge” and can simply wait until we gather up the changes and publish them, likely in the next VS Update. Those developers who do need these immediate fixes should follow them on the corefx github.)
You can’t combine out-of-band .NET fixes with Shared Framework
You can’t combine out-of-band updates to .NET with the Shared Framework flag. This is what you’ll see if you try it with a pre-release version of System.Linq.Expressions:
“ILC1308: SharedAssembly is not applicable to you project configuration. Project dependencies don’t match the assemblies that the shared assembly is built against. You may need to adjust your project dependencies to ensure they match the versions that the shared assembly is built against.”
.NET Native is an important technology for building UWP apps. In this release we’ve improved it significantly.
We are eager for feedback on the new Shared Framework feature. Please turn the flag on during development. Many of you will observe faster build-times. What we’re hoping to get are reports from you of any problems you encounter — either by email to email@example.com or via the send-a-smile/frown icon at the top of the Visual Studio 2015 titlebar (below). Thank you!