2026년 11월 6일 금요일
2026년 12월 2일에 CocoaPods 사양 저장소가 읽기 전용 모드로 영구 전환됩니다. 따라서 이 날짜 이후에는 iOS용 Google 모바일 광고 SDK 또는 미디에이션 어댑터의 새 버전이 CocoaPods에 게시되지 않습니다.
iOS 앱에 미치는 영향
현재 CocoaPods를 사용하여 Google 모바일 광고 SDK(Google-Mobile-Ads-SDK) 또는 사용자 메시지 플랫폼 SDK(GoogleUserMessagingPlatform)를 설치하는 경우 다음 사항에 유의하세요.
- 기존 빌드는 영향을 받지 않음: CocoaPods에 이전에 게시된 모든 버전의 Google 모바일 광고 SDK 및 미디에이션 어댑터는 읽기 전용 사양 저장소에서 계속 사용할 수 있습니다.
- CocoaPods에 대한 향후 업데이트 없음: 2026년 12월 2일 이후에는 새로운 SDK 출시, 기능, 버그 수정이 Swift Package Manager 및 수동 다운로드를 통해서만 배포됩니다.
Swift Package Manager로 이전
최신 Google 모바일 광고 SDK 업데이트를 계속 받으려면 iOS 프로젝트를 Swift Package Manager(SPM)로 이전하는 것이 좋습니다. SPM은 Xcode에 직접 내장된 Apple의 퍼스트 파티 종속 항목 관리자입니다.
프로젝트를 Swift Package Manager로 전환하려면 다음 단계를 따르세요.
- 프로젝트에서 CocoaPods를 완전히 삭제하는 경우 프로젝트 디렉터리에서
pod deintegrate를 실행합니다. - Xcode에서 File(파일) > Add Package Dependencies(패키지 종속 항목 추가)…로 이동합니다.
- 검색창에 Google 모바일 광고 Swift 패키지 GitHub 저장소 URL(https://github.com/googleads/swift-package-manager-google-mobile-ads.git)을 입력합니다.
- 사용할 버전 규칙을 선택합니다. Up to Next Major Version(최대 다음 메이저 버전)을 사용하는 것이 좋습니다.
- 타겟에 패키지를 추가합니다.
프레임워크를 수동으로 다운로드하는 방법을 포함한 전체 설정 안내는 AdMob 및 Ad Manager의 시작 가이드를 참고하세요. 미디에이션을 사용하는 경우 동일한 방식으로 어댑터를 이전할 수 있습니다. Google 모바일 광고 미디에이션 어댑터는 Swift Package Manager를 지원하며, 각 어댑터의 패키지 URL은 미디에이션 문서에서 확인할 수 있습니다.
궁금한 점이 있거나 이 게시물에 관해 논의하고 싶다면 'Google Advertising and Measurement Community' Discord 서버를 통해 문의해 주세요.
라벨: ad-manager, admob, ios, mobile-ads-sdk, swift, swift-package-manager