🔀 :: [#170] ControlCenter 위젯 추가

[baekteun]

💡 개요

ControlCenter 위젯 추가

📃 작업내용

• Meal ControlCenter 위젯 추가
• TimeTable ControlCenter 위젯 추가

Custom 이미지를 노출하기로 하였으나 symbolset를 지원해야하기때문에 우선은 기본 SF Symbol로 설정하여

Summary by CodeRabbit

릴리즈 노트

• 새로운 기능

  • iOS 18.0 이상에서 작동하는 새로운 위젯 추가 (식사 및 시간표 컨트롤 위젯)
  • 앱 열기 의도(Intent) 기능 구현

• 의존성 업데이트

  • GRDB.swift 라이브러리 버전 6.24.2에서 6.29.3으로 업그레이드

• 기타 변경사항

  • 프로젝트 스크립트 및 구성 파일 최적화
  • 새로운 에셋 및 리소스 추가

[github-actions]

✅ PR의 Assign 자동 지정을 성공했어요!

@baekteun

[github-actions]

✅ 이슈와 PR의 Labels 동기화를 성공했어요!

[coderabbitai]

@baekteun 안녕하세요! pr의 변경 사항을 검토하도록 하겠습니다. controlcenter 위젯 추가에 대한 리뷰를 진행하겠습니다.

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[coderabbitai]

워크스루

이 풀 리퀘스트는 여러 파일에 걸쳐 프로젝트 구성과 의존성을 업데이트합니다. 주요 변경 사항은 GRDB.swift 패키지 버전 업그레이드, 새로운 iOS 위젯 추가, 빌드 스크립트 및 환경 설정 조정을 포함합니다. 이러한 변경은 앱의 기능성과 빌드 프로세스를 개선하는 데 초점을 맞추고 있습니다.

변경 사항

파일	변경 요약
.gitignore	GoogleService-QA-Info.plist 추가
Package.resolved	grdb.swift 의존성 버전 6.26.0에서 6.29.3으로 업데이트
Package.swift	GRDB.swift 패키지 버전 6.24.2에서 6.29.3으로 업데이트
Projects/App/Intents/...	새로운 TodayWhatAppOpenIntent 및 TodayWhatAppOpenControlAppEnum 추가
Projects/App/Project.swift	스크립트 및 소스 경로 업데이트
iOS-Widget/Resources/...	새로운 MealControlCenter.imageset 추가
iOS-Widget/Sources/...	새로운 MealControlWidget, TimeTableControlWidget 추가

시퀀스 다이어그램

sequenceDiagram
    participant User
    participant Widget
    participant App
    User->>Widget: 위젯 버튼 탭
    Widget->>App: TodayWhatAppOpenIntent 실행
    App->>User: 앱 열기 및 특정 화면 표시

Loading

시

🍚 위젯의 마법, 토끼의 노래 🕰️

새로운 기능이 춤을 추네
GRDB와 위젯이 손을 잡고
앱은 더욱 스마트하게 자라나
코드의 토끼, 기쁨을 노래해!

---

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

• Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  • I pushed a fix in commit <commit_id>, please review it.
  • Generate unit testing code for this file.
  • Open a follow-up GitHub issue for this discussion.
• Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
  • @coderabbitai generate unit testing code for this file.
  • @coderabbitai modularize this function.
• PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
  • @coderabbitai read src/utils.ts and generate unit testing code.
  • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
  • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

• @coderabbitai pause to pause the reviews on a PR.
• @coderabbitai resume to resume the paused reviews.
• @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
• @coderabbitai full review to do a full review from scratch and review all the files again.
• @coderabbitai summary to regenerate the summary of the PR.
• @coderabbitai generate docstrings to generate docstrings for this PR. (Beta)
• @coderabbitai resolve resolve all the CodeRabbit review comments.
• @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
• @coderabbitai help to get help.

Other keywords and placeholders

• Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
• Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
• Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

• You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
• Please see the configuration documentation for more information.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

• Visit our Documentation for detailed information on how to use CodeRabbit.
• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (6)

Projects/App/iOS-Widget/Sources/TimeTableControlWidget/TimeTableControlWidget.swift (1)

13-19: 사용자 경험 개선을 위한 제안

현재 구현은 기능적으로 문제가 없으나, 다음과 같은 개선사항을 고려해보시기 바랍니다:

1. 접근성 레이블 추가
2. 버튼 상호작용 시 햅틱 피드백 제공

 ControlWidgetButton(action: TodayWhatAppOpenIntent()) {
     Label {
         Text("시간표")
+        .accessibilityLabel("시간표 보기")
     } icon: {
         Image(systemName: "clock.fill")
+        .accessibilityHidden(true)
     }
 }

Projects/App/Intents/TodayWhatAppOpenIntent.swift (2)

3-16: 앱 내비게이션 인텐트 구현이 적절합니다.

인텐트 구현이 잘 되어있으나, 다음 개선사항을 고려해보시기 바랍니다:

1. 성공/실패 시나리오에 대한 오류 처리 추가
2. 수행 결과에 대한 사용자 피드백 제공

 func perform() async throws -> some IntentResult {
+    do {
+        // 앱 실행 로직
         return .result()
+    } catch {
+        return .result(
+            value: false,
+            error: "앱을 실행할 수 없습니다. 다시 시도해주세요."
+        )
+    }
 }

---

18-27: 내비게이션 대상 확장 고려

현재는 홈 화면만 지원하고 있습니다. 추후 다음과 같은 화면들도 지원하는 것을 고려해보세요:

• 급식 화면
• 시간표 화면

Tuist/ProjectDescriptionHelpers/GenerateEnvironment.swift (1)

15-26: iOS와 macOS 스크립트 분리가 잘 되었습니다.

플랫폼별 스크립트 분리를 통해 유지보수성이 향상되었습니다. 다만 다음 사항을 고려해보세요:

1. 중복된 스크립트 설정을 상수로 분리
2. 각 환경별 스크립트 구성에 대한 문서화 추가

+/// 공통으로 사용되는 스크립트 설정
+private extension GenerateEnvironment {
+    static let commonDevScripts: [TargetScript] = [
+        .swiftLint,
+        .firebaseCrashlytics
+    ]
+}

Also applies to: 28-38

Projects/App/iOS-Widget/Sources/MealControlWidget/MealControlWidget.swift (1)

34-38: 시간 계산 로직 개선을 제안드립니다.

현재 시간 계산이 Date()를 직접 사용하고 있는데, 테스트 용이성과 시간대 처리를 위해 의존성 주입을 고려해보시는 것은 어떨까요?

 struct MealControlValueProvider: ControlValueProvider {
+    private let calendar: Calendar
+    
+    init(calendar: Calendar = .current) {
+        self.calendar = calendar
+    }
+
     func currentValue() async throws -> Value {
-        let today = Date()
+        let today = calendar.currentDate
         let partTime = MealPartTime(hour: today)
         return .init(partTime: partTime)
     }
 }

Tuist/ProjectDescriptionHelpers/Action/Action+Template.swift (1)

Line range hint 41-52: 스크립트 에러 처리 개선을 제안드립니다.

파일이 존재하지 않는 경우에 대한 에러 처리가 추가되면 좋을 것 같습니다.

 script: """
+    if [ ! -f "$SRCROOT/macOS/Resources/GoogleService-Info.plist" ]; then
+        echo "Error: Firebase configuration file not found"
+        exit 1
+    fi
+
     case "${CONFIGURATION}" in

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 63b67f9 and 0552b71.

⛔ Files ignored due to path filters (1)

• Projects/App/iOS-Widget/Resources/Assets.xcassets/MealControlCenter.imageset/rice_control_center.svg is excluded by !**/*.svg

📒 Files selected for processing (13)

• .gitignore (1 hunks)
• Package.resolved (1 hunks)
• Package.swift (1 hunks)
• Projects/App/Intents/TodayWhatAppOpenIntent.swift (1 hunks)
• Projects/App/Project.swift (4 hunks)
• Projects/App/iOS-Widget/Resources/Assets.xcassets/MealControlCenter.imageset/Contents.json (1 hunks)
• Projects/App/iOS-Widget/Sources/MealControlWidget/MealControlWidget.swift (1 hunks)
• Projects/App/iOS-Widget/Sources/TimeTableControlWidget/TimeTableControlWidget.swift (1 hunks)
• Projects/App/iOS-Widget/Sources/TodayWhatWidget.swift (1 hunks)
• Tuist/ProjectDescriptionHelpers/Action/Action+Template.swift (1 hunks)
• Tuist/ProjectDescriptionHelpers/GenerateEnvironment.swift (1 hunks)
• Tuist/ProjectDescriptionHelpers/Project/Project+makeModule.swift (1 hunks)
• Tuist/ProjectDescriptionHelpers/Target/TargetSpec.swift (1 hunks)

✅ Files skipped from review due to trivial changes (1)

• Projects/App/iOS-Widget/Resources/Assets.xcassets/MealControlCenter.imageset/Contents.json

🔇 Additional comments (13)

Package.swift (1)

27-27: GRDB.swift 버전 업데이트 검증 필요

GRDB.swift 버전이 6.24.2에서 6.29.3으로 업데이트되었습니다. 마이너 버전 업데이트이지만 호환성 검증이 필요합니다.

다음 스크립트를 실행하여 GRDB.swift의 변경 사항을 확인하세요:

✅ Verification successful

GRDB.swift 버전 업데이트 검증 완료

6.24.2에서 6.29.3으로의 업데이트는 안전합니다. 주요 변경사항:

• 메모리 관리 개선
• 디코딩 버그 수정
• 새로운 기능 추가 (단일 값 인코딩/디코딩)
• 성능 및 안정성 개선

호환성 문제나 주요 변경사항이 없으므로 업데이트를 진행해도 좋습니다.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: GRDB.swift 버전 6.24.2에서 6.29.3 사이의 주요 변경 사항 확인

# GitHub API를 통해 릴리스 노트 확인
gh api \
  -H "Accept: application/vnd.github+json" \
  repos/groue/GRDB.swift/releases \
  --jq '.[] | select(.tag_name | startswith("v6.")) | select(.tag_name >= "v6.24.2" and .tag_name <= "v6.29.3") | {version: .tag_name, body: .body}'

Length of output: 6588

Package.resolved (1)

71-72: 버전 일관성 확인 완료

Package.swift와 Package.resolved 파일에서 GRDB.swift 버전이 일관되게 6.29.3으로 업데이트되었습니다.

Projects/App/iOS-Widget/Sources/TimeTableControlWidget/TimeTableControlWidget.swift (1)

5-8: iOS 18.0 이상 요구사항 명시가 적절합니다.

가용성 체크를 통해 iOS 18.0 이상에서만 위젯이 동작하도록 제한한 것이 적절합니다.

Projects/App/iOS-Widget/Sources/TodayWhatWidget.swift (1)

18-21: 새로운 컨트롤 위젯 추가가 적절합니다.

iOS 18.0 이상에서만 사용 가능한 새로운 컨트롤 위젯들이 올바르게 조건부로 추가되었습니다.

Projects/App/iOS-Widget/Sources/MealControlWidget/MealControlWidget.swift (1)

5-23: 잘 구현된 위젯 구조입니다!

SwiftUI와 WidgetKit을 활용한 깔끔한 구현이 돋보입니다. iOS 18.0 이상 체크도 적절히 되어있습니다.

Tuist/ProjectDescriptionHelpers/Action/Action+Template.swift (1)

25-39: iOS와 macOS 설정 분리가 잘 되었습니다!

플랫폼별 Firebase 설정 분리가 깔끔하게 구현되었습니다.

Tuist/ProjectDescriptionHelpers/Target/TargetSpec.swift (1)

42-42: 기본 SwiftLint 설정이 적절합니다.

모든 타겟에 SwiftLint를 기본으로 적용하는 것은 코드 품질 유지에 좋은 접근입니다.

Tuist/ProjectDescriptionHelpers/Project/Project+makeModule.swift (1)

36-36: 일관된 스크립트 설정이 잘 되었습니다.

TargetSpec의 변경사항과 일관되게 SwiftLint 스크립트 설정이 적용되었습니다.

Projects/App/Project.swift (4)

34-34: 인텐트 소스 추가 승인

Control Center 위젯 기능 구현을 위한 Intents 디렉토리 추가가 적절히 이루어졌습니다.

---

54-54: 위젯 인텐트 소스 추가 승인

위젯 타겟에도 Intents 디렉토리가 추가되어 메인 타겟과 일관성이 유지되었습니다.

---

104-104: macOS 전용 스크립트 구성 승인

macOS 환경에 특화된 스크립트 설정으로 변경되어 플랫폼별 처리가 개선되었습니다.

---

24-24: 스크립트 구성 변경 검증 필요

스크립트가 SwiftLint로만 제한되었습니다. 이전에 포함되어 있던 다른 스크립트들이 제거되어도 문제가 없는지 확인이 필요합니다.

✅ Verification successful

스크립트 구성이 올바르게 설정되었습니다

코드베이스 분석 결과, .swiftLint 스크립트만 포함하는 현재 구성이 기본 설정과 일치하며 안전합니다. 다른 스크립트들(Firebase Crashlytics, Launch At Login 등)은 필요한 경우 환경 설정이나 플랫폼에 따라 별도로 추가되도록 구현되어 있습니다.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: 이전 스크립트 구성 확인
git log -p --full-history -- Projects/App/Project.swift | grep -A 5 "let scripts"

Length of output: 0

---

Script:

#!/bin/bash
# Find TargetScript enum definition and usages
ast-grep --pattern 'enum TargetScript'
rg -A 5 'TargetScript' --type swift

Length of output: 6463

.gitignore (1)

13-13: QA 환경 설정 파일 무시 설정 승인

QA 환경의 Google 서비스 설정 파일이 적절히 .gitignore에 추가되었습니다. 민감한 설정 파일을 버전 관리에서 제외하는 것은 보안상 올바른 접근입니다.