ram2 🚗

지난 글에 이어 이번에는 DeviceActivity를 어떻게 구현하는지에 대한 글이다.

다음 공식 문서를 참고하였다 !

https://developer.apple.com/documentation/DeviceActivity

이번 글은 내가 진행 중인 프로젝트에서 상당히 중요한 주기능에 꼭 필요한 framework이므로, 차근차근 따라하면서 해보려고 한다.

그 전에, 이 framework는 앱 확장 기능을 사용해 사용자의 프라이버시를 유지하면서, 기기 활동을 모니터링 한다.

이전 글과 조금 겹치는 부분이 없잖아 있지만,

1. 특정 시간동안 활동을 모니터링 할 수 있다.

2. 활동이 미리 설정된 한계에 도달할 때 경고를 줄 수 있다.

3. 앱과 웹사이트에서 사용된 시간을 모니터링 한다.

이제 각각의 Topic을 하나씩 다뤄보자 !

Manage Activities

• struct DeviceActivityEvent
  • 애플리케이션, 카테고리 또는 웹사이트 활동을 나타내는 이벤트
• struct DeviceActivityName
  • 활동의 고유한 이름을 나타낸다.
• struct DeviceActivitySchedule
  • 기기 활동을 모니터링할 때의 일정 기반 스케줄을 나타낸다.
• struct DeviceActivityCenter
  • 애플리케이션의 확장이 일정에 따라 기기 활동 모니터링을 시작할 수 있도록 하는 클래스

Monitor Activity

• class DeviceActivityMonitor
  • 일정에 따라 기기 활동을 모니터링하는 객체

Errors

• enum MonitoringError
  • 활동 모니터링을 시작할 때 발생할 수 있는 오류들을 나열하는 열거형

Classes

• class DeviceActivityAuthorization
  • 기기 활동 모니터링을 위한 권한 부여를 처리하는 클래스이다.

Protocols

• protocol DeviceActivityAuthorizing
  • 기기 활동 모니터링에 대한 권한 부여를 정의하는 프로토콜이다.
• protocol DeviceActivityReportExtension
  • 기기 활동 데이터를 보고하는 앱 extension이다.
• protocol DeviceActivityReportScene
  • 사용자 정의 기기 활동 report scene을 정의하는 프로토콜이다.

Structures

• struct DeviceActivityData
  • 특정 DeviceActivityData.Device에서 DeviceActivityData.User의 활동을 나타낸다.
• struct DeviceActivityFilter
  • 보고서에 포함할 기기 활동 데이터를 필터링하는 타입.
• struct DeviceActivityReport
  • 사용자의 애플리케이션, 카테고리 및 웹 도메인 활동을 프라이버시를 보호하는 방식으로 보고하는 view이다.
• struct DeviceActivityReportBuilder
  • 하나 이상의 DeviceActivityReportScenes을 결합하여 단일 장면을 생성하는 결과 빌더.
• struct DeviceActivityResults
  • 필터링된 기기 활동 결과의 비동기 sequence.

프로젝트에 반영하기

이제 xcode에 프로젝트를 파고, 해당 api를 사용해보는 과정을 정리하려 한다.

먼저, 관련된 extension을 설치해준다.

타깃에서 하단의 + 버튼을 눌러 add target을 해준다.

그럼, 다음과 같은 팝업이 뜨는데, 이 때 DeviceActivity Monitor Extension과 Device Activity Report Extension을 각각 추가해주면 된다.

이렇게 두 개의 extension을 모두 추가했다면, 이렇게 xcode에 추가된 것을 확인할 수 있다.

이제 extension을 추가하였으면, 나와 같은 경우, 대부분의 코드를 UIKit으로 짤 예정이기에 SwiftUI 기반의 api와 UIKit을 서로 연결해주어야 한다.

즉, 두 개의 framework를 혼용해서 쓸 수 있는 환경을 세팅 해야 한다.

UIKit과 SwiftUI 혼용하기

UIHostingController를 사용하면 된다.

하지만, 아무리 사용해서 연결을 해도, 자꾸 사용하고자 하는 TotalActivityView가 scope에 없다는 메시지가 보였다.

계속 서치하고, 삽질을 하다 보니,, 내가 extension들을 add target으로 해줬으므로,, 얘네들을 모두 타깃에 추가해줘야 했다.

지난 프로젝트 당시에도 이것때문에 삽질을 꽤 했었는데.. 아차차 이걸 또 잊었다니..

오래 삽질 안하고 지금이라도 알았으니 다행이다.

먼저, viewController의 오른쪽 inspector에서 target에 ActivityReport를 체크해주었다.

그리고, TotalActivityView에서도 메인 프로젝트 타깃을 추가해주었다.

그랬더니, 이제 TotalActivityView를 잘 찾아 빌드가 성공했다.

