AGENT SKILL

42-savedata-savecloud

暂无简介

License 许可
MIT
所属仓库
devwinsoft/devian
最近更新
2026-04-12
Stars
★ 0
Forks
0

02 资源文件 1

03 SKILL.md 正文

42-savedata-savecloud — SaveCloud (Internal)

Purpose

  • Android(GPGS) / iOS(iCloud) 공통 클라우드 저장 기능을 제공한다.
  • SaveCloudManager는 삭제됨. 모든 클라우드 로직은 SaveDataManager의 private/internal 메서드로 통합되었다.
  • Editor/Guest에서는 CloudSave를 사용하지 않는다(Failure 반환).
  • 외부 진입점은 없고, SaveDataManager 내부(SyncGameStorageAsync/ResolveConflictAsync/SaveGameStorageAsync)에서만 SaveDataManager.Instance._initializeCloudAsync(ct)를 호출한다.
  • public API는 단일 primary save만 다루며, cloud client는 내부적으로 primary cloud slot에 접근한다.

Implementation Location (3-path mirror)

  • UPM (정본):
    • framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/AppleSaveCloudClient.cs
    • framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/SaveCloudTypes.cs
    • framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/ISaveCloudClient.cs
    • framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/SaveCloudClientGoogle.cs
    • framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/SaveCloudClient.cs
    • framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/SaveCloudCrypto.cs
    • framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/SaveCloudPayload.cs
    • framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveCloud/SaveCloudResult.cs
  • Packages (sync, 직접 수정 금지):
    • framework-cs/apps/UnityExample/Packages/com.devian.foundation/Samples~/MobilePackage/...

Assembly Definition (asmdef)

  • 단일 asmdef(Devian.Samples.MobilePackage)에 포함되어 MobilePackage 번들 샘플과 함께 설치된다.

Platform behavior

  • Editor: CloudSave는 지원되지 않는다(CLOUDSAVE_NOCLIENT Failure 반환). LocalSave만 사용한다.
  • Android: SaveCloudClientGoogle(GPGS)가 기본 선택된다.
  • iOS: AppleSaveCloudClient(iCloud)가 기본 선택된다.

What it does

  • SaveDataManager.Instance._initializeCloudAsync(ct)로 플랫폼별 client 선택 및 초기화를 수행한다.
  • 정책: Unity Editor에서는 CloudSave를 사용하지 않는다(SaveDataManager가 Failure 반환).
  • payload 난독화는 ComplexUtil로 수행 (경량 바이트 치환, Key/IV 불필요).

Usage

  • 직접 호출 불가. SaveCloudManager는 삭제됨.
  • LoginManager/상위 흐름은 SaveDataManager public API(SyncGameStorageAsync, ResolveConflictAsync, SaveGameStorageAsync)만 호출한다.
  • cloud client 초기화/로그인은 SaveDataManager 내부 _initializeCloudAsync 경로에서 처리된다.
  • Sync/Resolve는 SaveDataManager.SyncGameStorageAsync / ResolveConflictAsync를 통해 간접 사용.

Non-goals

Notes

  • iOS에서는 AppleSaveCloudClient(iCloud)가 사용된다.
  • Editor에서는 CloudSave를 사용하지 않으며, SaveDataManager가 Failure를 반환한다(SSOT).
  • iCloud 구현 상세: 아래 "Cloud Save Firebase" 섹션 참조

Cloud Save Firebase (Firestore) — Inline Reference

SaveCloudClient는 Firestore 기반 저장을 제공한다.

  • 사용자 식별: FirebaseAuth (Anonymous sign-in)
  • 저장 위치:
    • users/{uid}/cloudsave/{slot}
  • 슬롯 단위 저장:
    • 문서 1개 = 슬롯 1개
  • 저장 필드(문서):
    • Version (int)
    • UpdateTime (string, 표시/진단용)
    • Payload (string)
    • DeviceId (string)
    • SaveSeq (long, same-device Sync 최신성 판정용)
    • Account (object: loginType, socialUserId, lastUpdatedAtUtcMs)
    • (legacy UtcTime/Checksum 필드는 SaveAsync 시 FieldValue.Delete로 제거)

Runtime behavior

  • SignInIfNeededAsync:
    • Firebase dependencies 체크 후(CheckAndFixDependenciesAsync)
    • SignInAnonymouslyAsync 수행
  • SaveAsync:
    • 슬롯 문서에 payload 메타/데이터 저장(SetAsync(..., MergeAll))
  • LoadAsync:
    • 슬롯 문서를 읽어 payload 복원
    • SaveCloudResult.NotFound는 "클라우드 데이터 없음(첫 저장 전)"을 의미하며, Sync에서는 실패가 아닌 Success(null)로 취급한다.
  • SaveDataManager Sync 규칙:
    • Payload 동일하면 deviceId가 달라도 Success
    • DeviceId 동일 + Payload 상이하면 SaveSeq로 same-device 최신본 자동 선택
    • DeviceId 상이하면 Conflict (유저 선택)
  • DeleteAsync:
    • 슬롯 문서 삭제

How to use (iOS)

정책: Unity Editor에서는 CloudSave를 사용하지 않는다(LocalSave only). SaveDataManager._initializeCloudAsync가 Failure를 반환한다. iOS 런타임 빌드 기본 client는 AppleSaveCloudClient를 사용한다. 현재 샘플은 외부 client 주입 API를 노출하지 않는다.

주의:

  • AppleSaveCloudClient(iCloud)는 "설계대로 유지"하며, 준비 완료 후 iOS 분기 주입을 교체한다.

Prerequisites (Unity)

Firebase Unity SDK가 프로젝트에 포함되어 있어야 한다.

  • 최소 요구(예시):
    • Firebase Core
    • Firebase Auth
    • Firebase Firestore

이 문서는 SDK 설치/프로젝트 설정 자체는 다루지 않는다. (설치가 없으면 Firebase.* 네임스페이스 관련 컴파일 에러가 발생할 수 있다.)

Firebase Notes

  • SaveCloudClient는 SignInIfNeededAsync를 통해 클라우드 인증을 자체 처리한다.
  • 플랫폼 네이티브 저장소(GPGS/iCloud)와의 크로스플랫폼 세이브 공유는 비목표다.
  • Firebase 저장소는 "Editor/iOS 임시/대체 구현" 또는 "향후 통합 백엔드" 옵션으로 사용한다.

Links

04 同仓库更多 Skills