Chúng tôi đang hợp nhất các SDK tiện ích Swift vào các SDK chính để tạo Các API gốc Swift được cung cấp rộng rãi hơn và tăng khả năng hỗ trợ của chúng tôi 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à các thay đổi bên dưới là danh sách tác động dự kiến đối với các dự án của bạn.
Điều gì sẽ thay đổi?
Kể từ Firebase cho SDK Apple 10.17.0, SDK tiện ích Swift có
đã được hợp nhất vào các 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,
vì vậy, bạn không còn phải nhập mô-đun FirebaseFirestoreSwift để truy cập
các API đó.
Vì tất cả tiện ích Swift hiện đều là một phần của các mô-đun chính, nên SDK tiện ích cũng đã nằm trong các mô-đun chính. không còn cần thiết và không còn được dùng nữa. Bao gồm hoặc sử dụng Swift các SDK tiện ích sẽ đưa ra cảnh báo về 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 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 sẽ vẫn hoạt động. Tuy nhiên, bạn nên di chuyển ứng dụng của mình để sử dụng Swift API 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 và 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 đó không dùng nữa và thay vào đó là 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 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ó 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 được 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 từ 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 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 bạn.
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 Khung,
Thư viện và phần Nội dung được nhúng trong thẻ Chung của mục tiêu
cài đặt 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 của bạn rồi xoá
dòng tương ứng với phần phụ thuộc của dự án khi thêm khung
cho mục tiêu của bạn và xoá SDK tiện ích Swift
(chẳng hạn như nhóm FirebaseFirestoreSwift). Sau đó, hãy 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 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 Swift mà bạn đã sử dụng trước đây, hãy thực hiện các bước sau hành động:
- 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ẽ cần thay thế Swift
nhập tiện ích với nhập SDK chính bằng cách xoá
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 đến bất kỳ Swift nào
bạn sẽ cần thay thế các SDK đó bằng
SDK. Ví dụ:
FirebaseFirestoreSwift.QueryPredicatecần phải là đổi tên thànhFirebaseFirestore.QueryPredicate.