[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBRE0Y2C829DQX4Z25ADR0":3,"skill-same:01M6CBRE0Y2C829DQX4Z25ADR0":57},{"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":22,"linkOnly":23,"markdownContent":24,"markdownBody":24,"frontMatter":25,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":13,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M6CBRE0Y2C829DQX4Z25ADR0","21-push-setup-google",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\u002F21-push-setup-google\u002FSKILL.md",[],[18,19,20,21],"google","setup","push","21 push setup google","2026-11-10 10:12:30",false,"# 21-push-setup-google — Google Push (FCM Android) Setup\n\nStatus: ACTIVE\nAppliesTo: v10\n\n## 문서 경계 (Scope)\n\n- 이 문서는 **Android 푸시 알림 인프라를 새 프로젝트에 셋업하는 실행 가이드 정본**이다.\n- 포함: Firebase 프로젝트 Android 앱 등록, google-services.json, Gradle 설정, AndroidManifest, NotificationChannel\n- 비포함: PushManager 런타임 구현(→ `10`), Provider 구현 상세(→ `12`)\n\n---\n\n## A. 사전 요구사항 (Prerequisites)\n\n### A1. 필요 도구\n\n| 도구 | 용도 |\n|------|------|\n| Firebase Console | Android 앱 등록 + FCM 활성화 |\n| Unity Editor | Android 빌드 설정 |\n\n### A2. 필요 정보\n\n| 항목 | 예시 | 설명 |\n|------|------|------|\n| `{PACKAGE_NAME}` | `com.devian.framework` | Android 패키지명 |\n| `{FIREBASE_PROJECT_ID}` | `devian-framework-example` | Firebase 프로젝트 ID |\n\n---\n\n## B. Firebase Console — Android 앱 등록\n\n1. [Firebase Console](https:\u002F\u002Fconsole.firebase.google.com) → 프로젝트 → **앱 추가** → Android\n2. Package name: `{PACKAGE_NAME}`\n3. `google-services.json` 다운로드\n\n---\n\n## C. Unity 프로젝트 설정\n\n### C1. google-services.json\n\n1. B에서 다운로드한 `google-services.json`을 Unity 프로젝트에 배치\n2. 경로: `Assets\u002FPlugins\u002FAndroid\u002Fgoogle-services.json`\n3. Unity 빌드 시 Android 프로젝트에 자동 복사됨\n\n### C2. Firebase Unity SDK\n\n- `Firebase Unity SDK` 패키지에서 `FirebaseMessaging.unitypackage` 임포트\n- 또는 UPM: `com.google.firebase.messaging`\n\n### C3. Custom Gradle 설정 (Unity)\n\nUnity → Player Settings → Android → Publishing Settings:\n- **Custom Main Gradle Template** 활성화\n- **Custom Launcher Gradle Template** 활성화\n\n> Firebase Unity SDK가 자동으로 google-services 플러그인과 dependencies를 주입한다.\n> 수동 Gradle 수정이 필요한 경우에만 아래를 참조.\n\n### C4. AndroidManifest — POST_NOTIFICATIONS 권한 (Android 13+)\n\n```xml\n\u003C!-- Assets\u002FPlugins\u002FAndroid\u002FAndroidManifest.xml -->\n\u003Cuses-permission android:name=\"android.permission.POST_NOTIFICATIONS\" \u002F>\n```\n\n> Android 12 이하에서는 이 권한이 자동 부여된다. 선언해도 무해.\n\n### C5. NotificationChannel (Android 8+)\n\nAndroid 8(API 26)부터 알림 채널이 필수다.\n`PushProviderGoogle`에서 앱 시작 시 기본 채널을 생성한다.\n\n채널 설정:\n\n| 항목 | 값 |\n|------|-----|\n| Channel ID | `devian_push_default` |\n| Channel Name | `Push Notifications` |\n| Importance | `HIGH` |\n\n> 채널 ID\u002FName은 프로젝트별로 변경 가능. Provider 내부에서 하드코딩하지 않고 설정 가능하게 구성 권장.\n\n---\n\n## D. FCM 토픽 발송 (Firebase Console)\n\n> 서버 토큰 등록\u002F타겟 발송은 사용하지 않는다. 모든 원격 푸시는 **토픽 기반 발송**만 사용한다.\n\n### D1. FCM v1 API 활성화\n\n1. [Google Cloud Console](https:\u002F\u002Fconsole.cloud.google.com\u002Fapis\u002Flibrary\u002Ffcm.googleapis.com) → Firebase Cloud Messaging API → **사용 설정**\n2. 이미 Firebase 프로젝트에서 활성화된 경우 생략\n\n### D2. 토픽 발송 방법\n\n- **Firebase Console**: Messaging → 새 캠페인 → 토픽 대상 지정 → 발송\n- **Firebase Admin SDK** (기존 Functions에서 필요 시):\n\n```typescript\nimport { getMessaging } from \"firebase-admin\u002Fmessaging\";\n\nawait getMessaging().send({\n  topic: topicId,\n  notification: { title: \"...\", body: \"...\" },\n  data: { \u002F* custom payload *\u002F }\n});\n```\n\n> 토큰 기반 발송(`token: userFcmToken`)은 사용하지 않는다. Firebase Functions\u002FFirestore에 토큰을 저장하지 않는다.\n\n---\n\n## E. 검증 체크리스트\n\n| # | 항목 | 방법 | 기대 결과 |\n|---|------|------|----------|\n| 1 | google-services.json | Unity 빌드 성공 | 에러 없음 |\n| 2 | FCM API 활성화 | GCP Console → API 목록 | Firebase Cloud Messaging API 활성 |\n| 3 | 토큰 획득 | 기기에서 앱 실행, `PushManager.InitializeAsync` | FCM 토큰 로그 출력 |\n| 4 | 원격 푸시 수신 | Firebase Console → Messaging → 테스트 메시지 전송 | 기기에서 알림 수신 |\n| 5 | 토픽 푸시 수신 | 토픽 구독 후 토픽 발송 | 기기에서 알림 수신 |\n| 6 | POST_NOTIFICATIONS | Android 13 기기에서 권한 팝업 | 권한 요청 다이얼로그 표시 |\n\n---\n\n## F. 트러블슈팅\n\n### F1. 토큰 획득 실패\n\n원인: `google-services.json` 누락 또는 패키지명 불일치\n해결: B에서 올바른 패키지명으로 재다운로드\n\n### F2. 알림 미수신 (Android 13+)\n\n원인: `POST_NOTIFICATIONS` 런타임 권한 미요청 또는 거부\n해결: `PushProviderGoogle`에서 권한 요청 로직 확인 (→ `12`)\n\n### F3. 알림 미표시 (Android 8+)\n\n원인: NotificationChannel 미생성\n해결: 앱 시작 시 `devian_push_default` 채널 생성 확인 (→ `12`)\n\n### F4. FCM v1 API 비활성\n\n원인: 레거시 서버 키 사용 또는 API 미활성화\n해결: D1 실행. FCM v1 HTTP API만 사용한다 (레거시 서버 키 금지).\n\n---\n\n## Related\n\n- [12-push-provider-google](..\u002F12-push-provider-google\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\u002F21-push-setup-google","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":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add devwinsoft\u002Fdevian --skill 21-push-setup-google",{"tool":39,"command":40},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 21-push-setup-google",{"tool":42,"command":43},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 21-push-setup-google","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F52-push-system\u002F21-push-setup-google\u002FSKILL.md",true,[47,53],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"agents\u002Fopenai.yaml","REFERENCE","参考文档",121,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgit-commit\u002Fagents\u002Fopenai.yaml",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Fprivate-data.md",5204,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgit-commit\u002Freferences\u002Fprivate-data.md",[58,64,72,80,88,95],{"skillNo":59,"name":60,"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":61,"categories":62,"keywords":63,"publishedAt":22},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[60],{"skillNo":65,"name":66,"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":67,"categories":68,"keywords":69,"publishedAt":22},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[70,71],"archive","90 project archive",{"skillNo":73,"name":74,"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":75,"categories":76,"keywords":77,"publishedAt":22},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[78,79],"management","30 env management",{"skillNo":81,"name":82,"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":83,"categories":84,"keywords":85,"publishedAt":22},"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",[],[20,86,87],"page","19 page push send",{"skillNo":89,"name":90,"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":91,"categories":92,"keywords":93,"publishedAt":22},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[86,94],"18 page savedata",{"skillNo":96,"name":97,"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":98,"categories":99,"keywords":100,"publishedAt":22},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[86,101],"17 page deobfuscate"]