Esegui la migrazione all'utilizzo delle API dell'estensione Swift nei moduli principali

Stiamo unendo gli SDK di estensione Swift agli SDK principali per rendere le API native di Swift più ampiamente disponibili e aumentare la nostra capacità di supportare le nuove funzionalità del linguaggio Swift in futuro. Le modifiche che stiamo apportando e i loro impatti previsti sui tuoi progetti sono documentati di seguito.

Che cosa cambia?

A partire dall'SDK Firebase per Apple 10.17.0, gli SDK di estensione Swift sono stati uniti ai rispettivi SDK principali. Ad esempio, tutte le API dal modulo FirebaseFirestoreSwift sono state aggiunte a FirebaseFirestore, quindi non devi più importare il modulo FirebaseFirestoreSwift per accedere a queste API.

Poiché tutte le estensioni Swift fanno ora parte dei moduli principali, gli SDK di estensione non sono più necessari e sono deprecati. L'inclusione o l'utilizzo degli SDK di estensione Swift genererà un avviso del compilatore e, a partire da febbraio 2024, interromperemo completamente il rilascio delle estensioni Swift.

★ Nota: tutte le versioni delle estensioni Swift rilasciate attualmente o in precedenza continueranno a funzionare. Tuttavia, ti consigliamo di eseguire la migrazione dell'app per utilizzare le API Swift del modulo principale per assicurarti di continuare a ricevere correzioni e di poter usufruire di modifiche e nuove funzionalità.

Date importanti per questa modifica

Ottobre 2023

Gli SDK di estensione Swift sono stati uniti agli SDK principali e poi deprecati a favore degli SDK principali. Consulta le note di rilascio della versione 10.17.0 che annunciano questa modifica.

Ora puoi utilizzare le API degli SDK di estensione Swift direttamente dai moduli SDK principali. L'utilizzo degli SDK di estensione sarà ancora possibile fino al rilascio della prossima versione principale, ma genererà un avviso di deprecazione quando viene utilizzato.

A partire da febbraio 2024

Interromperemo il rilascio di nuove versioni delle estensioni Swift e le rimuoveremo da Package.swift di Firebase. Le versioni precedenti continueranno a funzionare, ma non riceveranno aggiornamenti.

Come eseguire la migrazione per utilizzare le API native di Swift dal modulo principale

Se al momento non utilizzi gli SDK di estensione Swift, non è necessaria alcuna azione. Se utilizzi un SDK di estensione Swift, apporta le seguenti modifiche al progetto.

Modifiche all'area di lavoro

Swift Package Manager

Dopo aver aggiornato Firebase alla versione 10.17.0 o successive, vai alla sezione Framework, librerie e contenuti incorporati nella scheda Generale delle impostazioni della destinazione e rimuovi l'SDK di estensione Swift (ad es. FirebaseFirestoreSwift).

CocoaPods

Dopo aver aggiornato Firebase alla versione 10.17.0 o successive, vai al Podfile e rimuovi la riga corrispondente alla dipendenza del progetto dall'aggiunta della sezione dei framework per la destinazione e rimuovi l'SDK di estensione Swift (ad es. pod FirebaseFirestoreSwift). Quindi, esegui di nuovo il comando pod install.

Distribuzione ZIP e Carthage

Dopo aver aggiornato Firebase alla versione 10.17.0 o successive, rimuovi tutti gli xcframeworks di estensione Swift all'interno del progetto (ad es. FirebaseFirestoreSwift.xcframework).

Modifiche al codice sorgente

Per tutti gli SDK di estensione Swift che hai utilizzato in precedenza, esegui le seguenti azioni:

1. Elimina tutte le istruzioni di importazione che fanno riferimento all'SDK di estensione Swift. Se l'SDK principale non è stato importato separatamente, dovrai sostituire l'importazione dell'estensione Swift con l'importazione dell'SDK principale eliminando Swift alla fine della riga.
2. Se hai utilizzato lo spazio dei nomi dei moduli espliciti di Swift per fare riferimento a qualsiasi tipo di SDK di estensione Swift, dovrai sostituirli con l'SDK principale corrispondente. Ad esempio, FirebaseFirestoreSwift.QueryPredicate dovrà essere rinominato in FirebaseFirestore.QueryPredicate.