Registrare le estensioni di associazione di Funzioni di Azure

I progetti che usano una libreria di classi .NET usano estensioni di associazione installate nel progetto come pacchetti NuGet.

I pacchetti di estensioni consentono alle app non-.NET di usare le estensioni di associazione senza dover interagire con l'infrastruttura .NET.

Extension bundles

I pacchetti di estensioni aggiungono un set predefinito di estensioni di associazione compatibili all'app per le funzioni. Le versioni dei pacchetti di estensioni sono sottoposte a controllo. Ogni versione contiene un set specifico di estensioni di associazione verificate per funzionare insieme. Selezionare una versione del pacchetto in base alle estensioni necessarie nell'app.

Quando si crea un progetto di Funzioni di Azure da un modello diverso da .NET, i bundle di estensione risultano già abilitati nel file dell'app host.json.

Quando possibile, usare l'intervallo di versioni più recente per ottenere prestazioni ottimali dell'app e accedere alle funzionalità più recenti. Per altre informazioni sui bundle di estensioni, vedere Bundle di estensioni di Funzioni di Azure.

Nel caso improbabile che non sia possibile usare un bundle di estensioni, è necessario installare in modo esplicito le estensioni.

Per i progetti che usano una libreria di classi C# compilata, installare i pacchetti NuGet per le estensioni necessarie come normalmente si farebbe nelle app. Per altre informazioni, vedere la Guida per sviluppatori di Visual Studio Code o la Guida per sviluppatori di Visual Studio.

Assicurarsi di ottenere il pacchetto corretto, perché lo spazio dei nomi è diverso a seconda del modello di esecuzione:

Le Funzioni di Azure offrono bundle di estensioni per i progetti non .NET. Questi bundle contengono un set completo di estensioni di associazione che vengono verificate essere compatibili. Se si verificano problemi di compatibilità tra due o più estensioni di binding, esaminare le combinazioni compatibili delle versioni dell'estensione. Per le combinazioni supportate di estensioni di associazione, consultare la pagina di rilascio per i pacchetti di estensioni.

In alcuni casi non è possibile usare pacchetti di estensioni, ad esempio quando è necessario usare una versione preliminare specifica di un'estensione specifica. In questi rari casi, è necessario installare manualmente le estensioni di binding necessarie in un file di progetto C# che fa riferimento alle estensioni specifiche richieste dall'app.

Per installare manualmente le estensioni di associazione:

1. Rimuovere il riferimento al bundle di estensione dal file host.json.

2. Usare il comando func extensions install in Azure Functions Core Tools per generare il necessario file extensions.csproj nella radice del progetto locale.

   Per lo sviluppo esclusivamente tramite portale, è necessario creare manualmente un file extensions.csproj nella radice dell'app delle funzioni su Azure. Per altre informazioni, vedere Installare manualmente le estensioni.

3. Modificare il extensions.csproj file aggiungendo in modo esplicito un elemento per ogni estensione e versione di binding PackageReference specifica richiesta dall'app.

4. Verificare localmente la funzionalità dell'app e quindi implementare nuovamente il progetto, incluso extensions.csproj, nella tua applicazione Azure Functions.

Appena possibile, è consigliabile ripristinare l'app usando il bundle di estensione supportato più recente.