Skip to content

Deprecation it IT

ArchiBot edited this page Nov 23, 2023 · 18 revisions

Deprecazione

We're doing our best to follow consistent deprecation policy in order to make both development as well as usage far more consistent.


Cos'Γ¨ la deprecazione?

Deprecation is the process of smaller or bigger breaking changes that render previously used options, arguments, functionalities or usage cases obsolete. La deprecazione di solito significa che la cosa data Γ¨ semplicemente stata riscritta in un'altra forma (simile) e dovresti assicurarti in modo tempestivo di eseguire il passaggio appropriato a esso. In questo caso, Γ¨ semplicemente spostare la funzionalitΓ  in un luogo piΓΉ appropriato.

ASF cambia rapidamente e colpisce sempre per diventare migliore. Questo purtroppo significa che potremmo modificare o spostare alcune funzionalitΓ  esistenti in un altro segmento del programma perchΓ© benefici da nuove funzionalitΓ , per compatibilitΓ  o stabilitΓ . Grazie a questo non dobbiamo attenerci a decisioni di sviluppo obsolete o semplicemente dolorosamente sbagliate fatte anni fa. Proviamo sempre a fornire sostituzioni ragionevoli adeguate all'uso previsto della funzionalitΓ  precedentemente disponibile, poichΓ© la deprecazione Γ¨ principalmente innocua e richiede piccole correzioni dall'uso precedente.


Fasi di deprecazione

ASF seguirΓ  2 fasi di deprecazione, rendendo la transizione molto piΓΉ facile e meno fastidiosa.

Fase 1

La fase 1 si verifica solo quando la data funzione diviene deprecata, con disponibilitΓ  immediata di un'altra soluzione (o nessuna se non si pianifica di reintrodurla).

Durante questa fase, ASF produrrΓ  avvisi appropriati quando la funzione deprecata Γ¨ in uso. FinchΓ© Γ¨ possibile, ASF proverΓ  a imitare il vecchio comportamento e continuerΓ  ad esservi compatibile. ASF continuerΓ  ad essere nella fase 1 con riguardo a tale funzionalitΓ  almeno fino alla versione stabile successiva. Questo Γ¨ il momento in cui, si spera senza rompere la compatibilitΓ , potete fare il passaggio appropriato in tutti gli strumenti e schermi che soddisfino il nuovo comportamento. Potete confermare se avete eseguito tutte le modifiche appropriate non vedendo piΓΉ l'avviso di deprecazione.

Fase 2

La fase 2 Γ¨ pianificata dopo che si svolge la fase 1 spiegata sopra ed Γ¨ rilasciata nella versione stabile. Questa fase introduce la rimozione completa dell'esistenza della funzionalitΓ  deprecata, a significare che ASF non riconoscerΓ  nemmeno che stai tentando di usarne una, figuriamoci rispettarla, poichΓ© semplicemente non esiste nel codice corrente. ASF non produrrΓ  piΓΉ alcun avviso, poichΓ© non riconoscerΓ  piΓΉ cosa stai tentando di fare.


Sommario

Hai piΓΉ o meno un mese intero per fare il passaggio appropriato, che dovrebbe essere piΓΉ che abbastanza anche se sei un utente casuale di ASF. Dopo quel periodo, ASF non garantisce piΓΉ che le vecchie impostazioni avranno alcun effetto (fase 2), rendendo effettivamente non piΓΉ funzionali certe funzionalitΓ  senza che tu lo noti. Se stai lanciando ASF dopo piΓΉ di un mese di inattivitΓ , si consiglia di ricominciare da zero, o di leggere tutti i changelog mancati e di aggiornare manualmente il tuo uso a quello corrente.

In gran parte dei casi, ignorare l'avviso di deprecazione non renderΓ  inutilizzabile la funzionalitΓ  generale di ASF, ma farΓ  tornare al comportamento predefinito (che potrebbe o meno corrispondere alle tue preferenze personali).


Esempio

Abbiamo spostato l'argomento della riga di comando --server della pre-V3.1.2 nella proprietΓ  di configurazione globale di IPC.

Fase 1

La fase 1 si Γ¨ verificata alla versione V3.1.2.2 dove abbiamo aggiunto l'avviso appropriato all'uso di --server. Ora l'argomento obsoleto --server Γ¨ stato mappato automaticamente nella proprietΓ  di configurazione globale IPC: true, agendo efficientemente esattamente come il vecchio --server da tempo. Questo ha consentito a tutti di eseguire il passaggio appropriato prima dell'interruzione dell'accettazione da ASF del vecchio argomento.

Fase 2

La fase 2 si Γ¨ verificata nella versione V3.1.3.0, subito dopo la V3.1.2.9 stabile con la fase 1 spiegata sopra. La Fase 2 ha causato l'interruzione da ASF del riconoscimento dell'argomento --server in generale, trattandolo come ogni altro argomento non valido passato, che non ha piΓΉ alcun effetto sul programma. Per le persone che non avevano cambiato ancora il loro uso di --server in IPC: true ha causato l'interruzione del funzionamento di IPC, poichΓ© ASF non eseguiva piΓΉ la mappatura appropriata.

Clone this wiki locally