프로젝트 소개

• Apple의 Screen Time(스크린 타임)을 활용해 보는 데에 도움을 주는 Bare-bones 프로젝트입니다.
• FamilyControls, DeviceActivity, ManagedSettings 3개의 프레임워크를 활용하여 기본적인 Screen Time 기능을 구현해 봅니다.
• 사용을 제한할 앱과 원하는 시간대를 선택하면 제한을 적용해주는 앱을 구현합니다.

Screen Time이란?

앱과 웹사이트를 얼마나 자주 사용하는지 추적하고, 사용을 제한하도록 하여 휴대폰 사용을 관리할 수 있도록 해주는 Apple의 서비스입니다.

사용량 추적과 사용 제한의 대상은 사용자 개인이 될 수도 있고, iCloud에 연동되어 있는 자녀가 될 수도 있습니다.

FamilyControls, DeviceActivity, ManagedSettings 3가지의 프레임워크를 같이 활용하여 Screen Time 관련 기능을 개발할 수 있습니다.

• FamilyControls : ManagedSettings와 DeviceActivity에 대한 접근을 허용해주며 스크린 타임 기능을 사용할 수 있도록 해주는 프레임워크
• DeviceActivity : 앱에서 직접적인 실행을 따로 하지 않아도 사용량을 모니터링 하며, 원하는 시점에 제한 관련 동작을 수행할 수 있도록 해주는 프레임워크
• ManagedSettings : 실질적으로 앱 사용 제한을 수행해주는 프레임워크

프로젝트 구조

.
├── ScreenTime_Barebones // 프로젝트의 메인 타겟입니다.
│   ├── App
│   │   ├── ContentView.swift
│   │   ├── ScreenTime_BarebonesApp.swift
│   │   └── XCConfig
│   │       └── shared.xcconfig
│   ├── Assets.xcassets
│   │   ├── AccentColor.colorset
│   │   │   └── Contents.json
│   │   ├── AppIcon.appiconset
│   │   │   ├── AppIcon_box.png
│   │   │   └── Contents.json
│   │   ├── AppSymbol.imageset
│   │   │   ├── AppIcon.png
│   │   │   └── Contents.json
│   │   └── Contents.json
│   ├── Extension
│   │   ├── Bundle+Extension.swift
│   │   └── Color+Extension.swift
│   ├── Presentation
│   │   ├── ViewModels
│   │   │   ├── Components
│   │   │   │   └── MainTabVM.swift
│   │   │   ├── PermissionVM.swift
│   │   │   └── ScheduleVM.swift // 스크린타임을 통해 사용시간을 트래킹하는 스케쥴을 관리하기 위한 ViewModel
│   │   └── Views
│   │       ├── Components
│   │       │   └── MainTabView.swift
│   │       ├── MonitoringView
│   │       │   └── MonitoringView.swift
│   │       ├── PermissionView
│   │       │   └── PermissionView.swift
│   │       └── ScheduleView
│   │           └── ScheduleView.swift
│   ├── Preview Content
│   │   └── Preview Assets.xcassets
│   │       └── Contents.json
│   ├── ScreenTime_Barebones.entitlements
│   └── Utils
│       ├── DeviceActivtyManager.swift
│       └── FamilyControlsManager.swift
├── DeviceActivityMonitor // 생성한 스크린타임 스케쥴에 기반한 이벤트 발생 시 호출되는 메서드를 관리하기 위한 타겟
│   ├── DeviceActivityMonitor.entitlements
│   ├── DeviceActivityMonitorExtension.swift
│   └── Info.plist
├── ScreenTimeReport // 스크린타임을 통해 사용내역을 조회하고 관리하기 위한 타겟
│   ├── Info.plist
│   ├── ScreenTimeActivityReport.swift
│   ├── ScreenTimeReport.entitlements
│   ├── ScreenTimeReport.swift
│   ├── TotalActivityReport.swift
│   └── TotalActivityView.swift
├── ShieldAction // 스크린타임을 통해 앱 사용이 제한된 화면에서의 이벤트 발생 시 호출되는 메서드를 관리하기 위한 타겟
│   ├── Info.plist
│   ├── ShieldAction.entitlements
│   └── ShieldActionExtension.swift
└── ShieldConfiguration // 스크린타임을 통해 앱 사용이 제한된 화면을 커스텀할 수 있게 도와주는 타겟
    ├── AppSymbol.png
    ├── Info.plist
    ├── ShieldConfiguration.entitlements
    └── ShieldConfigurationExtension.swift

핵심 코드

✅ 스크린타임 사용권한 요청하기

• 스크린타임 API는 사용자가 직접 권한 설정을 완료한 이후부터 사용가능합니다.

// ./ScreenTime_Barebones/Utils/FamilyControlsManager.swift

import FamilyControls

class FamilyControlsManager: ObservableObject {
	// MARK: - FamilyControls 권한 상태를 관리하는 객체
    let authorizationCenter = AuthorizationCenter.shared

    // MARK: - ScreenTime 권한 상태를 활용하기 위한 멤버 변수
    @Published var hasScreenTimePermission: Bool = false

	@MainActor
    func requestAuthorization() {
        if authorizationCenter.authorizationStatus == .approved {
            print("ScreenTime Permission approved")
        } else {
            Task {
                do {
                    try await authorizationCenter.requestAuthorization(for: .individual)
                    hasScreenTimePermission = true
                    // 동의함
                } catch {
                    // 동의 X
                    print("Failed to enroll Aniyah with error: \\\\(error)")
                    hasScreenTimePermission = false
                    // 사용자가 허용안함.
                    // Error Domain=FamilyControls.FamilyControlsError Code=5 "(null)
                }
            }
        }
    }
}