퀵스타터즈
tvOS용 백엔드 구축 방법은?

41min
소개
이 튜토리얼에서는 tvOS 앱을 위해 Back4App을 사용하여 백엔드를 구축하는 방법을 배웁니다. 
우리는 데이터베이스 관리, 클라우드 코드 함수, REST 및 GraphQL API, 사용자 인증, 실시간(라이브 쿼리)과 같은 필수 Back4App 기능을 통합하여 Apple TV 앱과 원활하게 통신하는 안전하고 확장 가능한 백엔드를 만드는 방법을 다룰 것입니다.
Back4App의 간소화된 환경과 빠른 설정이 수동으로 서버와 데이터베이스를 구성하는 것에 비해 시간을 얼마나 크게 단축하는지 확인할 수 있습니다. 
이 과정에서 고급 보안 기능, 클라우드 작업 예약 및 웹훅 통합을 포함한 주요 기능에 대한 실습 경험을 얻게 될 것입니다.
이 튜토리얼이 끝나면 이 기본 구조를 프로덕션 준비가 완료된 tvOS 앱으로 발전시키거나 사용자 정의 논리 및 타사 API를 쉽게 포함할 준비가 될 것입니다. 이 가이드는 또한 높은 품질의 사용자 경험을 Apple TV, Xcode 프로젝트 및 기존 iOS 개발 지식을 활용하여 유지하는 데 도움이 될 것입니다.
전제 조건
이 튜토리얼을 완료하려면 다음이 필요합니다:
Back4App 계정 및 새 Back4App 프로젝트
Back4app 시작하기.
계정이 없으신 경우 무료로 생성할 수 있습니다. 위의 가이드를 따라 프로젝트를 준비하세요.
Xcode(최신 안정 버전) 설치
Swift 또는 SwiftUI로 tvOS 앱을 구축할 것입니다. Mac App Store에서 최신 Xcode를 확보하세요.
Parse Swift SDK
당신의 tvOS 앱을 연결하기 위해 Parse Swift SDK을 설정하세요.
Swift 및 기본 iOS/tvOS 개발 개념에 대한 친숙함
Apple TV에 처음이라면 Apple tvOS 문서 또는 초급 튜토리얼을 먼저 검토하세요.
시작하기 전에 이러한 모든 전제 조건이 준비되어 있는지 확인하세요. Back4App 프로젝트를 준비하고 로컬 tvOS Xcode 프로젝트를 설정하면 더 쉽게 따라할 수 있습니다.
1단계 – Back4App에서 새 프로젝트 만들기 및 연결
새 프로젝트 만들기
Back4App에서 tvOS 앱 백엔드를 구축하는 첫 번째 단계는 새 프로젝트를 만드는 것입니다. 아직 하지 않았다면, 다음 단계를 따르세요:
Back4App 계정에 로그인하세요.
Back4App 대시보드에서 “새 앱” 버튼을 클릭하세요.
앱에 이름을 지정하세요 (예: “tvOS-Backend-Tutorial”).
﻿
생성된 후, Back4App 대시보드에서 프로젝트가 나열된 것을 볼 수 있습니다. 이 새로운 Back4App 프로젝트는 이 튜토리얼에서 다루는 모든 백엔드 구성의 핵심입니다.
Parse Swift SDK 연결하기
Back4App은 Parse를 활용하여 데이터 저장, 사용자 인증, 실시간 기능 등을 처리합니다. tvOS 앱을 Back4App에 연결하려면 Xcode 프로젝트에 Parse Swift SDK를 설치하고 구성하세요.
Parse 키 가져오기:
Back4App 대시보드에서 “앱 설정” 또는 “보안 및 키”로 이동하여 애플리케이션 ID와 클라이언트 키를 찾으세요. 또한 Parse 서버 URL—일반적으로 https://parseapi.back4app.com을 볼 수 있습니다.
﻿
tvOS 프로젝트에 Parse Swift SDK 설치하기:
Swift 패키지 관리자 (권장)
Xcode에서 파일 → 패키지 추가를 선택하세요.
Parse Swift GitHub URL을 입력하세요: https://github.com/netreconlab/Parse-Swift.git
적절한 버전 또는 메인 브랜치를 선택하세요.
CocoaPods
CocoaPods를 선호하는 경우, Podfile에 다음을 추가하세요:
Ruby
pod 'ParseSwiftOG'
pod 'ParseSwiftOG'
﻿
그런 다음 pod install을 실행합니다.
Parse 초기화를 AppDelegate 또는 @main 구조체에서 수행합니다:
Swift
import ParseSwift
import SwiftUI

