퀵스타터즈
WatchOS를 위한 백엔드 구축 방법은?

39min
소개
이 튜토리얼에서는 watchOS 앱을 위한 백엔드를 Back4App을 사용하여 구축하는 방법을 알아볼 것입니다. 
당신이 iPhone 앱을 위한 WatchKit 확장을 만들고 있든, 독립형 Apple Watch 경험을 설계하고 있든, Back4App은 필수 도구를 제공하여 작업을 간소화합니다. 
안전한 데이터베이스, 클라우드 코드 함수, 실시간 쿼리(라이브 쿼리), 사용자 인증과 같은 기능을 통합할 수 있으며, 모든 것을 자신의 서버를 관리하지 않고도 할 수 있습니다.
또한 Back4App의 빠른 시작 루틴과 사용하기 쉬운 환경이 어떻게 watchOS 앱의 기능에 집중할 수 있도록 하는지 알게 될 것입니다.
그 과정에서 작업 예약, 웹훅 설정, 푸시 알림 구성과 같은 작업을 처리하는 방법을 배울 것입니다. 
마지막에는 생산 수준의 요구를 위해 iOS 애플리케이션 또는 watch 앱을 확장할 수 있는 견고한 기반을 갖추게 되며, 인터넷 연결을 통해 WatchKit 앱과 백엔드 간의 원활한 데이터 동기화를 제공할 수 있습니다.
전제 조건
Back4App 계정과 새로운 Back4App 프로젝트
 Back4app 시작하기.
계정이 없으시다면 무료로 생성할 수 있습니다. 위의 가이드를 따라 프로젝트를 준비하세요.
watchOS/Xcode 개발 환경
 Xcode가 설치되어 있어야 하며 watchOS SDK, 설치되어 있어야 합니다. 실제 Apple Watch 또는 시뮬레이터에서 WatchKit 확장을 실행하고 빌드할 수 있습니다.
Parse Swift SDK
 Swift Package Manager를 사용하여 watchOS 또는 결합된 iOS 앱에 대한 SDK를 설치하고 구성하세요.
Swift, Xcode 및 Apple의 개발 생태계에 대한 친숙함
 Apple 개발자 문서.
Apple 플랫폼이 처음이라면 시작하기 전에 watchOS 및 iOS 문서를 탐색하는 데 시간을 할애하세요.
시작하기 전에 이러한 전제 조건을 충족하는지 확인하세요. Back4App 프로젝트를 설정하고 로컬 watchOS 환경을 준비하면 원활하게 진행하는 데 도움이 됩니다.
1단계 – Back4App에서 새 프로젝트 만들기 및 연결하기
Back4App 프로젝트가 필요한 이유
새로운 Back4App 프로젝트는 모든 데이터를 저장하고 watchOS 앱에 대한 클라우드 코드를 실행하는 데 필수적입니다. 이는 백엔드의 기초 역할을 합니다.
프로젝트 만들기
Back4App에 로그인하세요.
대시보드에서 “새 앱”을 클릭하세요.
앱의 이름을 지정하세요 (예: “WatchOS-Backend-Tutorial”).
﻿
Parse Swift SDK 설치하기
 Parse Swift 의 의존성을 Package.swift에 추가하거나 파일 → 스위프트 패키지 → 패키지 의존성 추가를 사용하여 Xcode에서 추가하세요. URL을 제공하세요:
Swift
dependencies: [
    .package(url: "https://github.com/netreconlab/Parse-Swift.git", from: "5.0.0")
]
dependencies: [
    .package(url: "https://github.com/netreconlab/Parse-Swift.git", from: "5.0.0")
]
﻿
watchOS 또는 공유 코드에서 Parse 초기화
WatchKit 앱의 시작 코드 또는 watchOS와 iPhone 앱, 두 앱에서 접근 가능한 공유 파일에서 Parse를 초기화:
Swift
@main
struct MyWatchApp: App {
    init() {
        Task {
            do {
                try await ParseSwift.initialize(
                    applicationId: "YOUR_APP_ID",
                    clientKey: "YOUR_CLIENT_KEY",
                    serverURL: URL(string: "https://parseapi.back4app.com")!
                )
            } catch {
                print("Error initializing Parse: \(error)")
            }
        }
    }
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}
@main
struct MyWatchApp: App {
    init() {
        Task {
            do {
                try await ParseSwift.initialize(
                    applicationId: "YOUR_APP_ID",
                    clientKey: "YOUR_CLIENT_KEY",
                    serverURL: URL(string: "https://parseapi.back4app.com")!
                )
            } catch {
                print("Error initializing Parse: \(error)")
            }
        }
    }
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}
﻿
이 시점에서, 당신의 watchOS 앱은 Back4App 백엔드와 통신할 수 있습니다. 독립적인 Apple Watch 앱이든 WatchKit 확장이든 iPhone 앱, 모든 백엔드 데이터는 Parse Swift SDK를 통해 흐릅니다.
2단계 – 데이터베이스 설정
1. 데이터 모델 생성
Back4App은 Parse Server의 스키마-온-라이트 기능을 사용합니다. Back4App Database 섹션에서 테이블(클래스)을 정의하거나 객체가 처음 저장될 때 자동으로 생성되도록 할 수 있습니다. 예를 들어, 당신의 watch 앱이 건강 데이터를 추적하는 경우, heartRate, steps 또는 workoutType과 같은 필드를 가진 “HealthMetrics” 클래스를 가질 수 있습니다.
2. AI 에이전트를 사용하여 데이터 모델 만들기
Back4App의 AI 에이전트는 당신이 스키마를 일반 언어로 설명할 수 있게 해줍니다:
앱 대시보드에서 AI 에이전트를 엽니다.
“일일 걸음 수 (숫자), 심박수 (숫자) 필드가 있는 Watch Metrics 클래스를 설정해 주세요.”와 같은 세부 정보를 제공합니다.
AI가 자동으로 스키마를 생성합니다.
﻿
3. SDK를 사용하여 데이터 읽기 및 쓰기
아래는 watchOS 앱에서 데이터를 저장하고 쿼리하는 예입니다. HealthMetrics 구조체가 있다고 가정해 보겠습니다:
Swift
import ParseSwift

struct HealthMetrics: ParseObject {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    var dailySteps: Int?
    var heartRate: Int?
}

// Saving data
func saveMetrics(steps: Int, heart: Int) async {
    var metrics = HealthMetrics()
    metrics.dailySteps = steps
    metrics.heartRate = heart

    do {
        let saved = try await metrics.save()
        print("Saved metrics: \(saved)")
    } catch {
        print("Error saving: \(error)")
    }
}

// Querying data
func fetchLatestMetrics() async {
    let query = HealthMetrics.query()
    do {
        let results = try await query.find()
        print("Fetched: \(results.count) items")
    } catch {
        print("Error fetching: \(error)")
    }
}
import ParseSwift

struct HealthMetrics: ParseObject {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    var dailySteps: Int?
    var heartRate: Int?
}

// Saving data
func saveMetrics(steps: Int, heart: Int) async {
    var metrics = HealthMetrics()
    metrics.dailySteps = steps
    metrics.heartRate = heart

    do {
        let saved = try await metrics.save()
        print("Saved metrics: \(saved)")
    } catch {
        print("Error saving: \(error)")
    }
}

// Querying data
func fetchLatestMetrics() async {
    let query = HealthMetrics.query()
    do {
        let results = try await query.find()
        print("Fetched: \(results.count) items")
    } catch {
        print("Error fetching: \(error)")
    }
}
﻿
4. REST API를 사용한 데이터 읽기 및 쓰기
필요한 경우, 당신의 watchOS 또는 iOS 앱도 REST 요청을 보낼 수 있습니다:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dailySteps": 8000, "heartRate": 75}' \
  https://parseapi.back4app.com/classes/HealthMetrics
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dailySteps": 8000, "heartRate": 75}' \
  https://parseapi.back4app.com/classes/HealthMetrics
