[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBHBD6E4EY7X3VYR274GKA":3,"skill-same:01M6CBHBD6E4EY7X3VYR274GKA":50},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":28,"updatedAt":29,"install":30,"resources":43},"01M6CBHBD6E4EY7X3VYR274GKA","42-savedata-savecloud",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F21-savedata-system\u002F42-savedata-savecloud\u002FSKILL.md",[],[18],"42 savedata savecloud","2026-11-10 10:12:30",false,"# 42-savedata-savecloud — SaveCloud (Internal)\n\n\n## Purpose\n- Android(GPGS) \u002F iOS(iCloud) 공통 클라우드 저장 기능을 제공한다.\n- **SaveCloudManager는 삭제됨.** 모든 클라우드 로직은 `SaveDataManager`의 private\u002Finternal 메서드로 통합되었다.\n- **Editor\u002FGuest에서는 CloudSave를 사용하지 않는다(Failure 반환).**\n- 외부 진입점은 없고, `SaveDataManager` 내부(`SyncGameStorageAsync`\u002F`ResolveConflictAsync`\u002F`SaveGameStorageAsync`)에서만 `SaveDataManager.Instance._initializeCloudAsync(ct)`를 호출한다.\n- public API는 단일 primary save만 다루며, cloud client는 내부적으로 primary cloud slot에 접근한다.\n\n\n## Implementation Location (3-path mirror)\n- UPM (정본):\n  - `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FSaveData\u002FSaveCloud\u002FAppleSaveCloudClient.cs`\n  - `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FSaveData\u002FSaveCloud\u002FSaveCloudTypes.cs`\n  - `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FSaveData\u002FSaveCloud\u002FISaveCloudClient.cs`\n  - `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FSaveData\u002FSaveCloud\u002FSaveCloudClientGoogle.cs`\n  - `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FSaveData\u002FSaveCloud\u002FSaveCloudClient.cs`\n  - `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FSaveData\u002FSaveCloud\u002FSaveCloudCrypto.cs`\n  - `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FSaveData\u002FSaveCloud\u002FSaveCloudPayload.cs`\n  - `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FSaveData\u002FSaveCloud\u002FSaveCloudResult.cs`\n- Packages (sync, 직접 수정 금지):\n  - `framework-cs\u002Fapps\u002FUnityExample\u002FPackages\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002F...`\n\n\n## Assembly Definition (asmdef)\n- 단일 asmdef(`Devian.Samples.MobilePackage`)에 포함되어 MobilePackage 번들 샘플과 함께 설치된다.\n\n\n## Platform behavior\n- Editor: CloudSave는 지원되지 않는다(`CLOUDSAVE_NOCLIENT` Failure 반환). LocalSave만 사용한다.\n- Android: `SaveCloudClientGoogle`(GPGS)가 기본 선택된다.\n- iOS: `AppleSaveCloudClient`(iCloud)가 기본 선택된다.\n\n\n## What it does\n- `SaveDataManager.Instance._initializeCloudAsync(ct)`로 플랫폼별 client 선택 및 초기화를 수행한다.\n- 정책: **Unity Editor에서는 CloudSave를 사용하지 않는다(SaveDataManager가 Failure 반환).**\n- payload 난독화는 `ComplexUtil`로 수행 (경량 바이트 치환, Key\u002FIV 불필요).\n\n\n## Usage\n- **직접 호출 불가.** SaveCloudManager는 삭제됨.\n- `LoginManager`\u002F상위 흐름은 `SaveDataManager` public API(`SyncGameStorageAsync`, `ResolveConflictAsync`, `SaveGameStorageAsync`)만 호출한다.\n- cloud client 초기화\u002F로그인은 `SaveDataManager` 내부 `_initializeCloudAsync` 경로에서 처리된다.\n- Sync\u002FResolve는 `SaveDataManager.SyncGameStorageAsync` \u002F `ResolveConflictAsync`를 통해 간접 사용.\n\n\n## Non-goals\n- 로그인\u002F인증 플로우 → [33-account-manager](..\u002F..\u002F20-account-system\u002F33-account-manager\u002FSKILL.md)\n- 로컬 저장 → [41-savedata-savelocal](..\u002F41-savedata-savelocal\u002FSKILL.md)\n- 트리거\u002F주기, 재시도\u002F충돌 정책 같은 비즈니스 로직\n\n\n## Notes\n- iOS에서는 `AppleSaveCloudClient`(iCloud)가 사용된다.\n- Editor에서는 CloudSave를 사용하지 않으며, `SaveDataManager`가 Failure를 반환한다(SSOT).\n- iCloud 구현 상세: 아래 \"Cloud Save Firebase\" 섹션 참조\n\n\n## Cloud Save Firebase (Firestore) — Inline Reference\n\n`SaveCloudClient`는 Firestore 기반 저장을 제공한다.\n\n- 사용자 식별: `FirebaseAuth` (Anonymous sign-in)\n- 저장 위치:\n  - `users\u002F{uid}\u002Fcloudsave\u002F{slot}`\n- 슬롯 단위 저장:\n  - 문서 1개 = 슬롯 1개\n- 저장 필드(문서):\n  - `Version` (int)\n  - `UpdateTime` (string, 표시\u002F진단용)\n  - `Payload` (string)\n  - `DeviceId` (string)\n  - `SaveSeq` (long, same-device Sync 최신성 판정용)\n  - `Account` (object: `loginType`, `socialUserId`, `lastUpdatedAtUtcMs`)\n  - *(legacy `UtcTime`\u002F`Checksum` 필드는 SaveAsync 시 `FieldValue.Delete`로 제거)*\n\n### Runtime behavior\n\n- `SignInIfNeededAsync`:\n  - Firebase dependencies 체크 후(`CheckAndFixDependenciesAsync`)\n  - `SignInAnonymouslyAsync` 수행\n- `SaveAsync`:\n  - 슬롯 문서에 payload 메타\u002F데이터 저장(`SetAsync(..., MergeAll)`)\n- `LoadAsync`:\n  - 슬롯 문서를 읽어 payload 복원\n  - `SaveCloudResult.NotFound`는 \"클라우드 데이터 없음(첫 저장 전)\"을 의미하며, Sync에서는 실패가 아닌 `Success(null)`로 취급한다.\n- SaveDataManager Sync 규칙:\n  - `Payload` 동일하면 deviceId가 달라도 `Success`\n  - `DeviceId` 동일 + `Payload` 상이하면 `SaveSeq`로 same-device 최신본 자동 선택\n  - `DeviceId` 상이하면 `Conflict` (유저 선택)\n- `DeleteAsync`:\n  - 슬롯 문서 삭제\n\n### How to use (iOS)\n\n정책: **Unity Editor에서는 CloudSave를 사용하지 않는다(LocalSave only).** `SaveDataManager._initializeCloudAsync`가 Failure를 반환한다.\niOS 런타임 빌드 기본 client는 `AppleSaveCloudClient`를 사용한다.\n현재 샘플은 외부 client 주입 API를 노출하지 않는다.\n\n주의:\n- `AppleSaveCloudClient`(iCloud)는 \"설계대로 유지\"하며, 준비 완료 후 iOS 분기 주입을 교체한다.\n\n### Prerequisites (Unity)\n\nFirebase Unity SDK가 프로젝트에 포함되어 있어야 한다.\n\n- 최소 요구(예시):\n  - Firebase Core\n  - Firebase Auth\n  - Firebase Firestore\n\n이 문서는 SDK 설치\u002F프로젝트 설정 자체는 다루지 않는다.\n(설치가 없으면 `Firebase.*` 네임스페이스 관련 컴파일 에러가 발생할 수 있다.)\n\n### Firebase Notes\n\n- `SaveCloudClient`는 `SignInIfNeededAsync`를 통해 클라우드 인증을 자체 처리한다.\n- 플랫폼 네이티브 저장소(GPGS\u002FiCloud)와의 크로스플랫폼 세이브 공유는 비목표다.\n- Firebase 저장소는 \"Editor\u002FiOS 임시\u002F대체 구현\" 또는 \"향후 통합 백엔드\" 옵션으로 사용한다.\n\n\n## Links\n- [10-savedata-manager](..\u002F10-savedata-manager\u002FSKILL.md) (진입점)\n- [50-mobile-package overview](..\u002F..\u002F00-overview\u002FSKILL.md)\n- [41-savedata-savelocal](..\u002F41-savedata-savelocal\u002FSKILL.md)\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F21-savedata-system\u002F42-savedata-savecloud","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add devwinsoft\u002Fdevian --skill 42-savedata-savecloud",{"tool":36,"command":37},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 42-savedata-savecloud",{"tool":39,"command":40},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 42-savedata-savecloud","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F21-savedata-system\u002F42-savedata-savecloud\u002FSKILL.md",true,[44],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"agents\u002Fopenai.yaml","REFERENCE","参考文档",105,"https:\u002F\u002Fgithub.com\u002Fmalinskibeniamin\u002Fskills\u002Fblob\u002Fmain\u002Fcodex-skills\u002Fai-docs\u002Fagents\u002Fopenai.yaml",[51,57,65,73,82,89],{"skillNo":52,"name":53,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[53],{"skillNo":58,"name":59,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[63,64],"archive","90 project archive",{"skillNo":66,"name":67,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[71,72],"management","30 env management",{"skillNo":74,"name":75,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[79,80,81],"push","page","19 page push send",{"skillNo":83,"name":84,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[80,88],"18 page savedata",{"skillNo":90,"name":91,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[80,95],"17 page deobfuscate"]