Chúng tôi đang hợp nhất các SDK tiện ích mở rộng Swift của mình vào các SDK chính để giúp các API gốc Swift khả dụng rộng rãi hơn và tăng khả năng hỗ trợ các tính năng ngôn ngữ Swift mới trong tương lai. Những thay đổi chúng tôi đang thực hiện và tác động dự kiến của chúng đối với dự án của bạn được ghi lại bên dưới.
Điều gì đang thay đổi?
Bắt đầu với Firebase cho Apple SDK 10.17.0, SDK tiện ích mở rộng Swift đã được hợp nhất vào SDK chính tương ứng của chúng. Ví dụ: tất cả các API từ mô-đun FirebaseFirestoreSwift đã được thêm vào FirebaseFirestore , do đó bạn không còn phải nhập mô-đun FirebaseFirestoreSwift để truy cập các API đó nữa.
Vì tất cả tiện ích mở rộng Swift hiện là một phần của mô-đun chính nên SDK tiện ích mở rộng không còn cần thiết nữa và không còn được dùng nữa. Việc bao gồm hoặc sử dụng SDK tiện ích mở rộng Swift sẽ đưa ra cảnh báo cho trình biên dịch và kể từ tháng 2 năm 2024, chúng tôi sẽ ngừng phát hành hoàn toàn các tiện ích mở rộng Swift.
★ Lưu ý: Mọi phiên bản tiện ích mở rộng Swift hiện tại hoặc đã phát hành trước đó sẽ vẫn hoạt động. Tuy nhiên, chúng tôi khuyên bạn nên di chuyển ứng dụng của mình sang sử dụng API Swift từ mô-đun chính để đảm bảo bạn tiếp tục nhận được các bản sửa lỗi và có thể tận dụng các thay đổi cũng như tính năng mới.
Những ngày quan trọng cho sự thay đổi này
Vào tháng 10 năm 2023
SDK tiện ích mở rộng Swift đã được hợp nhất vào SDK chính và sau đó không còn được dùng nữa để thay thế bằng SDK chính. Xem ghi chú phát hành cho phiên bản 10.17.0 thông báo về thay đổi này.
Giờ đây, bạn có thể sử dụng API SDK tiện ích mở rộng Swift trực tiếp từ các mô-đun SDK chính. Bạn vẫn có thể sử dụng SDK tiện ích mở rộng cho đến khi phát hành phiên bản chính tiếp theo nhưng sẽ đưa ra cảnh báo không dùng nữa khi sử dụng.
Ngay từ tháng 2 năm 2024
Chúng tôi sẽ ngừng phát hành các phiên bản mới của tiện ích mở rộng Swift và chúng tôi sẽ xóa tiện ích mở rộng Swift khỏi Package.swift của Firebase. Các phiên bản cũ hơn sẽ tiếp tục hoạt động nhưng sẽ không nhận được bản cập nhật.
Cách di chuyển để sử dụng API gốc Swift từ mô-đun chính
Nếu hiện tại bạn không sử dụng SDK tiện ích mở rộng Swift thì không cần thực hiện hành động nào. Nếu bạn sử dụng SDK tiện ích mở rộng Swift, hãy thực hiện những thay đổi sau trong dự án của bạn.
Thay đổi không gian làm việc
Trình quản lý gói Swift
Sau khi cập nhật Firebase lên phiên bản 10.17.0+, hãy điều hướng đến phần Khung, Thư viện và Nội dung nhúng trong tab Chung trong cài đặt của mục tiêu và xóa SDK tiện ích mở rộng Swift (chẳng hạn như FirebaseFirestoreSwift ).
Vỏ ca cao
Sau khi cập nhật Firebase lên phiên bản 10.17.0+, hãy điều hướng đến Podfile của bạn và xóa dòng tương ứng với sự phụ thuộc của dự án vào việc thêm phần khung cho mục tiêu của bạn và xóa SDK tiện ích mở rộng Swift (chẳng hạn như pod FirebaseFirestoreSwift ). Sau đó, chạy lại lệnh pod install .
Phân phối Zip và Carthage
Sau khi cập nhật Firebase lên phiên bản 10.17.0+, hãy xóa mọi xcframeworks tiện ích mở rộng Swift trong dự án của bạn (chẳng hạn như FirebaseFirestoreSwift.xcframework ).
Thay đổi mã nguồn
Đối với tất cả SDK tiện ích mở rộng Swift mà bạn đã sử dụng trước đây, hãy thực hiện các hành động sau:
- Xóa mọi câu lệnh nhập tham chiếu SDK tiện ích mở rộng Swift. Nếu SDK chính không được nhập riêng, bạn sẽ cần thay thế phần nhập tiện ích mở rộng Swift bằng phần nhập SDK chính bằng cách xóa
Swiftở cuối dòng. - Nếu bạn đã sử dụng không gian tên mô-đun rõ ràng của Swift để tham chiếu bất kỳ loại SDK tiện ích mở rộng Swift nào, bạn sẽ cần thay thế các loại SDK đó bằng SDK chính tương ứng. Ví dụ:
FirebaseFirestoreSwift.QueryPredicatesẽ cần được đổi tên thànhFirebaseFirestore.QueryPredicate.