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

Uniremo i nostri SDK dell'estensione Swift agli SDK principali per rendere API Swift-native più ampiamente disponibili e aumento della nostra capacità di supportare le nuove funzionalità del linguaggio Swift in futuro. Le modifiche che stiamo apportando e i loro l'impatto previsto sui tuoi progetti è documentato di seguito.

Che cosa cambia?

A partire dall'SDK Firebase per Apple 10.17.0, gli SDK per l'estensione Swift hanno sono stati uniti nei rispettivi SDK principali. Ad esempio, tutte le API del modulo FirebaseFirestoreSwift sono stati aggiunti a FirebaseFirestore, quindi non devi più importare il modulo FirebaseFirestoreSwift per accedere per le API.

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

★ Nota: tutte le versioni delle estensioni Swift rilasciate in precedenza o al momento continuerà a funzionare. Tuttavia, ti consigliamo di eseguire la migrazione della tua app in modo che utilizzi le API Swift dal modulo principale per assicurarti di continuare a ricevere correzioni e di poter usufruire di modifiche e nuove funzionalità.

Date importanti per questa modifica

A ottobre 2023

Gli SDK di estensioni Swift sono stati uniti agli SDK principali e poi ritirati in favore degli SDK principali. Consulta le note di rilascio per la versione 10.17.0 che annunciano questa modifica.

Ora puoi utilizzare le API SDK di estensione Swift direttamente dai moduli SDK principali. L'utilizzo degli SDK delle estensioni sarà comunque possibile fino alla versione principale successiva ma genererà un avviso di deprecazione se utilizzata.

Già a febbraio 2024

Interrompieremo il rilascio di nuove versioni delle estensioni Swift e rimuoveremo le estensioni Swift da Package.swift di Firebase. Le versioni precedenti continueranno per funzionare, ma non riceverà aggiornamenti.

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

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

Modifiche all'area di lavoro

Gestore pacchetti Swift

Dopo aver aggiornato Firebase alla versione 10.17.0 o successive, vai alla sezione Framework, librerie e contenuti incorporati nella scheda Generale delle impostazioni del target e rimuovi l'SDK di estensione Swift (ad esempio 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 dei framework relativa al target e rimuovi l'SDK dell'estensione Swift (ad esempio il pod FirebaseFirestoreSwift). Quindi, esegui nuovamente il comando pod install.

Distribuzione di zip e Carthage

Dopo aver aggiornato Firebase alla versione 10.17.0 o successive, rimuovi eventuali estensioni Swiftxcframeworks all'interno del progetto (ad esempioFirebaseFirestoreSwift.xcframework).

Modifiche al codice sorgente

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

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