@main
struct MyTVOSApp: 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()
        }
    }
}
import ParseSwift
import SwiftUI

@main
struct MyTVOSApp: 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()
        }
    }
}
﻿
이것은 당신의 tvOS 앱이 Back4App 백엔드와 통신하도록 구축되었음을 보장하며, 데이터를 저장하고, 쿼리를 실행하고, 사용자를 인증하고, 그 외의 작업을 수행할 수 있게 해줍니다.
2단계 – 데이터베이스 설정
데이터 모델 생성
이제 tvOS 앱이 Back4App에 연결되었으므로 데이터를 생성하고 관리할 수 있습니다. Parse Swift에서는 ParseObject 구조체를 정의합니다:
Swift
struct GameScore: ParseObject {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    // Custom fields
    var score: Int?
    var playerName: String?
}
struct GameScore: ParseObject {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    // Custom fields
    var score: Int?
    var playerName: String?
}
﻿
Back4App 대시보드에서 수동으로 클래스를 정의할 수도 있습니다:
“데이터베이스”로 이동 Back4App 콘솔에서.
새 클래스 만들기 (예: “GameScore”).
관련 열 추가하기 (점수, 플레이어 이름 등).
새 클래스 만들기
﻿
AI 에이전트를 사용한 데이터 모델 생성
Back4App의 AI 에이전트가 자동으로 스키마를 설계할 수 있습니다:
AI 에이전트 열기 Back4App 대시보드에서.
모델 설명하기 (예: “제목과 isCompleted 필드가 있는 ToDo 클래스를 생성”).
적용하기 AI 에이전트가 스키마를 생성하도록 하세요.
﻿
SDK를 사용한 데이터 읽기 및 쓰기
Swift
func saveScore() async {
    var gameScore = GameScore()
    gameScore.score = 1337
    gameScore.playerName = "tvOS Fan"
    do {
        try await gameScore.save()
        print("Score saved successfully.")
    } catch {
        print("Error saving score: \\(error)")
    }
}

func fetchScores() async {
    let query = GameScore.query()
    do {
        let results = try await query.find()
        print("Fetched scores: \\(results)")
    } catch {
        print("Error fetching scores: \\(error)")
    }
}
func saveScore() async {
    var gameScore = GameScore()
    gameScore.score = 1337
    gameScore.playerName = "tvOS Fan"
    do {
        try await gameScore.save()
        print("Score saved successfully.")
    } catch {
        print("Error saving score: \\(error)")
    }
}

func fetchScores() async {
    let query = GameScore.query()
    do {
        let results = try await query.find()
        print("Fetched scores: \\(results)")
    } catch {
        print("Error fetching scores: \\(error)")
    }
}
﻿
REST API를 사용한 데이터 읽기 및 쓰기
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 '{"score": 9000, "playerName": "AppleFan"}' \
  https://parseapi.back4app.com/classes/GameScore
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 '{"score": 9000, "playerName": "AppleFan"}' \
  https://parseapi.back4app.com/classes/GameScore
﻿
GraphQL API를 사용한 데이터 읽기 및 쓰기
GraphQL
mutation {
  createGameScore(input: {
    fields: {
      score: 420
      playerName: "Swiftie"
    }
  }) {
    gameScore {
      objectId
      score
      playerName
    }
  }
}
mutation {
  createGameScore(input: {
    fields: {
      score: 420
      playerName: "Swiftie"
    }
  }) {
    gameScore {
      objectId
      score
      playerName
    }
  }
}
﻿
라이브 쿼리 작업하기 (선택 사항)
라이브 쿼리는 Apple TV 인터페이스에서 실시간 업데이트를 가능하게 합니다—특히 다중 플레이어 또는 리더보드 앱에 유용합니다.
라이브 쿼리 활성화를 위해 앱의 서버 설정을 Back4App에서 설정하세요.
구독 초기화:
Swift
let subscription = GameScore.query("score" > 1000).subscribeCallback { event in
    switch event {
    case .created(let score):
        print("New high score created: \\(score)")
    case .updated(let score):
        print("High score updated: \\(score)")
    case .deleted(let score):
        print("High score removed: \\(score)")
    default:
        break
    }
}
let subscription = GameScore.query("score" > 1000).subscribeCallback { event in
    switch event {
    case .created(let score):
        print("New high score created: \\(score)")
    case .updated(let score):
        print("High score updated: \\(score)")
    case .deleted(let score):
        print("High score removed: \\(score)")
    default:
        break
    }
}
﻿
3단계 – ACL 및 CLP를 통한 보안 적용
개요
Back4App은 ACLs (액세스 제어 목록) 및 CLPs (클래스 수준 권한)을 사용하여 데이터를 보호합니다. 이를 사용하여 객체 또는 클래스 수준에서 읽기/쓰기 규칙을 정의하십시오.
﻿
클래스 수준 권한
데이터베이스로 이동, 클래스를 선택하십시오 (예: GameScore).
“보안” 클릭 또는 “클래스 수준 권한”.
누가 읽고, 쓰고, 삭제할 수 있는지 설정 (예: 인증된 사용자만).
코드에서의 ACL
Swift
var gameScore = GameScore()
gameScore.score = 500
// Restrict read/write to only the current user
var acl = ParseACL()
if let user = try? await User.current() {
    acl.setReadAccess(user: user, value: true)
    acl.setWriteAccess(user: user, value: true)
}
gameScore.ACL = acl
var gameScore = GameScore()
gameScore.score = 500
// Restrict read/write to only the current user
var acl = ParseACL()
if let user = try? await User.current() {
    acl.setReadAccess(user: user, value: true)
    acl.setWriteAccess(user: user, value: true)
}
gameScore.ACL = acl
﻿
4단계 – 클라우드 코드 함수 작성
클라우드 코드가 필요한 이유?
클라우드 코드는 클라이언트에서 중요한 로직을 안전한 서버 측 코드로 오프로드할 수 있게 해줍니다. 이는 비즈니스 규칙, 데이터 검증 또는 tvOS 앱에서 비밀을 노출하지 않고 제3자 통합을 위한 훌륭한 방법입니다.
예제 함수
당신의 main.js:
JS
Parse.Cloud.define("awardBonus", async (request) => {
  const { objectId, bonus } = request.params;
  const query = new Parse.Query("GameScore");
  const gameScore = await query.get(objectId, { useMasterKey: true });
  gameScore.increment("score", bonus);
  await gameScore.save(null, { useMasterKey: true });
  return gameScore;
});
Parse.Cloud.define("awardBonus", async (request) => {
  const { objectId, bonus } = request.params;
  const query = new Parse.Query("GameScore");
  const gameScore = await query.get(objectId, { useMasterKey: true });
  gameScore.increment("score", bonus);
  await gameScore.save(null, { useMasterKey: true });
  return gameScore;
});
﻿
배포
Back4App CLI:
Bash
b4a configure accountkey
b4a deploy
b4a configure accountkey
b4a deploy
﻿
또는 Back4App Dashboard → Cloud Code → Functions → main.js을 사용하세요.
Swift에서 호출하기
Swift
import ParseSwift

func awardBonusScore(objectId: String, bonus: Int) async {
    do {
       let result = try await ParseCloud.callFunction("awardBonus", with: [
         "objectId": objectId,
         "bonus": bonus
       ])
       print("Updated score: \\(result)")
    } catch {
       print("Error awarding bonus: \\(error)")
    }
}
import ParseSwift

func awardBonusScore(objectId: String, bonus: Int) async {
    do {
       let result = try await ParseCloud.callFunction("awardBonus", with: [
         "objectId": objectId,
         "bonus": bonus
       ])
       print("Updated score: \\(result)")
    } catch {
       print("Error awarding bonus: \\(error)")
    }
}
﻿
NPM 모듈
당신의 package.json, 의존성을 추가하세요:
JSON
{
  "dependencies": {
    "axios": "^0.27.0"
  }
}
{
  "dependencies": {
    "axios": "^0.27.0"
  }
}
﻿
그런 다음 main.js에서 요구하거나 가져와서 Cloud Code에서 사용하세요.
5단계 – 인증 구성
Back4App에서 사용자 인증
tvOS 앱은 종종 사용자 데이터 동기화 또는 로그인이 필요합니다. Parse의 ParseUser는 안전한 가입, 로그인, 세션 및 역할 기반 액세스를 제공합니다.
Swift
struct User: ParseUser {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    // Essential
    var username: String?
    var email: String?
    var emailVerified: Bool?
    var password: String?
    var authData: [String: [String: String]?]?
}
struct User: ParseUser {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    // Essential
    var username: String?
    var email: String?
    var emailVerified: Bool?
    var password: String?
    var authData: [String: [String: String]?]?
}
﻿
가입 / 로그인
Swift
func signUpUser() async {
    var newUser = User()
    newUser.username = "tvUser"
    newUser.password = "secret"
    newUser.email = "[email protected]"
    do {
        try await newUser.signUp()
        print("Sign-up successful.")
    } catch {
        print("Error signing up: \\(error)")
    }
}