만약 안된다면, 상단의 Product -> Clean Build Folder를 꼭 하길!!

아차차 그런데 화면에는 아무것도 보이지 않았는데, 그 이유가 SceneDelegate.swift 파일을 수정하지 않았기 때문이다..

현재는 StoryBoard로 연결되도록 돼 있어 이걸 바꿔줘야 한다.

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let windowScene = (scene as? UIWindowScene) else { return }

    let window = UIWindow(windowScene: windowScene)

    let viewController = MainViewController()

    window.rootViewController = viewController

    window.makeKeyAndVisible()

    self.window = window
}

이렇게 하고 실행하니 화면이 잘 연결된 것을 확인할 수 있었다 !

지금은 자동으로 제공되는 view만 연결했는데, 그렇기에 실제 기기에서 사용한 앱에 대한 시간들이 나오는게 아니라, 내가 해당 VC를 호출할 때 넣은 argument 값이 그대로 보여지고만 있었다.

위 실행 결과는 기존의 extension에서 준 코드를 rootView로 연결해 실행한 결과이다.

이제, ActivityReport를 직접 연결해서 보여줘야 한다 !!

그 전에, 스크린타임으로 기기에 있는 전체 앱을 가져와 제한시켜보자 !

솔직히 말하면,, 여기서 삽질을 진짜 왕많이 했다.

결국 접근 권한을 먼저 허용해줘야했다는걸 뒤늦게 깨달았다..

1. 스크린타임 접근 권한 요청하기

먼저 접근 권한을 허용하기 위해서는 family controls를 사용해야 한다.

그리고 이렇게 Family Controls를 추가하면 된다.

아차차 Family Controls의 일부만 읽고 내 프로젝트에서는 쓰지 않을거라고 자부했는데..ㅋㅎㅋㅎ

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
        
    guard let windowScene = (scene as? UIWindowScene) else { return }

    // SwiftUI 뷰를 호스팅하는 UIHostingController를 생성 - 즉 SwiftUI 연결하기
    let totalActivityView = TotalActivityView(totalActivity: "hello")
    let hostingController = UIHostingController(rootView: totalActivityView)

    // UIKit의 UIWindow 설정
    window = UIWindow(windowScene: windowScene)
    window?.rootViewController = hostingController
    window?.makeKeyAndVisible()

    // 스크린타임 권한 권한 요청
    Task {
        let center = AuthorizationCenter.shared
        do {
            try await center.requestAuthorization(for: .individual)
        } catch {
            print("Fail: \(error)")
        }
    }
}

이렇게 권한 요청을 연결하면 된다 !!

이전다음

012

2. 기기의 앱 리스트 보여주기

이제 기기에 있는 모든 앱의 리스트를 보여줘야 한다.

import UIKit
import SwiftUI
import FamilyControls

struct AppListView: View {

    // 상태 관리를 위해 @State 사용하기
    // FamilyActivitySelection()은 사용자가 선택한 가족 활동 데이터를 나타내는 객체.
    @State var selection = FamilyActivitySelection()

    // isPresented는 familyActivityPicker가 화면에 표시되는지 통제함
    @State var isPresented = false

    var body: some View {
        
        // VStack은 수직으로 그리기
        VStack {
            Button {
                // 버튼이 클릭되면 isPresented 상태를 true로 설정
                isPresented = true
            } label: {
                // 버튼의 레이블 지정하기
                Text("show app list")
            }
        }
        // .familyActivityPicker는 family activity를 선택할 수 있는 Picker 화면에 보여주기
        // isPresented가 true일 때 Picker가 표시.
        // selection은 사용자가 선택한 활동 데이터를 저장함.
        .familyActivityPicker(isPresented: $isPresented, selection: $selection)
    }
}

이렇게 코드를 짜면 되는데, 나는 SwftUI를 전혀 알지 못해서 주석으로 정리를 좀 해뒀다.

나는 새로운 파일을 만들어서 리스트 불러오는 부분을 구현했는데, 이 때 빌드는 실패하고, 실패 메시지가 자꾸 보여졌다 사라졌다.

실수도 반복되면 실력인데 또 타깃 설정 문제였다.

지금 familyCotrol을 사용하려 하기 때문에 target에 activity report를 추가해줘야 한다.

그리고 빌드하니, 이렇게 잘 나오는 것을 확인할 수 있다.

이전다음

01

이제 리스트에서 선택한 앱들을 콘솔에 출력해보고, 선택한 앱들의 사용을 제한해보자.

3. 선택한 앱 사용 제한하기

먼저 선택한 앱들을 관리하기 위한 모델을 만들어준다.

import SwiftUI
import FamilyControls
import ManagedSettings

// ObservableObject 프로토콜을 채택한 Model 클래스 정의
class Model: ObservableObject {
    