﻿
5. GraphQL을 사용한 데이터 읽기 및 쓰기
Back4App은 GraphQL 엔드포인트도 제공합니다. 예를 들어:
GraphQL
mutation {
  createHealthMetrics(input: {
    fields: {
      dailySteps: 7500
      heartRate: 70
    }
  }) {
    healthMetrics {
      objectId
      dailySteps
      heartRate
    }
  }
}
mutation {
  createHealthMetrics(input: {
    fields: {
      dailySteps: 7500
      heartRate: 70
    }
  }) {
    healthMetrics {
      objectId
      dailySteps
      heartRate
    }
  }
}
﻿
6. 라이브 쿼리 작업하기 (선택 사항)
실시간 데이터 업데이트가 필요하다면, 당신의 Apple Watch, 라이브 쿼리를 활성화하세요:
Back4App의 서버 설정에서 라이브 쿼리를 켭니다.
watchOS 코드에서 라이브 쿼리 URL을 설정합니다:
Swift
ParseLiveQuery.configure(url: URL(string: "wss://YOUR_SUBDOMAIN.b4a.io")!)
ParseLiveQuery.configure(url: URL(string: "wss://YOUR_SUBDOMAIN.b4a.io")!)
﻿
그런 다음 변경 사항을 구독합니다:
Swift
func subscribeMetricsUpdates() async throws {
    let subscription = HealthMetrics.query().subscribe()
    for try await event in subscription {
        switch event {
        case .created(let newData):
            print("New data: \(newData)")
        case .updated(let updatedData):
            print("Updated: \(updatedData)")
        default:
            break
        }
    }
}
func subscribeMetricsUpdates() async throws {
    let subscription = HealthMetrics.query().subscribe()
    for try await event in subscription {
        switch event {
        case .created(let newData):
            print("New data: \(newData)")
        case .updated(let updatedData):
            print("Updated: \(updatedData)")
        default:
            break
        }
    }
}
﻿
3단계 – ACL 및 CLP로 보안 적용하기
1. 간략한 개요
Back4App은 데이터베이스를 보호하기 위해 접근 제어 목록(ACL) 및 클래스 수준 권한(CLPS)을 허용합니다. 예를 들어, 특정 메트릭을 생성한 사용자에게만 제한하거나 인증된 계정에만 읽기 접근을 허용할 수 있습니다.
2. 단계별 설정
클래스 수준 권한
기본값을 정의하려면 데이터베이스 → 클래스 → 보안으로 이동하세요 (예: 모두 읽기 전용, 소유자에게 쓰기 권한).
코드에서의 ACL
WatchKit 또는 공유 코드의 각 객체에 ACL을 추가할 수 있습니다. 예를 들어:
Swift
if let user = User.current {
    var acl = ParseACL()
    acl.setReadAccess(user: user, value: true)
    acl.setWriteAccess(user: user, value: true)

    var metrics = HealthMetrics()
    metrics.ACL = acl
}
if let user = User.current {
    var acl = ParseACL()
    acl.setReadAccess(user: user, value: true)
    acl.setWriteAccess(user: user, value: true)

    var metrics = HealthMetrics()
    metrics.ACL = acl
}
﻿
이렇게 하면 로그인한 사용자만 자신이 생성한 HealthMetrics 객체를 보고 수정할 수 있습니다.
4단계 – 클라우드 코드 함수 작성
1. 클라우드 코드의 필요성
클라우드 코드는 데이터 검증, 외부 API 호출 또는 로깅과 같은 복잡하거나 기밀적인 작업을 서버 측에서 실행하는 데 도움이 됩니다. 이 설정은 watchOS 장치의 작업 부하를 최소화하고 Apple Watch의 배터리 수명을 유지하는 데 유용합니다.
2. 예제 함수
당신의 main.js:
JS
Parse.Cloud.define('processMetrics', async (request) => {
  const { dailySteps, heartRate } = request.params;
  if (!dailySteps || !heartRate) {
    throw 'Missing parameters.';
  }
  // Example: Simple calculation
  return dailySteps * heartRate;
});
Parse.Cloud.define('processMetrics', async (request) => {
  const { dailySteps, heartRate } = request.params;
  if (!dailySteps || !heartRate) {
    throw 'Missing parameters.';
  }
  // Example: Simple calculation
  return dailySteps * heartRate;
});
﻿
3. 배포
다음의 Back4App CLI를 사용하여 배포하세요:
Bash
b4a deploy
b4a deploy
﻿
이렇게 하면 로그인한 사용자만 자신이 생성한 HealthMetrics 객체를 보고 수정할 수 있습니다.
4. NPM 모듈 설치
Cloud Code에서 외부 라이브러리가 필요하다면:
의존성을 추가하세요 package.json (Cloud Code 폴더 내에서).
사용하세요 require('your-lib') 에서 main.js.
5단계 – 인증 구성
1. 사용자 인증 활성화
기본적으로 User 클래스는 Back4App에서 준비되어 있습니다. 사용자 객체에 대해 “클래스 수준 권한 활성화”가 올바르게 설정되어 있는지 확인하세요.
2. 코드 샘플
Parse Swift에서 watchOS 코드로 사용자를 가입시킬 수 있습니다:
Swift
struct User: ParseUser {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?
    var username: String?
    var email: String?
    var emailVerified: Bool?
    var password: String?
    var authData: [String : [String : String]?]?
}

