Giới thiệu SDK Nền tảng Facebook phiên bản 13.0 và những cập nhật liên quan
Hôm nay, chúng tôi sẽ phát hành Facebook SDK phiên bản 13.0 và những cập nhật bổ sung cho SDK Nền tảng Facebook của mình. Bài viết này trình bày những điểm cập nhật đó và các bước bắt buộc mà nhà phát triển cần thực hiện để tránh làm gián đoạn quá trình tích hợp ứng dụng của họ với nền tảng của chúng tôi (nếu cần). Dưới đây là tổng quan nhanh về một số cập nhật có trong bản phát hành SDK phiên bản 13.0:
- Hỗ trợ API Đồ thị phiên bản 13.0: Chúng tôi sẽ hỗ trợ thêm API Đồ thị phiên bản 13.0 và API Marketing phiên bản 13.0.
- Yêu cầu quyền được nhúng cho ID nhà quảng cáo trên Android trong Facebook SDK dành cho Android: Từ giờ, Android SDK phiên bản 13.0 sẽ mặc định bao gồm yêu cầu quyền cho ID nhà quảng cáo trên Android theo chính sách về ID nhà quảng cáo của Dịch vụ Google Play. Mọi nhà phát triển sử dụng Facebook SDK dành cho Android sẽ cần hành động trước khi Google bắt đầu thực thi theo kế hoạch vào tháng 04/2022 để tránh bị gián đoạn dịch vụ.
- Yêu cầu nhúng Mã ứng dụng vào SDK có hiệu lực: Khi chúng tôi phát hành Facebook SDK phiên bản 13.0, các nhà phát triển giờ đây sẽ phải nhúng Mã ứng dụng vào SDK này.
- Yêu cầu sử dụng mã byte của Java 8 có hiệu lực: Từ giờ, chúng tôi sẽ yêu cầu các nhà phát triển phải sử dụng mã byte của Java 8 để tránh lỗi biên dịch ứng dụng.
- Thông báo về phiên bản ngừng hoạt động: SDK phiên bản 12 (bao gồm phiên bản 12.1, phiên bản 12.2, v.v.) hiện ở trạng thái đã ngừng hoạt động. Kể từ ngày hôm nay, các nhà phát triển nên bắt đầu chuyển sang phiên bản 13.0 để tránh dùng những SDK đã ngừng hoạt động cho ứng dụng của mình.
Vui lòng tìm thêm thông tin chi tiết về những cập nhật này ở bên dưới.
Phát hành SDK phiên bản 13.0
Hôm nay, SDK Nền tảng phiên bản 13.0 sẽ ra mắt trên các nền tảng Android và iOS. Trong bản phát hành này, chúng tôi sẽ hỗ trợ thêm SDK dành cho API Đồ thị phiên bản 13.0 và API Marketing phiên bản 13.0. Chúng tôi đã tạo bài viết trên blog này để nêu bật những thông báo bổ sung, cập nhật về sản phẩm và lời nhắc liên quan đến bản phát hành API Đồ thị phiên bản 13.0 và API Marketing phiên bản 13.0.
Cập nhật quan trọng khác
Dưới đây là tổng quan về những cập nhật và thay đổi khác có trong bản phát hành SDK phiên bản 13.0:
Hiện đại hóa SDK: Chuyển đổi từ Objective-C sang Swift
Chúng tôi sẽ chuyển đổi mã SDK từ Objective-C sang Swift nhằm hiện đại hóa SDK Nền tảng của mình. Bản phát hành SDK phiên bản 13.0 có một số thay đổi do hoạt động chuyển đổi có thể cần Nhà phát triển phải hành động. Những thay đổi này bao gồm:
- Chúng tôi đã chuyển đổi một số loại từ Objective-C sang Swift. Nhà phát triển có thể cần sử dụng câu lệnh nhập theo mô-đun khi sử dụng GamingServicesKit và phần lớn ShareKit để tránh gặp lỗi biên dịch trong Objective-C. Trong trường hợp đó, Nhà phát triển sẽ cần sử dụng @import thay cho #import trong file Objective-C khi sử dụng ký hiệu trong các bộ công cụ này. Nhà phát triển cũng có thể tham khảo nhật ký thay đổi để biết thêm chi tiết về cách sử dụng câu lệnh nhập theo mô-đun.
- Ngoài ra, chúng tôi sẽ giảm bớt việc sử dụng những phương pháp dùng loại giá trị Objective-C trong ShareKit. Kể từ bản phát hành SDK phiên bản 13.0, các loại nội dung trong ShareKit sẽ không còn triển khai những hành vi sau: tuân thủ giao thức NSCopying, băm và cân bằng tùy chỉnh, cũng như tuân thủ NSSecureCoding. Nhà phát triển có thể xem nhật ký thay đổi để biết thêm chi tiết.
- Ngoài ra, chúng tôi cũng đã cập nhật thêm về loại giao diện báo cáo sự kiện trong ứng dụng để từ giờ, nhà phát triển có thể sử dụng tên chính thức cho thông số và sự kiện trong ứng dụng. Nhà phát triển làm việc bằng mã Swift cần phải sử dụng các phiên bản AppEvents.Name và AppEvents.ParameterName để biểu thị tương ứng cho tên sự kiện trong ứng dụng và tên thông số. Nhà phát triển làm việc bằng mã Objective-C có thể tiếp tục sử dụng giá trị chuỗi để tham chiếu đến Giao diện báo cáo. Nhà phát triển có thể xem nhật ký thay đổi để biết thêm chi tiết.
Chuyển các thành phần Chơi game từ ShareKit sang GamingServicesKit:
Trong bản phát hành SDK phiên bản 13.0, chúng tôi đã chuyển 6 loại thành phần chơi game công khai từ ShareKit sang GamingServicesKit, đồng thời chuyển đổi các loại công khai này từ Objective-C sang Swift. Chúng tôi đã chuyển 6 loại công khai sau: GameRequestActionType, GameRequestContent, GameRequestDialog, GameRequestDialogDelegate, GameRequestFilter và GameRequestURLProvider.
Phiên bản ngừng hoạt động và những thay đổi quan trọng:
Yêu cầu quyền được nhúng cho ID nhà quảng cáo trên Android trong Facebook SDK dành cho Android:
Từ giờ, Android SDK phiên bản 13.0 sẽ mặc định bao gồm yêu cầu quyền cho ID nhà quảng cáo trên Android. Chúng tôi sẽ thực hiện thay đổi này theo chính sách về ID nhà quảng cáo của Dịch vụ Google Play. Chúng tôi sẽ yêu cầu Nhà phát triển thực hiện các hành động dưới đây trước tháng 04/2022 để ứng dụng của họ không bị gián đoạn dịch vụ:
- Mọi nhà phát triển sử dụng Android SDK phiên bản 12.1 trở xuống đều cần nâng cấp lên phiên bản 13.0
- Nhà phát triển sử dụng Sự kiện trong ứng dụng nên thực hiện các bước sau:
- Nếu đang sử dụng phiên bản 12.1 trở xuống – hãy nâng cấp lên phiên bản 13.0
- Nếu đang sử dụng phiên bản 12.2 hoặc 12.3 – hãy thêm yêu cầu quyền cho ID nhà quảng cáo trên Android vào file App Manifest để nhận ID nhà quảng cáo hợp lệ (tìm hiểu thêm tại đây)
- Nếu đang sử dụng phiên bản 13.0 trở lên – không cần làm gì cả, yêu cầu quyền cho ID nhà quảng cáo trên Android đã được bao gồm theo mặc định
- Nhà phát triển không sử dụng Sự kiện trong ứng dụng nên thực hiện các bước sau:
Yêu cầu nhúng Mã ứng dụng vào SDK có hiệu lực:
Kể từ bản phát hành SDK Nền tảng phiên bản 13.0, nhà phát triển giờ đây sẽ phải nhúng Mã ứng dụng vào SDK này cho các lệnh gọi API Đồ thị. Việc thêm Mã ứng dụng vào SDK sẽ hỗ trợ chúng tôi phân tích vấn đề của nền tảng hiệu quả hơn và nâng cao hiệu quả của toàn bộ nền tảng đó. Với việc ra mắt SDK Nền tảng phiên bản 13.0, giờ đây, chúng tôi sẽ sử dụng Mã ứng dụng để xử lý lệnh gọi API Đồ thị khi Mã truy cập hoặc Mã xác thực không khả dụng. Do đó, mọi ứng dụng dùng SDK phiên bản 13.0 trở lên mà không thêm Mã ứng dụng thì sẽ phát sinh ngoại lệ khi khởi chạy SDK này. Nhà phát triển có thể tìm hiểu thêm về cách nhúng Mã ứng dụng của Ứng dụng vào Android SDK tại đây và vào iOS SDK tại đây để tránh mọi tình trạng gián đoạn dịch vụ.
Yêu cầu sử dụng mã byte của Java 8 có hiệu lực:
Theo thông báo của Kotlin, trình biên dịch Kotlin/JVM sẽ mặc định tạo mã byte của Java 8. Từ giờ, chúng tôi sẽ yêu cầu nhà phát triển sử dụng Facebook SDK dành cho Android phải nâng cấp lên mã byte của Java 8 nhằm tránh gặp bất kỳ vấn đề nào trong quá trình biên dịch ứng dụng. Nhà phát triển có thể tìm hiểu thêm về cách nâng cấp lên mã byte của Java 8 tại đây.
SDK Nền tảng phiên bản 12.0 ngừng hoạt động:
Khi phát hành SDK phiên bản 13.0, chúng tôi thông báo rằng SDK phiên bản 12.0 hiện ở trạng thái ngừng hoạt động trong khoảng thời gian 2 năm. Trong khoảng thời gian ngừng hoạt động này, chúng tôi sẽ không cung cấp dịch vụ hỗ trợ bảo trì chính thức nào cho mọi vấn đề phát sinh trên SDK phiên bản 12.0. Khi hết khoảng thời gian ngừng hoạt động 2 năm, SDK phiên bản 12.0 sẽ không còn và không hoạt động nữa. Do SDK phiên bản 12.0 ngừng hoạt động, các nhà phát triển nên bắt đầu chuyển sang SDK phiên bản 13.0 sớm nhất có thể để sử dụng SDK mới nhất và tốt nhất cùng dịch vụ hỗ trợ bảo trì chính thức.
Phiên bản ngừng hoạt động:
Dưới đây là các phiên bản SDK Nền tảng Facebook đã ngừng hoạt động và ngày liên quan:
- 24/02/2022: iOS SDK và Android SDK phiên bản 12 (Đã ngừng hoạt động)
- 21/10/2021: iOS SDK và Android SDK phiên bản 11 (Đã ngừng hoạt động)
- 08/06/2021: iOS SDK, Android SDK và Unity SDK phiên bản 9 (Đã ngừng hoạt động)
- 19/01/2021: iOS SDK, Android SDK và Unity SDK phiên bản 8.2 trở xuống (Đã ngừng hoạt động)
Nhật ký thay đổi:
Hãy truy cập Nhật ký thay đổi của chúng tôi để xem lại các thay đổi cụ thể đối với SDK và cập nhật những điểm cải tiến theo kế hoạch:
