Chúng tôi đang hợp nhất các SDK tiện ích Swift vào các SDK chính để cung cấp rộng rãi hơn các API gốc của Swift và tăng khả năng hỗ trợ các tính năng mới của ngôn ngữ Swift trong tương lai. Những thay đổi mà chúng tôi sẽ thực hiện và tác động dự kiến của những thay đổi đó đối với các dự án của bạn được ghi lại bên dưới.
Có gì thay đổi?
Kể từ Firebase cho Apple SDK 10.17.0, các SDK tiện ích Swift đã được hợp nhất vào các SDK chính tương ứng. Ví dụ: tất cả API trong mô-đun FirebaseFirestoreSwift đều đã được thêm vào FirebaseFirestore, vì vậy, bạn không còn phải nhập mô-đun FirebaseFirestoreSwift để truy cập vào các API đó nữa.
Vì tất cả các tiện ích Swift hiện là một phần của các mô-đun chính, nên bạn không cần dùng SDK tiện ích nữa và các SDK này không còn được dùng nữa. Việc đưa vào hoặc sử dụng các SDK tiện ích Swift sẽ làm phát sinh cảnh báo của trình biên dịch và muộn nhất là vào 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 Swift.
★ Lưu ý: Mọi phiên bản hiện tại hoặc trước đây của các tiện ích Swift đều sẽ vẫn hoạt động. Tuy nhiên, bạn nên di chuyển ứng dụng để sử dụng API Swift từ mô-đun chính nhằm đả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.
Các ngày quan trọng liên quan đến thay đổi này
Tháng 10 năm 2023
Các SDK tiện ích Swift đã được hợp nhất vào các SDK chính, sau đó không được dùng nữa để chuyển sang các SDK chính. Hãy xem ghi chú phát hành cho phiên bản 10.17.0 để biết thông báo về thay đổi này.
Giờ đây, bạn có thể sử dụng trực tiếp các API SDK tiện ích Swift từ các mô-đun SDK chính. Bạn vẫn có thể sử dụng các SDK tiện ích cho đến khi phát hành phiên bản chính tiếp theo, nhưng sẽ nhận được cảnh báo ngừng sử dụng khi sử dụng.
Sớm nhất là 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 Swift và sẽ xoá các tiện ích Swift khỏi Package.swift của Firebase. Các phiên bản cũ sẽ vẫn 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 các API gốc của Swift từ mô-đun chính
Nếu hiện không sử dụng SDK tiện ích Swift, bạn không cần làm gì cả. Nếu bạn sử dụng SDK tiện ích Swift, hãy thực hiện các thay đổi sau trong dự án của mình.
Thay đổi vùng 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 trở lên, hãy chuyển đến phần Frameworks, Libraries, and Embedded Content (Khung, Thư viện và Nội dung được nhúng) trong thẻ General (Chung) của phần cài đặt mục tiêu và xoá SDK tiện ích Swift (chẳng hạn như FirebaseFirestoreSwift).
CocoaPods
Sau khi cập nhật Firebase lên phiên bản 10.17.0 trở lên, hãy chuyển đến Podfile rồi xoá dòng tương ứng với phần phụ thuộc của dự án khi thêm phần khung cho mục tiêu và xoá SDK tiện ích Swift (chẳng hạn như pod FirebaseFirestoreSwift). Sau đó, hãy chạy lại lệnh pod install.
Phân phối tệp zip và Carthage
Sau khi cập nhật Firebase lên phiên bản 10.17.0 trở lên, hãy xoá mọi tiện ích Swift xcframeworks 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ả các SDK tiện ích Swift mà bạn đã sử dụng trước đây, hãy thực hiện các thao tác sau:
- Xoá mọi câu lệnh nhập tham chiếu đến SDK tiện ích Swift. Nếu không nhập SDK chính riêng biệt, bạn sẽ cần thay thế nội dung nhập tiện ích Swift bằng nội dung nhập SDK chính bằng cách xoá
Swiftở cuối dòng. - Nếu đã sử dụng tính năng phân vù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 Swift nào, bạn sẽ cần thay thế các loại đó bằng SDK chính tương ứng. Ví dụ:
FirebaseFirestoreSwift.QueryPredicatesẽ cần được đổi tên thànhFirebaseFirestore.QueryPredicate.