func signUpNewUser(name: String, pass: String, mail: String) async {
    var newUser = User()
    newUser.username = name
    newUser.password = pass
    newUser.email = mail

    do {
        let signedUp = try await newUser.signUp()
        print("Sign Up successful: \(signedUp)")
    } catch {
        print("Error signing up: \(error)")
    }
}
struct User: ParseUser {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?
    var username: String?
    var email: String?
    var emailVerified: Bool?
    var password: String?
    var authData: [String : [String : String]?]?
}

func signUpNewUser(name: String, pass: String, mail: String) async {
    var newUser = User()
    newUser.username = name
    newUser.password = pass
    newUser.email = mail

    do {
        let signedUp = try await newUser.signUp()
        print("Sign Up successful: \(signedUp)")
    } catch {
        print("Error signing up: \(error)")
    }
}
﻿
3. 소셜 로그인
watchOS 또는 iPhone 앱에 Apple, Google 또는 Facebook 로그인을 통합할 계획이라면, 관련 Parse Swift 소셜 로그인 기능을 사용하여 가능합니다. 자세한 내용은 Back4App 문서를 참조하세요.
6단계 – 파일 저장 처리
1. 파일 저장 설정
당신의 watch 앱이 이미지, 로그 또는 작은 데이터 파일을 업로드해야 한다면, ParseFile을 사용할 수 있습니다.
Swift
func uploadFile(data: Data, fileName: String) async {
    let file = ParseFile(name: fileName, data: data)
    do {
        let savedFile = try await file.save()
        print("Uploaded file: \(savedFile.url ?? "")")
    } catch {
        print("Error uploading file: \(error)")
    }
}
func uploadFile(data: Data, fileName: String) async {
    let file = ParseFile(name: fileName, data: data)
    do {
        let savedFile = try await file.save()
        print("Uploaded file: \(savedFile.url ?? "")")
    } catch {
        print("Error uploading file: \(error)")
    }
}
﻿
2. 예시
운동 이미지나 일일 진행 상황 스냅샷을 저장할 수 있습니다:
Swift
let snapshotData = // ...some image data from watch screenshot
Task {
    await uploadFile(data: snapshotData, fileName: "workout.jpg")
}
let snapshotData = // ...some image data from watch screenshot
Task {
    await uploadFile(data: snapshotData, fileName: "workout.jpg")
}
﻿
3. 보안 고려사항
파일 ACL을 검토하십시오. 기본적으로 파일 URL은 누군가가 직접 링크를 얻으면 접근할 수 있습니다. 파스 서버의 파일 구성으로 파일 접근을 보호하거나 제어할 수 있습니다.
7단계 – 이메일 인증 및 비밀번호 재설정
1. 개요
Apple Watch 사용자는 항상 시계에서 직접 로그인을 관리하지 않을 수 있지만, 이메일 인증을 활성화하면 데이터를 안전하게 유지하는 데 도움이 됩니다.
2. Back4App 대시보드 구성
이동하십시오 앱 설정 → 이메일.
이메일 인증을 활성화하십시오.
필요에 따라 템플릿을 사용자 정의하십시오.
3. 코드/구현
비밀번호 재설정의 경우:
Swift
do {
    try await User.requestPasswordReset(email: "[email protected]")
} catch {
    print("Error requesting password reset: \(error)")
}
do {
    try await User.requestPasswordReset(email: "example@domain.com")
} catch {
    print("Error requesting password reset: \(error)")
}
﻿
8단계 – 클라우드 작업으로 작업 예약하기
1. 클라우드 작업의 기능
클라우드 작업을 사용하면 오래된 데이터를 회전시키거나 watchOS 분석을 위한 사용 보고서를 생성하는 등의 백그라운드 작업을 자동화할 수 있습니다.
2. 예시
다음은 main.js:
JS
Parse.Cloud.job('cleanUpMetrics', async (request) => {
  const query = new Parse.Query('HealthMetrics');
  // For example, remove records older than 7 days
  const now = new Date();
  const cutoff = new Date(now - 7 * 24 * 60 * 60 * 1000);
  query.lessThan('createdAt', cutoff);

  const oldMetrics = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldMetrics, { useMasterKey: true });
  return `Deleted ${oldMetrics.length} old records.`;
});
Parse.Cloud.job('cleanUpMetrics', async (request) => {
  const query = new Parse.Query('HealthMetrics');
  // For example, remove records older than 7 days
  const now = new Date();
  const cutoff = new Date(now - 7 * 24 * 60 * 60 * 1000);
  query.lessThan('createdAt', cutoff);

  const oldMetrics = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldMetrics, { useMasterKey: true });
  return `Deleted ${oldMetrics.length} old records.`;
});
﻿
코드를 배포하세요.
다음으로 가세요: 앱 설정 → 서버 설정 → 백그라운드 작업 및 매일 예약하세요.
클라우드 작업 예약하기
﻿
9단계 – 웹훅 통합하기
1. 정의
웹훅은 특정 이벤트가 앱에서 발생할 때 외부 서비스에 알립니다. 예를 들어, 새로운 메트릭이 기록될 때마다 Slack 채널에 알림을 보낼 수 있습니다.
2. 설정
Back4App 대시보드에서 더보기 → 웹훅으로 이동하세요.
엔드포인트(예: Slack URL)로 웹훅을 추가하세요.
이벤트를 선택하세요(예: “HealthMetrics에 새 기록”).
웹훅 추가하기
﻿
3. 예시
사용자가 새로운 dailySteps 항목을 추가할 때마다, 귀하의 Slack 채널에 알림이 전송됩니다. 또한 Cloud Code에서 더 복잡한 논리를 정의하여 외부 서비스에 사용자 정의 페이로드를 보낼 수 있습니다.
10단계 – Back4App 관리 패널 탐색
1. 어디서 찾을 수 있나요?
관리 패널은 귀하의 Back4App 콘솔에서 더보기 → 관리 앱.
비기술적 이해관계자를 위한 간단한 인터페이스가 필요하다면 이를 활성화하고 웹 기반 데이터 관리를 위한 관리자 사용자를 생성하세요.
관리 앱 활성화
﻿
2. 기능
데이터 보기 및 편집
로그 및 클라우드 작업 관리
분석 추적 또는 푸시 알림 전송
직접 데이터베이스나 코드 접근 없이 데이터에 협업할 수 있는 쉬운 방법입니다.
결론
이 가이드를 통해 watchOS용 백엔드 구축 방법을 배웠습니다. 안전한 데이터베이스 스키마를 설정하고, 클라우드 코드를 작성하며, 실시간 쿼리를 처리하고, 사용자 인증을 구현했습니다. 이제 당신의 WatchKit 앱은 최소한의 번거로움으로 데이터를 저장하고 동기화할 수 있습니다.
다음 단계
고급 클라우드 기능을 통합하여 개인화된 알림 또는 데이터 변환을 통해 시계 앱을 다듬으세요.
추가 iOS 애플리케이션 기능을 탐색하세요. 예를 들어, Apple Watch의 백그라운드 동기화 및 캐싱 전략.
고급 보안, 분석 및 성능에 대한 더 많은 정보를 보려면 공식 Back4App 문서를 읽어보세요.
App Store에 최적화하여 watchOS 확장 또는 독립형 시계 앱을 배포하세요.
백엔드를 확장함으로써, 제한된 인터넷 연결에서도 원활하게 작동하는 강력한 watchOS 앱을 제공할 수 있습니다. 계속해서 개발하고 Apple Watch 경험을 위해 Back4App의 힘을 즐기세요!
업데이트됨 24 Jan 2025
이 페이지가 도움이 되었습니까?
jQuery용 백엔드를 구축하는 방법?
tvOS용 백엔드 구축 방법은?