[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBRBTNHVN4HC95NV4VTM5F":3,"skill-same:01M6CBRBTNHVN4HC95NV4VTM5F":60},{"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":21,"linkOnly":22,"markdownContent":23,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":13,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M6CBRBTNHVN4HC95NV4VTM5F","20-push-setup-apple",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\u002F52-push-system\u002F20-push-setup-apple\u002FSKILL.md",[],[18,19,20],"setup","push","20 push setup apple","2026-11-10 10:12:30",false,"# 20-push-setup-apple — Apple Push (APNs + FCM iOS) Setup\n\nStatus: ACTIVE\nAppliesTo: v10\n\n## 문서 경계 (Scope)\n\n- 이 문서는 **iOS 푸시 알림 인프라를 새 프로젝트에 셋업하는 실행 가이드 정본**이다.\n- 포함: APNs Key 생성, Firebase 프로젝트 iOS 앱 등록, Xcode Capability, GoogleService-Info.plist, CocoaPods\u002FSPM 설정\n- 비포함: PushManager 런타임 구현(→ `10`), Provider 구현 상세(→ `11`)\n\n---\n\n## A. 사전 요구사항 (Prerequisites)\n\n### A1. 필요 도구\n\n| 도구 | 용도 |\n|------|------|\n| Xcode | iOS 빌드 + Capability 설정 |\n| Apple Developer Account | APNs Key 생성 |\n| Firebase Console | iOS 앱 등록 + APNs Key 업로드 |\n\n### A2. 필요 정보\n\n| 항목 | 예시 | 설명 |\n|------|------|------|\n| `{BUNDLE_ID}` | `com.devian.framework` | iOS 번들 ID |\n| `{FIREBASE_PROJECT_ID}` | `devian-framework-example` | Firebase 프로젝트 ID |\n| `{TEAM_ID}` | `ABC123DEF4` | Apple Developer Team ID |\n| `{APNS_KEY_ID}` | `XYZ789` | APNs Auth Key ID |\n\n---\n\n## B. Apple Developer — APNs Key 생성\n\n1. [Apple Developer](https:\u002F\u002Fdeveloper.apple.com\u002Faccount\u002Fresources\u002Fauthkeys\u002Flist) → Keys → **+** 버튼\n2. Key Name: `FCM APNs Key` (자유)\n3. **Apple Push Notifications service (APNs)** 체크\n4. **Continue** → **Register**\n5. `.p8` 파일 다운로드 (1회만 가능, 안전 보관)\n6. **Key ID** 기록 → `{APNS_KEY_ID}`\n\n> APNs Key는 Certificate 방식이 아닌 **Token 기반(.p8)** 을 사용한다. Certificate는 만료 관리가 필요하므로 금지.\n\n---\n\n## C. Firebase Console — iOS 앱 등록 + APNs Key 업로드\n\n### C1. iOS 앱 등록\n\n1. [Firebase Console](https:\u002F\u002Fconsole.firebase.google.com) → 프로젝트 → **앱 추가** → iOS\n2. Bundle ID: `{BUNDLE_ID}`\n3. `GoogleService-Info.plist` 다운로드\n\n### C2. APNs Key 업로드\n\n1. Firebase Console → 프로젝트 설정 → **Cloud Messaging** 탭\n2. iOS 앱 섹션 → **APNs Authentication Key** → **Upload**\n3. `.p8` 파일 업로드\n4. Key ID: `{APNS_KEY_ID}`\n5. Team ID: `{TEAM_ID}`\n\n---\n\n## D. Xcode 프로젝트 설정\n\n### D1. Capability 추가\n\n1. Xcode → Target → **Signing & Capabilities**\n2. **+ Capability** → **Push Notifications** 추가\n3. **+ Capability** → **Background Modes** 추가 → **Remote notifications** 체크\n\n### D2. GoogleService-Info.plist\n\n1. C1에서 다운로드한 `GoogleService-Info.plist`를 Unity 프로젝트에 배치\n2. 경로: `Assets\u002FPlugins\u002FiOS\u002FGoogleService-Info.plist`\n3. Unity 빌드 시 Xcode 프로젝트에 자동 복사됨\n\n### D3. Unity iOS 빌드 후처리 (PostProcessBuild)\n\n- `Push Notifications` Capability는 Unity 에디터에서 직접 추가할 수 없음\n- `PostProcessBuild` 스크립트로 자동 추가:\n\n```csharp\n\u002F\u002F Editor\u002FPushNotificationPostProcess.cs\n#if UNITY_IOS\nusing UnityEditor;\nusing UnityEditor.Callbacks;\nusing UnityEditor.iOS.Xcode;\n\nnamespace Devian\n{\n    public static class PushNotificationPostProcess\n    {\n        [PostProcessBuild(100)]\n        public static void OnPostProcessBuild(BuildTarget target, string path)\n        {\n            if (target != BuildTarget.iOS) return;\n\n            var projPath = PBXProject.GetPBXProjectPath(path);\n            var proj = new PBXProject();\n            proj.ReadFromFile(projPath);\n\n            var mainTarget = proj.GetUnityMainTargetGuid();\n            var manager = new ProjectCapabilityManager(\n                projPath, \"Entitlements.entitlements\", null, mainTarget);\n\n            manager.AddPushNotifications(false);\n            manager.AddBackgroundModes(BackgroundModesOptions.RemoteNotifications);\n            manager.WriteToFile();\n        }\n    }\n}\n#endif\n```\n\n---\n\n## E. Firebase iOS SDK (Unity)\n\n- `Firebase Unity SDK` 패키지에서 `FirebaseMessaging.unitypackage` 임포트\n- 또는 UPM: `com.google.firebase.messaging`\n\n---\n\n## F. 검증 체크리스트\n\n| # | 항목 | 방법 | 기대 결과 |\n|---|------|------|----------|\n| 1 | APNs Key 등록 | Firebase Console → Cloud Messaging | Key ID 표시 |\n| 2 | GoogleService-Info.plist | Xcode 프로젝트 내 파일 존재 | 빌드 성공 |\n| 3 | Push Capability | Xcode → Signing & Capabilities | Push Notifications 존재 |\n| 4 | Background Modes | Xcode → Signing & Capabilities | Remote notifications 체크 |\n| 5 | 토큰 획득 | 기기에서 앱 실행, `PushManager.InitializeAsync` | FCM 토큰 로그 출력 |\n| 6 | 원격 푸시 수신 | Firebase Console → Messaging → 테스트 메시지 전송 | 기기에서 알림 수신 |\n\n---\n\n## G. 트러블슈팅\n\n### G1. 토큰 획득 실패\n\n원인: APNs Key 미업로드 또는 Push Capability 미설정\n해결: C2 + D1 재확인\n\n### G2. 원격 푸시 미수신 (foreground)\n\n원인: iOS는 기본적으로 foreground에서 알림 배너를 표시하지 않음\n해결: `UNUserNotificationCenter.willPresentNotification`에서 표시 옵션 설정 필요 (Provider 책임)\n\n### G3. Provisional 권한 후 알림 미표시\n\n원인: Provisional은 알림 센터에만 조용히 전달됨\n해결: 정상 동작. Full 권한 요청은 사용자 인터랙션 후 수행\n\n---\n\n## Related\n\n- [11-push-provider-apple](..\u002F11-push-provider-apple\u002FSKILL.md) — 런타임 Provider 구현\n- [10-push-manager](..\u002F10-push-manager\u002FSKILL.md) — PushManager 설계\n- [03-ssot](..\u002F03-ssot\u002FSKILL.md) — Push 시스템 SSOT\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F52-push-system\u002F20-push-setup-apple","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":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add devwinsoft\u002Fdevian --skill 20-push-setup-apple",{"tool":38,"command":39},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 20-push-setup-apple",{"tool":41,"command":42},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 20-push-setup-apple","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F52-push-system\u002F20-push-setup-apple\u002FSKILL.md",true,[46,52,56],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",105,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgherkin-authoring\u002Fagents\u002Fopenai.yaml",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fbest-practices.md",12042,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgherkin-authoring\u002Freferences\u002Fbest-practices.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fsyntax-reference.md",8625,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgherkin-authoring\u002Freferences\u002Fsyntax-reference.md",[61,67,75,83,91,98],{"skillNo":62,"name":63,"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":64,"categories":65,"keywords":66,"publishedAt":21},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[63],{"skillNo":68,"name":69,"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":70,"categories":71,"keywords":72,"publishedAt":21},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[73,74],"archive","90 project archive",{"skillNo":76,"name":77,"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":78,"categories":79,"keywords":80,"publishedAt":21},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[81,82],"management","30 env management",{"skillNo":84,"name":85,"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":86,"categories":87,"keywords":88,"publishedAt":21},"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",[],[19,89,90],"page","19 page push send",{"skillNo":92,"name":93,"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":94,"categories":95,"keywords":96,"publishedAt":21},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[89,97],"18 page savedata",{"skillNo":99,"name":100,"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":101,"categories":102,"keywords":103,"publishedAt":21},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[89,104],"17 page deobfuscate"]