AGENT SKILL
41-savedata-savelocal
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 4
- 参考文档README.md2.7 KB
- 参考文档SEARCH_GUIDE.md5.4 KB
- 参考文档VALIDATION_GUIDE.md8.0 KB
- 参考文档WORKFLOW_GUIDE.md8.4 KB
03 SKILL.md 正文
41-savedata-savelocal — SaveLocal (Internal)
Purpose
- 로컬 파일 기반 저장/불러오기 기능 (ComplexUtil 난독화, atomic write 지원).
- SaveLocalManager는 삭제됨. 모든 로컬 저장 로직은
SaveDataManager의 private 메서드로 통합되었다. - 외부에서 직접 호출 불가.
SaveDataManager.SyncGameStorageAsync/ResolveConflictAsync를 통해 간접 사용.
Implementation Location (3-path mirror)
- UPM (정본):
framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveLocal/SaveLocalTypes.csframework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveLocal/SaveLocalPayload.csframework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveLocal/SaveLocalCrypto.csframework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/SaveLocal/SaveLocalFileStore.cs
- Packages (sync, 직접 수정 금지):
framework-cs/apps/UnityExample/Packages/com.devian.foundation/Samples~/MobilePackage/...
Assembly Definition (asmdef)
- 단일 asmdef(
Devian.Samples.MobilePackage)에 포함되어 MobilePackage 번들 샘플과 함께 설치된다.
SaveLocalPayload Fields
version(int): 스키마 버전updateTime(string): 저장 시점(표시/진단용; Sync 최신성 판정 기준 아님)payload(string): 난독화된 게임 데이터 (Base64)deviceId(string): 디바이스 식별자saveSeq(long): 기기별 단조 증가 저장 순번 (same-device Sync 최신성 판정용)account(AccountStorage): 계정 메타 미러 (loginType,socialUserId,lastUpdatedAtUtcMs)
What it does
SaveDataManager내부 private 메서드가 primary local file 기준으로 파일 I/O를 수행한다.SaveLocalCrypto로 SHA-256 체크섬을 생성/검증한다.ComplexUtil로 payload 난독화/역난독화를 수행한다 (경량 바이트 치환, Key/IV 불필요).SaveLocalFileStore가 atomic write(임시 파일 → rename)로 파일을 안전하게 기록한다.
Non-goals
- Cloud Save(서버 저장)는 이 스킬 범위 밖이다. → 42-savedata-savecloud