func loginUser() async {
    do {
        let loggedIn = try await User.login(username: "tvUser", password: "secret")
        print("Logged in as: \\(loggedIn.username ?? "")")
    } catch {
        print("Login error: \\(error)")
    }
}
func signUpUser() async {
    var newUser = User()
    newUser.username = "tvUser"
    newUser.password = "secret"
    newUser.email = "user@example.com"
    do {
        try await newUser.signUp()
        print("Sign-up successful.")
    } catch {
        print("Error signing up: \\(error)")
    }
}

func loginUser() async {
    do {
        let loggedIn = try await User.login(username: "tvUser", password: "secret")
        print("Logged in as: \\(loggedIn.username ?? "")")
    } catch {
        print("Login error: \\(error)")
    }
}
﻿
소셜 로그인
구성 Facebook 또는 Apple 로그인. 그런 다음 계정을 연결합니다:
Swift
try await user.link(with: .apple(idToken: "TOKEN", rawNonce: "NONCE"))
try await user.link(with: .apple(idToken: "TOKEN", rawNonce: "NONCE"))
﻿
6단계 – 파일 저장 처리
파일 저장 설정
사용자 이미지, 게임 리플레이 또는 앱 자산을 ParseFile: 사용하여 업로드합니다.
Swift
let fileData = Data(...) // e.g. image bytes
let file = ParseFile(name: "preview.png", data: fileData)
do {
    let savedFile = try await file.save()
    print("File uploaded: \\(savedFile.url)")
} catch {
    print("Error uploading file: \\(error)")
}
let fileData = Data(...) // e.g. image bytes
let file = ParseFile(name: "preview.png", data: fileData)
do {
    let savedFile = try await file.save()
    print("File uploaded: \\(savedFile.url)")
} catch {
    print("Error uploading file: \\(error)")
}
﻿
예시
객체에 파일 첨부:
Swift
struct GameMedia: ParseObject {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    var screenshot: ParseFile?
}
struct GameMedia: ParseObject {
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
    var originalData: Data?

