공지사항
AdFit SDK 연동 방식 변경 안내 (CocoaPods 지원 중단)
2025.04.15 13:36안녕하세요, 애드핏 담당자입니다.
AdFit SDK의 연동 방식이 2024년 3월 5일 배포된 v3.18.6 버전부터 변경되었기에 안내드립니다.
해당 변경 사항은 2023년 11월 사전 공지를 통해 예고되었습니다.
이번 변경은 SDK 연동 구조에 직접적인 영향을 줄 수 있는 사안으로, 현재 CocoaPods로 연동 중인 파트너사께서는 이후 대응을 위해 본 공지를 꼭 확인해주시기 바랍니다.
1. 변경 사항
- CocoaPods 지원 중단 및 SPM(Swift Package Manager) 방식 전환
- AdFit SDK는 2024년 3월 5일 릴리즈된 v3.18.6 버전부터 CocoaPods 지원을 공식 종료, SPM(Swift Package Manager)을 통한 연동 방식만을 지원
2. 적용 일정
- CocoaPods 지원 종료 사전 공지일: 2024년 11월
- SPM 전환 적용 버전: SDK v3.18.6 (2024년 3월 5일 릴리즈)
해당 버전부터는 SPM을 통해서만 SDK 제공하며, CocoaPods 기반으로는 더 이상 최신 SDK 사용 불가합니다.
3. CocoaPods 지원 중단 배경
- CocoaPods의 유지보수 모드 전환 (참고 링크)
2024년 8월, CocoaPods는 공식 블로그를 통해 유지보수 모드에 들어갔음을 발표했습니다.
이에 따라 새로운 기능 개발은 중단되었고 보안 패치 및 호환성 업데이트만이 제공될 예정입니다.
- Trunk 저장소의 읽기 전용 전환 계획 (참고 링크)
CocoaPods는 2026년 12월 2일부터 Trunk 저장소를 읽기 전용으로 전환할 예정입니다.
이후에는 새로운 Pod 추가나 기존 Pod 업데이트가 불가능해집니다.
- Xcode 업데이트에 따른 지속적인 호환성 문제 (참고 링크)
최근 Xcode 16.1 등 최신 버전에서 CocoaPods 사용 시 ‘object version’ 관련 오류와 같은 다양한 호환성 문제가 다수 보고되고 있습니다.
- Swift Package Manager(SPM)의 업계 표준화 (참고 링크)
Apple은 SPM을 공식 패키지 매니저로 채택하고 있으며, 현재 iOS 생태계 전반에서 SPM 도입이 빠르게 확산되고 있습니다.
이에 발맞춰 AdFit 또한 연동 방식을 SPM 중심으로 개편하게 되었습니다.
4. 기존 CocoaPods 사용자의 선택지
CocoaPods 연동이 꼭 필요한 경우, v3.18.3 버전까지는 기존 방식으로 사용 가능합니다.
v3.18.3과 v3.18.6의 주요 차이는 iOS 타겟 버전(iOS 15 이상 권장)입니다.
새로운 기능이 필요하지 않은 경우, v3.18.3을 유지하셔도 무방합니다.
단, 이후 모든 신규 기능 추가 및 버그 수정은 SPM 기반 버전에만 반영될 예정입니다.
5. 향후 권장 사항
앞으로의 안정적인 SDK 연동과 유지 관리를 위해, Swift Package Manager(SPM)를 통한 연동 전환을 권장드립니다.
SPM 연동 가이드는 공식 문서 및 개발자 페이지를 통해 제공해드리고 있으며,필요 시 AdFit 기술지원팀을 통해 도움을 받으실 수 있습니다.
더 나은 개발 환경과 성능 향상을 위한 변화이오니 양해 부탁드립니다.
감사합니다.