트러블슈팅: 디자인 시스템(SPM) 사용 시 아이콘 및 이미지 로드 이슈



문제 상황
MDSKit
을 SPM(Swift Package Manager)을 통해 프로젝트에 통합한 후, Launch Screen에서 .img_splash_logo
를 사용하여 뷰 작업을 진행했지만, 빌드 시 이미지가 표시되지 않는 문제가 발생했습니다.
Assets
에 직접 이미지를 추가하니 문제가 해결되었습니다.
원인 분석
- SPM의 리소스 번들 처리 방식:
- SPM(Swift Package Manager)은 리소스 파일(이미지, 폰트 등)을
Package.swift
에 명시적으로 포함해야 합니다.
- 패키지 내부 리소스는 번들(bundle)에 저장되며, 이 번들을 올바르게 참조하지 않으면 이미지나 리소스가 로드되지 않는 문제가 발생합니다.
- 이미지 로드 방식의 차이:
Image(.img_splash_logo)
같은 방식은 Assets.xcassets
의 리소스를 기본 번들(main bundle)에서 찾습니다.
- SPM으로 제공된 리소스는 기본 번들에 포함되지 않으므로 해당 이미지가 로드되지 않습니다.
- Launch Screen 제한:
Launch Screen
에서는 SwiftUI 또는 코드 기반 리소스 참조가 불가능합니다. LaunchScreen.storyboard
나 .xib
는 프로젝트 내 Assets
의 리소스만 로드할 수 있습니다.
- 따라서, Launch Screen에서 SPM 리소스를 사용할 수 없고, 프로젝트의
Assets.xcassets
에 이미지를 추가해야 합니다.
트러블 슈팅: System gesture gate timed out 문제 해결