    var screenshot: ParseFile?
}
﻿
보안 고려사항
파일 참조를 보호하기 위해 CLP 또는 ACL을 사용하십시오. 파일의 직접 URL은 파일 보안을 활성화하지 않으면 공개적으로 접근할 수 있습니다.
7단계 – 이메일 확인 및 비밀번호 재설정
개요
이메일 확인은 사용자 이메일 계정 소유권을 확인하는 데 도움이 됩니다. 비밀번호 재설정은 계정 접근을 복구하는 안전하고 사용자 친화적인 방법을 제공합니다.
Back4App 대시보드 구성
앱에서 → 앱 설정 → 이메일
이메일 확인 또는 비밀번호 재설정을 활성화합니다.
이메일 템플릿을 사용자 정의합니다.
코드 구현
Swift
func requestPasswordReset(for email: String) async {
    do {
        try await User.passwordReset(email: email)
        print("Password reset link sent.")
    } catch {
        print("Error requesting password reset: \\(error)")
    }
}
func requestPasswordReset(for email: String) async {
    do {
        try await User.passwordReset(email: email)
        print("Password reset link sent.")
    } catch {
        print("Error requesting password reset: \\(error)")
    }
}
﻿
8단계 – 클라우드 작업으로 작업 예약하기
클라우드 작업
오래된 데이터 정리 또는 월간 업데이트 이메일 발송과 같은 반복 작업을 자동화합니다:
JS
Parse.Cloud.job("cleanupOldScores", async (request) => {
  const now = new Date();
  const thirtyDaysAgo = new Date(now - 30 * 24 * 60 * 60 * 1000);
  const query = new Parse.Query("GameScore");
  query.lessThan("createdAt", thirtyDaysAgo);
  const oldScores = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldScores, { useMasterKey: true });
  return `Deleted ${oldScores.length} old scores.`;
});
Parse.Cloud.job("cleanupOldScores", async (request) => {
  const now = new Date();
  const thirtyDaysAgo = new Date(now - 30 * 24 * 60 * 60 * 1000);
  const query = new Parse.Query("GameScore");
  query.lessThan("createdAt", thirtyDaysAgo);
  const oldScores = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldScores, { useMasterKey: true });
  return `Deleted ${oldScores.length} old scores.`;
});
﻿
“Back4App 대시보드 → 앱 설정 → 서버 설정 → 백그라운드 작업”에서 “cleanupOldScores”를 매일 실행되도록 예약합니다.
클라우드 작업 예약
﻿
9단계 – 웹훅 통합
정의
웹훅은 Back4App 앱이 외부 서비스에 이벤트를 전송할 수 있도록 합니다. 이는 Slack에 알림을 보내거나, Stripe에 결제 업데이트를 하거나, 서버에 분석 데이터를 전송하는 것일 수 있습니다.
구성
Back4App 대시보드에서 더보기 → 웹훅 → 웹훅 추가. 엔드포인트(예: https://myserver.com/webhook-endpoint)와 트리거(객체 업데이트, 새 레코드 등)를 지정합니다.
웹훅 추가
﻿
예시
새로운 최고 점수가 생성될 때 Slack에 알림을 보냅니다:
JS
Parse.Cloud.afterSave("GameScore", async (request) => {
  const score = request.object.get("score");
  await sendToSlack(`A new high score of ${score} was posted!`);
});
Parse.Cloud.afterSave("GameScore", async (request) => {
  const score = request.object.get("score");
  await sendToSlack(`A new high score of ${score} was posted!`);
});
﻿
10단계 – Back4App 관리 패널 탐색
찾는 방법
“Back4App 관리 앱”은 사용자 친화적이고, “모델 중심”의 대시보드로 데이터 관리, CRUD 수행 또는 클래스 편집을 할 수 있습니다—직접 데이터베이스 쿼리가 필요하지 않습니다.
“앱 대시보드” → “더보기” → “관리 앱”을 통해 활성화하세요.
관리 앱 활성화
﻿
기능
활성화되면 팀원이나 클라이언트를 초대하여 데이터를 관리하고, 로그를 확인하거나 푸시 알림을 조정할 수 있습니다—본질적으로 그들에게 “tvOS 앱”의 백엔드에 대한 직접적인 포털을 제공합니다.
결론
이 포괄적인 튜토리얼을 따라함으로써, 당신은:
안전한 백엔드를 생성했습니다. tvOS 앱을 위해 Back4App을 사용했습니다.
데이터베이스를 구성했습니다. 클래스, 데이터 유형 및 관계를 포함하여.
실시간 쿼리를 설정했습니다. 즉각적인 변화를 반영하기 위해.
ACL 및 CLP를 통해 보안을 적용했습니다.
사용자 정의 비즈니스 로직 및 통합을 위해 Cloud Code를 구현했습니다.
이메일 확인 및 비밀번호 재설정을 통해 인증을 활성화했습니다.
선택적 보안 제어와 함께 파일 업로드를 처리했습니다.
정기 작업을 위해 Cloud Jobs를 예약했습니다.
외부 서비스와 통합하기 위해 웹훅을 사용했습니다.
데이터를 관리하고 모니터링하기 위해 관리 패널을 탐색했습니다.
이제 풍부하고, 고품질의 Apple TV 경험을 구축할 준비가 되었습니다. 당신의 앱은 강력한 기반 위에 구축되었습니다. 당신의 tvOS 앱 아이디어를 현실로 바꾸는 것을 즐기세요!
다음 단계
tvOS UI 개선: 포커스 기반 내비게이션, 대화면 사용자 흐름 및 App Store 모범 사례를 통합하세요.
보안 강화: 역할 기반 ACL, 다단계 인증 또는 고급 암호화를 추가하세요.
기술 향상: 오프라인 캐싱 또는 맞춤형 분석과 같은 더 고급 Parse Swift 기능을 탐색하세요.
공식 문서 확인: Back4App 문서 및 Apple tvOS 문서를 통해 더 깊은 지식을 얻으세요.
수익화: 구독 또는 유료 시청을 고려하여 스트리밍 비즈니스 잠재력을 확장하세요.
이 가이드의 기본 사항을 바탕으로, 새로운 기능을 혁신하고 통합할 수 있습니다. tvOS 앱을 다음 단계로 끌어올리는 데 행운을 빕니다!
업데이트됨 24 Jan 2025
이 페이지가 도움이 되었습니까?
WatchOS를 위한 백엔드 구축 방법은?
MacOS를 위한 백엔드를 구축하는 방법?