Passa all'utilizzo delle API dell'estensione Swift nei moduli principali

Stiamo unendo i nostri SDK di estensione Swift negli 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 il relativo impatto previsto sui tuoi progetti sono documentati di seguito.

Cosa sta cambiando?

A partire da Firebase per Apple SDK 10.17.0, gli SDK dell'estensione Swift sono stati uniti nei corrispondenti SDK principali. Ad esempio, tutte le API del modulo FirebaseFirestoreSwift sono state aggiunte a FirebaseFirestore , quindi non è più necessario importare il modulo FirebaseFirestoreSwift per accedere a tali API.

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

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

Date importanti per questo cambiamento

Nell'ottobre 2023

Gli SDK dell'estensione Swift sono stati uniti negli SDK principali e quindi 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 dell'SDK dell'estensione Swift direttamente dai moduli SDK principali. L'utilizzo degli SDK di estensione sarà ancora possibile fino al rilascio della versione principale successiva, ma verrà generato un avviso di deprecazione quando utilizzati.

Già nel febbraio 2024

Smetteremo di rilasciare nuove versioni delle estensioni Swift e rimuoveremo le estensioni Swift 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 dell'estensione Swift, non è necessaria alcuna azione. Se utilizzi un SDK di estensione Swift, apporta le seguenti modifiche al tuo progetto.

Cambiamenti nello spazio di lavoro

Gestore pacchetti Swift

Dopo aver aggiornato Firebase alla versione 10.17.0+, vai alla sezione Framework, librerie e contenuto incorporato nella scheda Generale delle impostazioni della tua destinazione e rimuovi l'SDK dell'estensione Swift (come FirebaseFirestoreSwift ).

CocoaPods

Dopo aver aggiornato Firebase alla versione 10.17.0+, vai al tuo Podfile e rimuovi la riga corrispondente alla dipendenza del tuo progetto dall'aggiunta della sezione framework per la tua destinazione e rimuovi l'SDK dell'estensione Swift (come pod FirebaseFirestoreSwift ). Quindi, esegui nuovamente il comando pod install .

Distribuzione zip e Cartagine

Dopo aver aggiornato Firebase alla versione 10.17.0+, rimuovi qualsiasi estensione Swift xcframeworks all'interno del tuo progetto (come FirebaseFirestoreSwift.xcframework ).

Modifiche al codice sorgente

Per tutti gli SDK di estensione Swift utilizzati in precedenza, esegui le seguenti azioni:

Elimina eventuali 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 Swift alla fine della riga.
Se hai utilizzato lo spazio dei nomi del modulo esplicito di Swift per fare riferimento a qualsiasi tipo di SDK di estensione Swift, dovrai sostituirli con l'SDK principale corrispondente. Ad esempio, FirebaseFirestoreSwift.QueryPredicate dovrebbe essere rinominato in FirebaseFirestore.QueryPredicate .