Modo in cui le modifiche al codice possono influire sulla compatibilità

  • Articolo

Per compatibilità si intende la possibilità di compilare o eseguire codice in una versione di un'implementazione di .NET diversa da quella con cui il codice è stato sviluppato originariamente. Una particolare modifica può influire sulla compatibilità in sei modi diversi:

Modifiche funzionali

Una modifica funzionale rappresenta una modifica del comportamento di un membro. La modifica può essere visibile esternamente (ad esempio, un metodo può generare un'eccezione diversa) oppure può rappresentare un'implementazione modificata (ad esempio, una modifica nel modo in cui viene calcolato un valore restituito, l'aggiunta o la rimozione di chiamate di metodo interne o anche un miglioramento significativo delle prestazioni).

Quando le modifiche funzionali sono visibili esternamente e modificano il contratto pubblico di un tipo, risultano facili da valutare poiché influiscono sulla compatibilità binaria. Le modifiche all'implementazione sono molto più difficili da valutare. A seconda della natura della modifica e della frequenza e dei modelli d'uso dell'API, l'impatto di una modifica può variare da grave a innocuo.

Compatibilità binaria

La compatibilità binaria si riferisce alla capacità di un consumer di un'API di usare l'API in una versione più recente senza ricompilarla. Le modifiche come l'aggiunta di metodi o l'aggiunta di una nuova implementazione di interfaccia a un tipo non influiscono sulla compatibilità binaria. Tuttavia, la rimozione o la modifica delle firme pubbliche di un assembly a causa della quale i consumer non possono più accedere alla stessa interfaccia esposta dall'assembly influiscono sulla compatibilità binaria. Una modifica di questo tipo viene definita modifica senza compatibilità binaria.

Compatibilità con l'origine

La compatibilità con l'origine si riferisce alla capacità dei consumer esistenti di un'API di eseguire la ricompilazione per una versione più recente senza apportare alcuna modifica all'origine. Una modifica incompatibile con l'origine si verifica quando un consumer deve modificare il codice sorgente per poterlo compilare correttamente per una versione più recente di un'API.

Compatibilità della fase di progettazione

La compatibilità della fase di progettazione si riferisce al mantenimento dell'esperienza in fase di progettazione in versioni diverse di Visual Studio e in altri ambienti di progettazione. Sebbene ciò possa interessare il comportamento o l'interfaccia utente degli strumenti di progettazione, l'aspetto più importante della compatibilità della fase di progettazione riguarda la compatibilità del progetto. Un progetto o una soluzione deve poter essere aperto e usato in una versione più recente dell'ambiente di progettazione.

Compatibilità con le versioni precedenti

La compatibilità con le versioni precedenti si riferisce alla capacità di un consumer esistente di un'API di supportare l'esecuzione su una nuova versione mantenendo invariato il comportamento. Sia le modifiche funzionali che quelle alla compatibilità binaria influiscono sulla compatibilità con le versioni precedenti. Se un consumer non supporta l'esecuzione o funziona in modo diverso quando viene eseguito con la versione più recente dell'API, l'API è incompatibile con le versioni precedenti.

Le modifiche che influiscono sulla compatibilità con le versioni precedenti sono sconsigliate, perché gli sviluppatori danno per scontata la compatibilità con le versioni precedenti nelle nuove versioni di un'API.

Compatibilità con le versioni successive

La compatibilità con le versioni successive si riferisce alla capacità di un consumer esistente di un'API di supportare l'esecuzione su una versione precedente offrendo lo stesso comportamento. Se un consumer non supporta l'esecuzione o funziona in modo diverso quando viene eseguito in una versione precedente dell'API, l'API è incompatibile con le versioni successive.

Il mantenimento della compatibilità con le versioni successive impedisce virtualmente modifiche o aggiunte da una versione all'altra, perché tali modifiche impediscono l'esecuzione in una versione precedente a un consumer destinato a una versione successiva. Gli sviluppatori si aspettano che un consumer che si basa su un'API più recente potrebbe non funzionare correttamente con l'API precedente.

Mantenere la compatibilità con le edizioni successive non è un obiettivo di .NET Core.