.Net Native Compilers package. Referencing this package will cause the project to be built using the specific version of the .NET Native compiler contained in the package, as opposed to any system installed version.
Supported Platforms:
- UWP tools 2.2
See the version list below for details.
ASP.NET Core Runtime 2.0.9. The ASP.NET Core Runtime enables you to run existing web/server applications. On Windows, we recommended installing the Hosting Bundle, which includes the.NET Core Runtime and IIS support. I was trying to install the Saitek programming software, but the install program told me I needed to update.NET Runtime to version 3.5 or newer before installing the Saitek software. So I tried to find.NET Runtime updates, but can only find.NET Framework results (I do not understand the difference).
Release Notes
Dependencies
- runtime.win10-arm.Microsoft.Net.Native.Compiler(>= 2.2.3)
- runtime.win10-arm64.Microsoft.Net.Native.Compiler(>= 2.2.3)
- runtime.win10-x64.Microsoft.Net.Native.Compiler(>= 2.2.3)
- runtime.win10-x86.Microsoft.Net.Native.Compiler(>= 2.2.3)
Used By
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Microsoft.Net.Native.Compiler:
Package | Downloads |
---|---|
Microsoft.NETCore.UniversalWindowsPlatform Provides a set of packages that can be used when building Universal Windows applications on .NETCore. ba72270a849171e96fb2927d33357c56944d05ba When using NuGet 3.x this package requires at least version 3.4. | 7.9M |
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on Microsoft.Net.Native.Compiler:
Repository | Stars |
---|---|
microsoft/microsoft-ui-xaml Windows UI Library: the latest Windows 10 native controls and Fluent styles for your applications | 3.3K |
Version History
Version | Downloads | Last updated |
---|---|---|
2.2.9-rel-29512-01 | 13,503 | 11/20/2020 |
2.2.8-rel-28605-00 | 98,766 | 3/18/2020 |
2.2.7-rel-27913-00 | 370,446 | 8/23/2019 |
2.2.3 | 236,859 | 3/13/2019 |
2.2.1 | 150,423 | 11/13/2018 |
2.2.0-rel-26924-01 | 9,844 | 10/3/2018 |
2.1.11 | 5,453 | 3/13/2019 |
2.1.8 | 971,222 | 5/8/2018 |
2.1.8-arm64rel-26502-00 | 10,216 | 5/8/2018 |
2.1.6 | 11,326 | 4/27/2018 |
2.0.6 | 22,585 | 3/13/2019 |
2.0.3 | 825,605 | 2/12/2018 |
2.0.2 | 196,320 | 12/5/2017 |
2.0.1 | 22,933 | 11/20/2017 |
2.0.0 | 361,882 | 10/5/2017 |
1.7.6 | 69,149 | 3/13/2019 |
1.7.3 | 368,662 | 12/12/2017 |
1.7.2 | 22,580 | 12/5/2017 |
1.7.1 | 188,818 | 10/5/2017 |
1.7.0 | 130,370 | 8/11/2017 |
1.6.6 | 459 | 3/13/2019 |
1.6.3 | 30,479 | 8/4/2017 |
1.6.2 | 193,862 | 4/24/2017 |
1.6.1 | 46,228 | 4/6/2017 |
1.6.0 | 112,216 | 1/27/2017 |
1.5.0-beta | 5,112 | 11/16/2016 |
Azure Functions currently supports three versions of the runtime host: 1.x, 2.x, and 3.x. All three versions are supported for production scenarios.
Important
Version 1.x is in maintenance mode and only supports development in the Azure portal, Azure Stack Hub portal, or locally on Windows computers. Enhancements are provided only in later versions.
This article details some of the differences between the various versions, how you can create each version, and how to change versions.
Languages
Starting with version 2.x, the runtime uses a language extensibility model, and all functions in a function app must share the same language. The language of functions in a function app is chosen when creating the app and is maintained in the FUNCTIONS_WORKER_RUNTIME setting.
The following table indicates which programming languages are currently supported in each runtime version.
Language | 1.x | 2.x | 3.x |
---|---|---|---|
C# | GA (.NET Framework 4.7) | GA (.NET Core 2.2) | GA (.NET Core 3.1) |
JavaScript | GA (Node 6) | GA (Node 10 & 8) | GA (Node 12 & 10) Preview (Node 14) |
F# | GA (.NET Framework 4.7) | GA (.NET Core 2.2) | GA (.NET Core 3.1) |
Java | N/A | GA (Java 8) | GA (Java 11 & 8) |
PowerShell | N/A | GA (PowerShell Core 6) | GA (PowerShell 7 & Core 6) |
Python | N/A | GA (Python 3.7 & 3.6) | GA (Python 3.8, 3.7, & 3.6) |
TypeScript | N/A | GA* | GA* |
* Supported through transpiling to JavaScript.
See the language-specific developer guide article for more details about supported language versions.
For information about planned changes to language support, see Azure roadmap.
Run on a specific version
By default, function apps created in the Azure portal and by the Azure CLI are set to version 3.x. You can modify this version as needed. You can only change the runtime version to 1.x after you create your function app but before you add any functions. Moving between 2.x and 3.x is allowed even with apps that have functions, but it is still recommended to test in a new app first.
Migrating from 1.x to later versions
You may choose to migrate an existing app written to use the version 1.x runtime to instead use a newer version. Most of the changes you need to make are related to changes in the language runtime, such as C# API changes between .NET Framework 4.7 and .NET Core. You'll also need to make sure your code and libraries are compatible with the language runtime you choose. Finally, be sure to note any changes in trigger, bindings, and features highlighted below. For the best migration results, you should create a new function app in a new version and port your existing version 1.x function code to the new app.
While it's possible to do an 'in-place' upgrade by manually updating the app configuration, going from 1.x to a higher version includes some breaking changes. For example, in C#, the debugging object is changed from TraceWriter
to ILogger
. By creating a new version 3.x project, you start off with updated functions based on the latest version 3.x templates.
Changes in triggers and bindings after version 1.x
Starting with version 2.x, you must install the extensions for specific triggers and bindings used by the functions in your app. The only exception for this HTTP and timer triggers, which don't require an extension. For more information, see Register and install binding extensions.
There are also a few changes in the function.json or attributes of the function between versions. For example, the Event Hub path
property is now eventHubName
. See the existing binding table for links to documentation for each binding.
Changes in features and functionality after version 1.x
A few features were removed, updated, or replaced after version 1.x. This section details the changes you see in later versions after having used version 1.x.
In version 2.x, the following changes were made:
Keys for calling HTTP endpoints are always stored encrypted in Azure Blob storage. In version 1.x, keys were stored in Azure File storage by default. When upgrading an app from version 1.x to version 2.x, existing secrets that are in file storage are reset.
The version 2.x runtime doesn't include built-in support for webhook providers. This change was made to improve performance. You can still use HTTP triggers as endpoints for webhooks.
The host configuration file (host.json) should be empty or have the string
'version': '2.0'
.To improve monitoring, the WebJobs dashboard in the portal, which used the
AzureWebJobsDashboard
setting is replaced with Azure Application Insights, which uses theAPPINSIGHTS_INSTRUMENTATIONKEY
setting. For more information, see Monitor Azure Functions.All functions in a function app must share the same language. When you create a function app, you must choose a runtime stack for the app. The runtime stack is specified by the
FUNCTIONS_WORKER_RUNTIME
value in application settings. This requirement was added to improve footprint and startup time. When developing locally, you must also include this setting in the local.settings.json file.The default timeout for functions in an App Service plan is changed to 30 minutes. You can manually change the timeout back to unlimited by using the functionTimeout setting in host.json.
HTTP concurrency throttles are implemented by default for Consumption plan functions, with a default of 100 concurrent requests per instance. You can change this in the
maxConcurrentRequests
setting in the host.json file.Because of .NET Core limitations, support for F# script (.fsx) functions has been removed. Compiled F# functions (.fs) are still supported.
The URL format of Event Grid trigger webhooks has been changed to
https://{app}/runtime/webhooks/{triggerName}
.
Migrating from 2.x to 3.x
Azure Functions version 3.x is highly backwards compatible to version 2.x. Many apps should be able to safely upgrade to 3.x without any code changes. While moving to 3.x is encouraged, be sure to run extensive tests before changing the major version in production apps.
Breaking changes between 2.x and 3.x
The following are the changes to be aware of before upgrading a 2.x app to 3.x.
JavaScript
Output bindings assigned through
context.done
or return values now behave the same as setting incontext.bindings
.Timer trigger object is camelCase instead of PascalCase
Event Hub triggered functions with
dataType
binary will receive an array ofbinary
instead ofstring
.The HTTP request payload can no longer be accessed via
context.bindingData.req
. It can still be accessed as an input parameter,context.req
, and incontext.bindings
.Node.js 8 is no longer supported and will not execute in 3.x functions.
.NET
- Synchronous server operations are disabled by default.
Changing version of apps in Azure
The version of the Functions runtime used by published apps in Azure is dictated by the FUNCTIONS_EXTENSION_VERSION
application setting. The following major runtime version values are supported:
Value | Runtime target |
---|---|
~3 | 3.x |
~2 | 2.x |
~1 | 1.x |
Important
Don't arbitrarily change this setting, because other app setting changes and changes to your function code may be required.
Locally developed application versions
You can make the following updates to function apps to locally change the targeted versions.
Visual Studio runtime versions
In Visual Studio, you select the runtime version when you create a project. Azure Functions tools for Visual Studio supports the three major runtime versions. The correct version is used when debugging and publishing based on project settings. The version settings are defined in the .csproj
file in the following properties:
Version 1.x
Version 2.x
Version 3.x
Note
Azure Functions 3.x and .NET requires the Microsoft.NET.Sdk.Functions
extension be at least 3.0.0
.
You can open an existing function targeting 2.x and move to 3.x by editing the .csproj
file and updating the values above. Visual Studio manages runtime versions automatically for you based on project metadata. However, it's possible if you have never created a 3.x app before that Visual Studio doesn't yet have the templates and runtime for 3.x on your machine. This may present itself with an error like 'no Functions runtime available that matches the version specified in the project.' To fetch the latest templates and runtime, go through the experience to create a new function project. When you get to the version and template select screen, wait for Visual Studio to complete fetching the latest templates. Once the latest .NET Core 3 templates are available and displayed you should be able to run and debug any project configured for version 3.x.
Important
Version 3.x functions can only be developed in Visual Studio if using Visual Studio version 16.4 or newer.
VS Code and Azure Functions Core Tools
Azure Functions Core Tools is used for command line development and also by the Azure Functions extension for Visual Studio Code. To develop against version 3.x, install version 3.x of the Core Tools. Version 2.x development requires version 2.x of the Core Tools, and so on. For more information, see Install the Azure Functions Core Tools.
For Visual Studio Code development, you may also need to update the user setting for the azureFunctions.projectRuntime
to match the version of the tools installed. This setting also updates the templates and languages used during function app creation. To create apps in ~3
you would update the azureFunctions.projectRuntime
user setting to ~3
.
Maven and Java apps
You can migrate Java apps from version 2.x to 3.x by installing the 3.x version of the core tools required to run locally. After verifying that your app works correctly running locally on version 3.x, update the app's POM.xml
file to modify the FUNCTIONS_EXTENSION_VERSION
setting to ~3
, as in the following example:
Bindings
Starting with version 2.x, the runtime uses a new binding extensibility model that offers these advantages:
Support for third-party binding extensions.
Decoupling of runtime and bindings. This change allows binding extensions to be versioned and released independently. You can, for example, opt to upgrade to a version of an extension that relies on a newer version of an underlying SDK.
A lighter execution environment, where only the bindings in use are known and loaded by the runtime.
.net Core Runtime 2.0 Download
With the exception of HTTP and timer triggers, all bindings must be explicitly added to the function app project, or registered in the portal. For more information, see Register binding extensions.
The following table shows which bindings are supported in each runtime version.
This table shows the bindings that are supported in the major versions of the Azure Functions runtime:
Type | 1.x | 2.x and higher1 | Trigger | Input | Output |
---|---|---|---|---|---|
Blob storage | ✔ | ✔ | ✔ | ✔ | ✔ |
Azure Cosmos DB | ✔ | ✔ | ✔ | ✔ | ✔ |
Dapr3 | ✔ | ✔ | ✔ | ✔ | |
Event Grid | ✔ | ✔ | ✔ | ✔ | |
Event Hubs | ✔ | ✔ | ✔ | ✔ | |
HTTP & webhooks | ✔ | ✔ | ✔ | ✔ | |
IoT Hub | ✔ | ✔ | ✔ | ✔ | |
Kafka2 | ✔ | ✔ | ✔ | ||
Mobile Apps | ✔ | ✔ | ✔ | ||
Notification Hubs | ✔ | ✔ | |||
Queue storage | ✔ | ✔ | ✔ | ✔ | |
RabbitMQ2 | ✔ | ✔ | ✔ | ||
SendGrid | ✔ | ✔ | ✔ | ||
Service Bus | ✔ | ✔ | ✔ | ✔ | |
SignalR | ✔ | ✔ | ✔ | ||
Table storage | ✔ | ✔ | ✔ | ✔ | |
Timer | ✔ | ✔ | ✔ | ||
Twilio | ✔ | ✔ | ✔ |
1 Starting with the version 2.x runtime, all bindings except HTTP and Timer must be registered. See Register binding extensions.
2 Triggers aren't supported in the Consumption plan. Requires runtime-driven triggers.
3 Supported only in Kubernetes, IoT Edge, and other self-hosted modes only.
.net Sdk Runtime 2.0 Download
Function app timeout duration
The timeout duration of a function app is defined by the functionTimeout
property in the host.json project file. The following table shows the default and maximum values in minutes for both plans and the different runtime versions:
Plan | Runtime Version | Default | Maximum |
---|---|---|---|
Consumption | 1.x | 5 | 10 |
Consumption | 2.x | 5 | 10 |
Consumption | 3.x | 5 | 10 |
Premium | 1.x | 30 | Unlimited |
Premium | 2.x | 30 | Unlimited |
Premium | 3.x | 30 | Unlimited |
App Service | 1.x | Unlimited | Unlimited |
App Service | 2.x | 30 | Unlimited |
App Service | 3.x | 30 | Unlimited |
Note
Regardless of the function app timeout setting, 230 seconds is the maximum amount of time that an HTTP triggered function can take to respond to a request. This is because of the default idle timeout of Azure Load Balancer. For longer processing times, consider using the Durable Functions async pattern or defer the actual work and return an immediate response.
Next steps
Net Runtime 3.5 Download
For more information, see the following resources: