iOS 26+向けの感情 몰입형 모닝콜 알람 앱입니다. SwiftUI + TCA(The Composable Architecture) + AlarmKit で実装されています。
- 알람 CRUD: 시간, 반복 요일, 라벨, 캐릭터 지정
- 캐릭터 시스템: 3가지 기본 캐릭터 (優しい/ツンデレ/クール)
- 링잉 경험: 캐릭터 이미지 + 랜덤 보이스 + 슬라이드 해제
- 스누즈 기능: 설정 가능한 간격과 최대 횟수
- 심층 링크:
utototo://ringing?alarmId=...지원 - 로컬 저장: JSON + FileManager (향후 CoreData 확장 가능)
- 언어: Swift 5.9+
- UI: SwiftUI
- 아키텍처: TCA (The Composable Architecture)
- 플랫폼: iOS 26.1+
- 저장소: FileManager (Documents 디렉토리)
- 알람: AlarmKit (iOS 26)
- 오디오: AVFoundation
Utouto/
├── Package.swift # Swift Package Manager 설정
├── Sources/Utouto/
│ ├── Models/
│ │ └── Models.swift # 데이터 모델 (Alarm, Settings, Character)
│ ├── Clients/
│ │ └── Clients.swift # TCA 클라이언트 (Repository, Notification, Audio 등)
│ ├── Features/
│ │ ├── App/
│ │ │ └── AppFeature.swift # 메인 앱 피처 (TCA Reducer)
│ │ ├── Onboarding/
│ │ │ └── OnboardingFeature.swift # 온보딩 피처
│ │ ├── AlarmList/
│ │ │ └── AlarmListFeature.swift # 알람 목록 피처
│ │ ├── AlarmEdit/
│ │ │ └── AlarmEditFeature.swift # 알람 편집 피처
│ │ ├── CharacterSelect/
│ │ │ └── CharacterSelectFeature.swift # 캐릭터 선택 피처
│ │ ├── Ringing/
│ │ │ └── RingingFeature.swift # 링잉 경험 피처
│ │ └── Settings/
│ │ └── SettingsFeature.swift # 설정 피처
│ ├── Resources/
│ │ └── Assets.xcassets/ # 앱 에셋
│ ├── Info.plist # 앱 설정 (URL scheme 등)
│ └── utoutoApp.swift # 앱 엔트리 포인트
├── Tests/UtoutoTests/
│ └── Tests.swift # 단위 테스트
├── utouto.xcodeproj/ # Xcode 프로젝트
└── README.md # 프로젝트 설명
Swift Package 매크로(ComposableArchitecture 등)에서 "Compiled module was created by a different version of the compiler" 또는 "Unable to find module dependency: 'SwiftDiagnostics'" 오류가 나면:
- Xcode를 종료한다.
- 터미널에서 아래 스크립트를 실행해 prebuilts를 끄고 캐시를 지운다:
(또는 수동:
chmod +x Scripts/fix-macro-build.sh ./Scripts/fix-macro-build.sh
defaults write com.apple.dt.Xcode IDEPackageEnablePrebuilts NO후
rm -rf ~/Library/Developer/Xcode/DerivedData/Utouto-*실행) - Xcode를 다시 열고 File → Packages → Reset Package Caches, 그다음 Resolve Package Versions를 실행한다.
- Product → Clean Build Folder 후 다시 빌드한다.
Prebuilts를 끄면 swift-syntax가 현재 컴파일러로 소스에서 다시 빌드되어 버전 불일치가 사라진다.
프로젝트는 Swift Package Manager를 사용하여 TCA를 의존성으로 포함합니다.
# Xcode에서 자동으로 의존성이 해결됩니다
# 또는 수동으로:
cd /path/to/utouto
swift package resolveopen utouto.xcodeproj- 타겟: iOS 26.1+
- 시뮬레이터 또는 실제 기기에서 실행
- 중요: 실제 기기에서 테스트하려면 개발자 계정과 프로비저닝이 필요합니다
"Signing for Utouto requires a development team" 오류가 나면:
- Xcode에서: 프로젝트 선택 → Utouto 타겟 → Signing & Capabilities → Team에서 본인 개발자 팀 선택.
- Tuist 사용 시:
Project.swift의DEVELOPMENT_TEAM에 팀 ID(10자리)를 넣고tuist generate로 프로젝트를 다시 생성한다."DEVELOPMENT_TEAM": "XXXXXXXXXX", // Apple Developer에서 확인
tuist generate 후 "Unknown Name" / "No Account for Team" 이 뜨는 경우
Tuist가 프로젝트를 새로 만들면 Xcode가 팀 ID만 보고 계정과 매칭하지 못할 수 있다. Xcode → Settings → Accounts 에서 Apple ID 확인 후, 프로젝트를 닫았다가 다시 열어보자. 그래도 안 되면 Signing & Capabilities에서 Team을 한 번 더 선택해 주면 된다 (다음 tuist generate 시 다시 선택해야 할 수 있음).
Info.plist에 다음이 포함되어 있어야 합니다:
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleURLSchemes</key>
<array>
<string>utototo</string>
</array>
</dict>
</array>Safari에서 다음 URL을 열어 테스트:
utototo://ringing?alarmId=YOUR_ALARM_UUID
예시:
utototo://ringing?alarmId=12345678-1234-1234-1234-123456789ABC
- 앱 최초 실행 시 온보딩 화면에서 권한 요청
- 설정 > 개인정보 보호 > 알림에서 권한 확인 가능
- 알람 생성 및 활성화
- 앱을 백그라운드로 전환
- 알람 시간까지 대기 또는 시뮬레이터에서 시간 변경
- 알림 탭 시 링잉 화면으로 이동
- 캐릭터 이미지:
character_gentle.png,character_tsundere.png,character_cool.png - 보이스 클립:
wake_gentle_1.mp3,snooze_gentle_1.mp3등 - 기본 효과음:
wake_default.mp3,snooze_default.mp3
- 진동 피드백 (현재는 설정만 존재)
- LongPress 해제 모드 (현재는 Slide만 지원)
- 알람 로그 UI
- CoreData 마이그레이션
- 다크 모드 최적화
- 접근성 (VoiceOver) 지원
# Xcode에서 Test 실행
# 또는 커맨드 라인:
xcodebuild test -project utouto.xcodeproj -scheme utouto현재 구현된 테스트:
- 알람 생성 및 저장
- 알람 토글 시 알림 스케줄링
- 링잉 화면에서 스누즈 시 오디오 정지
이 프로젝트는 학습 목적으로 만들어졌습니다. 실제 배포 시 적절한 라이선스를 적용하세요.
- TCA를 사용하여 테스트 가능하고 모듈화된 아키텍처 구현
- 모든 비즈니스 로직은 Reducer에서 순수 함수로 구현
- Effect를 통해 외부 의존성 처리
- 오프라인-first 설계로 네트워크 의존성 제거