iOS/macOS 앱 개발 도우미
XcodeGen·SwiftUI·SPM 기반 iOS/macOS 앱 빌드부터 코드사이닝·공증·CI/CD까지 막히는 지점을 짚어주는 실전 스킬입니다.
개발·코딩고급★ 1,323⑂ 212AI 점수 9/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
project.yml(XcodeGen) 최소 설정 템플릿과 타깃별 서명 설정 방법을 제시합니다.- "Library not loaded: @rpath/..." 같은 SPM 동적 프레임워크 임베드 누락 문제의 근본 원인과 해결 절차를 안내합니다.
- iOS 17 전용 API(
@Observable,ContentUnavailableView, 새onChange)를 iOS 16 호환 코드로 낮추는 변환 예시를 제공합니다. - 실기기 배포, 무료 Apple ID vs 유료 계정($99/년) 차이, DerivedData 정리 등 자주 겪는 오류를 표로 정리했습니다.
- macOS/Electron 앱 배포용 Developer ID 인증서 발급 → P12 내보내기 → App Store Connect API Key → GitHub Secrets 5개 구성까지 5단계 체크리스트를 담았습니다.
- 카메라(AVFoundation) 미리보기 검은 화면, 전면 카메라 미러링 크래시,
UIViewRepresentable크기 0 문제 해결법을 포함합니다.
이런 분께 추천
- Xcode 프로젝트 파일 충돌을 피하려고 XcodeGen을 쓰는 iOS 개발자
- Realm 등 동적 프레임워크를 SPM으로 붙였다가 실행 직후 크래시를 만난 분
- macOS 앱(특히 Electron)을 앱스토어 외부로 배포하며 공증(notarization) 오류에 막힌 분
- GitHub Actions에서 서명이 조용히 adhoc으로 떨어지는 문제를 겪는 CI 담당자
활용 예시
- "실기기에서 앱이 실행 즉시 dyld 오류로 죽어요" → 동적 프레임워크를 Xcode GUI에서 'Embed & Sign'으로 바꾸고 GUI에서 한 번 빌드하면 이후
xcodebuild도 정상 동작함을 안내. - "iOS 16 기기를 지원해야 합니다" → deploymentTarget을 16.0으로 내리고
.onChange,ContentUnavailableView등을 호환 코드로 치환한 뒤xcodegen generate재실행. - "공증에서 'Cannot use password credentials, API key credentials...' 오류" →
@electron/notarize에 넘긴teamId를 제거하고 API Key만 사용하도록 수정.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 iOS-APP-developer 폴더를 내 ~/.claude/skills/developing-ios-apps/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/iOS-APP-developer ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- macOS에서 터미널을 엽니다. (이 스킬은 Xcode가 필요한 macOS 전용 주제입니다.)
- 스킬 저장소를 내려받습니다:
git clone https://github.com/daymade/claude-code-skills.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r claude-code-skills/iOS-APP-developer ~/.claude/skills/ ls ~/.claude/skills/iOS-APP-developer로SKILL.md와references/폴더가 있는지 확인합니다.- Claude Code를 재시작한 뒤 "XcodeGen 프로젝트 빌드가 실패해" 또는 "macOS 앱 공증 설정해줘"처럼 물어보면 스킬이 자동으로 활성화됩니다.
- 추가 준비물: Xcode 최신 버전,
brew install xcodegen, 그리고 CLI 빌드·배포가 필요하면 유료 Apple Developer 계정.
GitHub에서 원본 보기 ↗라이선스: MIT