Chúng tôi sẽ 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 Swift, đồng thời tăng khả năng hỗ trợ các tính năng ngôn ngữ Swift mới trong tương lai. Dưới đây là tài liệu về những thay đổi chúng tôi đang 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.
Điều gì sẽ thay đổi?
Kể từ Firebase cho SDK của Apple 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ả các API từ mô-đun FirebaseFirestoreSwift đã đượ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 các API đó nữa.
Vì tất cả tiện ích Swift hiện đều là một phần của mô-đun chính, nên SDK tiện ích không còn bắt buộc và 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ẽ đưa ra cảnh báo về trình biên dịch và sớm 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 tiện ích Swift đang hoặc đã phát hành trước đây vẫn sẽ hoạt động. Tuy nhiên, bạn nên di chuyển ứng dụng của mình để sử dụng API Swift từ mô-đun chính nhằm đảm bảo bạn tiếp tục nhận đượ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 có sự thay đổi này
Vào tháng 10/2023
Các SDK tiện ích Swift đã được hợp nhất vào các SDK chính, sau đó ngừng hoạt động và thay vào đó là các SDK chính. Hãy 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 Swift ngay trong các mô-đun SDK chính. Bạn vẫn có thể sử dụng SDK tiện ích cho đến khi có bản phát hành phiên bản lớn tiếp theo, nhưng sẽ đưa ra cảnh báo về việc 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à xoá
tiện ích 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 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 những thay đổi sau trong dự án của bạn.
Các thay đổi về 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 trở lên, hãy chuyển đến phần Khung, Thư viện và Nội dung được nhúng trong thẻ Chung của phần cài đặt mục tiêu rồi 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 và 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 đó, 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 trở lên, hãy xoá mọi tiện ích Swift xcframeworks trong dự án (chẳng hạn như FirebaseFirestoreSwift.xcframework).
Thay đổi mã nguồn
Đối với tất cả SDK tiện ích Swift mà bạn từng sử dụng, 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 SDK chính không được nhập riêng, bạn sẽ phải thay thế lệnh nhập tiện ích Swift bằng lệnh nhập SDK chính bằng cách xoá
Swiftở cuối dòng. - Nếu đã sử dụng không gian tên mô-đun rõ ràng của Swift để tham chiếu đến mọi loại SDK tiện ích Swift, bạn sẽ cần thay thế các loại SDK đó bằng SDK chính tương ứng. Ví dụ:
FirebaseFirestoreSwift.QueryPredicatecần được đổi tên thànhFirebaseFirestore.QueryPredicate.