    // 이 클래스의 공유 인스턴스 생성 (싱글톤 패턴)
    static var shared = Model()
    
    // ManagedSettingsStore의 인스턴스를 생성하여 설정을 관리할 수 있게 함
    let store = ManagedSettingsStore()
    
    // 사용자가 제한하려는 앱 및 카테고리 선택을 저장하는 변수, 변경될 때마다 UI 업데이트
    @Published var selectedtoLimit: FamilyActivitySelection
    
    // 초기화 메서드: selectedtoLimit을 새로운 FamilyActivitySelection 객체로 초기화
    init() {
        selectedtoLimit = FamilyActivitySelection()
    }
    
    // 사용자가 선택한 앱과 카테고리에 대해 차단 제한을 설정하는 함수
    func setShieldRestrictions() {
        // 사용자가 제한할 앱과 카테고리 선택을 가져옴
        let applications = Model.shared.selectedtoLimit
        
        // 앱 차단을 설정, 선택된 앱이 없으면 nil로 설정
        store.shield.applications = applications.applicationTokens.isEmpty ? nil : applications.applicationTokens
        
        // 앱 카테고리 차단 설정, 선택된 카테고리가 없으면 nil로 설정
        store.shield.applicationCategories = applications.categoryTokens.isEmpty
        ? nil
        : ShieldSettings.ActivityCategoryPolicy.specific(applications.categoryTokens)
    }
}

이제 모델을 추가했으니, 화면을 그리는 부분도 모델에 담고 모델 단위로 관리할 수 있도록 조금 수정해준다.

struct AppListView: View {
    
    // 상태 관리를 위해 @State 사용하기
    // FamilyActivitySelection()은 사용자가 선택한 가족 활동 데이터를 나타내는 객체.
    @State var selection = FamilyActivitySelection()
    
    // isPresented는 familyActivityPicker가 화면에 표시되는지 통제함
    @State var isPresented = false
    @EnvironmentObject var model: Model
    
    var body: some View {
        
        // VStack은 수직으로 그리기
        VStack {
            Button {
                // 버튼이 클릭되면 isPresented 상태를 true로 설정
                isPresented = true
            } label: {
                // 버튼의 레이블 지정하기
                Text("show app list")
                // .familyActivityPicker는 family activity를 선택할 수 있는 Picker 화면에 보여주기
                // isPresented가 true일 때 Picker가 표시.
                // selection은 사용자가 선택한 활동 데이터를 모델에 저장함.
            }.familyActivityPicker(isPresented: $isPresented, selection: $model.selectedtoLimit)
        }
        // 이후 선택한 앱들에 대한 shieldRestriction이 실행된다.
        .onChange(of: model.selectedtoLimit, {
            Model.shared.setShieldRestrictions()
        })
    }
}

그리고, 스크린타임에 대한 권한 요청을 AppDelegate로 넘겨준다.

// AppDelegate.swift

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
           
   guard let windowScene = (scene as? UIWindowScene) else { return }

   // `Model.shared`의 인스턴스를 생성
   let model = Model.shared

   // SwiftUI의 AppListView를 설정
   let contentView = AppListView().environmentObject(model)

   // 새로운 UIWindow를 생성하고 초기 뷰 컨트롤러로 설저
   let window = UIWindow(windowScene: windowScene)
   window.rootViewController = UIHostingController(rootView: contentView)
   self.window = window
   window.makeKeyAndVisible()
}

그리고 마지막으로, SceneDelegate를 수정해준다. 여기에 모델을 담도록 수정하고, 권한 허용 부분을 위에서 한 것 처럼 AppDelegate로 넘겨줬다.

// SceneDelegate.swift

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
           
   guard let windowScene = (scene as? UIWindowScene) else { return }

   // `Model.shared`의 인스턴스를 생성
   let model = Model.shared

   // SwiftUI의 AppListView를 설정
   let contentView = AppListView().environmentObject(model)

   // 새로운 UIWindow를 생성하고 초기 뷰 컨트롤러로 설저
   let window = UIWindow(windowScene: windowScene)
   window.rootViewController = UIHostingController(rootView: contentView)
   self.window = window
   window.makeKeyAndVisible()
}

이렇게 하고, 앱을 실행해보자 !

실행 결과

아니 이렇게 간단한 기술검증을 그때는 왜그렇게 삽질하고 힘들어했을까..

시간이 촉박하다는 이유로 reference부터 찾고, 냅다 실행해보고 넘어갔던 과거의 나.. 반성하라..

이제 애플 공식문서 구조도 어느정도 감이 잡혔고, 아직 그걸 기반으로 코드는 못짜겠지만,, 뭐,, 앞으로 차근차근 해봐야겠다 !!

다음 글에서는 이제 우리 프로젝트의 주기능을 구현해봐야지 !

참고자료

https://hongz-developer.tistory.com/246