Registrera Azure Functions-bindningstillägg
Från och med Azure Functions version 2.x innehåller funktionskörningen endast HTTP- och timerutlösare som standard. Andra utlösare och bindningar är tillgängliga som separata paket.
.NET-klassbiblioteksfunktioner appar använder bindningar som är installerade i projektet som NuGet-paket. Med tilläggspaket kan non-.NET functions-appar använda samma bindningar utan att behöva hantera .NET-infrastrukturen.
Följande tabell anger när och hur du registrerar bindningar.
| Utvecklingsmiljö | Registrering i Functions 1.x |
Registrering i Functions 2.x eller senare |
|---|---|---|
| Azure Portal | Automatisk | Automatisk* |
| Non-.NET språk | Automatisk | Använd tilläggspaket (rekommenderas) eller installera uttryckligen tillägg |
| C#-klassbibliotek med Visual Studio | Använda NuGet-verktyg | Använda NuGet-verktyg |
| C#-klassbibliotek med Visual Studio Code | Ej tillämpligt | Använda .NET Core CLI Använda C# Dev Kit |
* Portalen använder tilläggspaket, inklusive C#-skript.
Tilläggspaket
Som standard ger tilläggspaket bindningsstöd för funktioner på följande språk:
- Java
- JavaScript
- PowerShell
- Python
- C#-skript
- Andra (anpassade hanterare)
I sällsynta fall där tilläggspaket inte kan användas kan du uttryckligen installera bindningstillägg med ditt funktionsappsprojekt. Tilläggspaket stöds för version 2.x och senare version av Functions-körningen.
Tilläggspaket är ett sätt att lägga till en fördefinierad uppsättning kompatibla bindningstillägg i funktionsappen. Tilläggspaket är versionshanterade. Varje version innehåller en specifik uppsättning bindningstillägg som har verifierats för att fungera tillsammans. Välj en paketversion baserat på de tillägg som du behöver i din app.
När du skapar ett non-.NET Functions-projekt från verktyg eller i portalen är tilläggspaket redan aktiverade i appens host.json-fil .
En tilläggspaketreferens definieras av extensionBundle avsnittet i en host.json enligt följande:
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.0.0, 5.0.0)"
}
}
Följande egenskaper är tillgängliga i extensionBundle:
| Property | beskrivning |
|---|---|
id |
Namnområdet för Microsoft Azure Functions-tilläggsbuntar. |
version |
Versionsintervallet för paketet som ska installeras. Körmiljön för Functions väljer alltid den högsta tillåtna versionen som definieras av versionsintervallet. Ett värdeintervall [4.0.0, 5.0.0) med tillåter till exempel version alla paketversioner från 4.0.0 upp till men inte 5.0.0. Mer information finns in intervallnotationen för att ange versionsintervall. |
I följande tabell visas de tillgängliga versionsintervallen för standardpaketen Microsoft.Azure.Functions.ExtensionBundle och länkar till de tillägg som de innehåller.
| Paketversion | Version i host.json | Inkluderade tillägg |
|---|---|---|
| 1.x | [1.*, 2.0.0) |
Se extensions.json som används för att generera paketet. |
| 2.x | [2.*, 3.0.0) |
Se extensions.json som används för att generera paketet. |
| 3.x | [3.3.0, 4.0.0) |
Se extensions.json som används för att generera paketet. |
| 4.x | [4.0.0, 5.0.0) |
Se extensions.json som används för att generera paketet. |
Kommentar
Även om host.json stöder anpassade intervall för versionbör du använda ett versionsintervallvärde från den här tabellen, till exempel [4.0.0, 5.0.0). En fullständig lista över versioner av tilläggspaket och tilläggsversioner i varje version finns på versionssidan för tilläggspaket.
Installera uttryckligen tillägg
För kompilerade C#-klassbiblioteksprojekt (processbaserad och isolerad arbetsprocess) installerar du NuGet-paketen för de tillägg som du behöver som vanligt. Exempel finns i utvecklarguiden för Visual Studio Code eller Visual Studio-utvecklarguiden. Se versionssidan för tilläggspaket för att granska kombinationer av tilläggsversioner som är verifierade kompatibla.
För non-.NET språk och C#-skript måste du installera nödvändiga bindningstillägg manuellt i det lokala projektet när du inte kan använda tilläggspaket. Det enklaste sättet är att använda Azure Functions Core Tools. Mer information finns i installera func-tillägg.
För utveckling endast i portalen måste du manuellt skapa en extensions.csproj-fil i roten för funktionsappen. Mer information finns i Installera tillägg manuellt.