Chuẩn bị cho chế độ chỉ có thể đọc của CocoaPods: Di chuyển ứng dụng iOS sang Trình quản lý gói Swift

Thứ Sáu, ngày 6 tháng 11 năm 2026

Vào ngày 2 tháng 12 năm 2026, kho lưu trữ CocoaPods Specs sẽ chuyển vĩnh viễn sang chế độ chỉ có thể đọc. Do đó, sau ngày này, chúng tôi sẽ không còn phát hành các phiên bản mới của Google Mobile Ads SDK hoặc bộ chuyển đổi dàn xếp cho iOS lên CocoaPods nữa.

Tác động của thay đổi này đối với ứng dụng iOS của bạn

Nếu bạn hiện đang sử dụng CocoaPods để cài đặt Google Mobile Ads SDK (Google-Mobile-Ads-SDK) hoặc User Messaging Platform SDK (GoogleUserMessagingPlatform), hãy lưu ý những điều sau:

  • Các bản dựng hiện có không bị ảnh hưởng: Tất cả phiên bản đã phát hành trước đó của Google Mobile Ads SDK và bộ chuyển đổi dàn xếp trên CocoaPods sẽ vẫn có trong kho lưu trữ thông số kỹ thuật chỉ có thể đọc.
  • Không có bản cập nhật nào trong tương lai trên CocoaPods: Sau ngày 2 tháng 12 năm 2026, các bản phát hành SDK, tính năng và bản sửa lỗi mới sẽ chỉ được phân phối thông qua Trình quản lý gói Swift và các bản tải xuống thủ công.

Di chuyển sang Trình quản lý gói Swift

Để tiếp tục nhận được các bản cập nhật mới nhất cho Google Mobile Ads SDK, bạn nên di chuyển các dự án iOS sang Trình quản lý gói Swift (SPM). SPM là trình quản lý phần phụ thuộc của bên thứ nhất của Apple, được tích hợp trực tiếp vào Xcode.

Để chuyển dự án sang Trình quản lý gói Swift, hãy làm theo các bước sau:

  1. Nếu bạn xoá hoàn toàn CocoaPods khỏi dự án, hãy chạy pod deintegrate trong thư mục dự án.
  2. Trong Xcode, hãy chuyển đến File > Add Package Dependencies... (Tệp > Thêm phần phụ thuộc của gói...).
  3. Trên thanh tìm kiếm, hãy nhập URL kho lưu trữ GitHub cho Gói Swift quảng cáo trên thiết bị di động của Google: https://github.com/googleads/swift-package-manager-google-mobile-ads.git
  4. Chọn quy tắc phiên bản bạn muốn sử dụng. Bạn nên chọn Up to Next Major Version (Lên phiên bản lớn tiếp theo).
  5. Thêm gói vào mục tiêu của bạn.

Để xem hướng dẫn thiết lập đầy đủ, bao gồm cả cách tải khung xuống theo cách thủ công, hãy xem hướng dẫn Bắt đầu sử dụng cho AdMob và Ad Manager. Nếu sử dụng tính năng dàn xếp, bạn có thể di chuyển các bộ chuyển đổi theo cách tương tự. Bộ chuyển đổi dàn xếp của Google Mobile Ads hỗ trợ Trình quản lý gói Swift và bạn có thể tìm thấy URL gói của từng bộ chuyển đổi trong tài liệu về tính năng dàn xếp của chúng tôi.

Nếu bạn có thắc mắc hoặc muốn thảo luận về bài đăng này, vui lòng liên hệ với chúng tôi trên máy chủ Discord của "Cộng đồng quảng cáo và đo lường của Google".

Nhãn: ad-manager, admob, ios, mobile-ads-sdk, swift, swift-package-manager