Community이미지github.com

store-pack

앱의 Google Play 및 App Store 제출용 패키지(아이콘, 정확한 스토어 크기의 프레임 스크린샷, 기능 그래픽, 글자 수 제한이 적용된 리스팅 텍스트, 콘솔 양식 답변, 차단 요소 분석)를 프로젝트 내 store/ 폴더에 생성합니다. 앱을 'Play Store / App Store에 제출 가능한 상태'로 만들거나 스토어 에셋, 리스팅, 콘솔 양식 답변을 준비하라는 요청을 받았을 때 사용하세요.

store-pack란 무엇인가요?

이 SKILL은 프로젝트를 앱 스토어 제출 준비 상태로 만드는 end-to-end 자동화 도구입니다. 사용자가 'Play Store' 또는 'App Store'에 앱을 등록해야 할 때, store-pack은 아이콘, 기능 그래픽, 정확한 치수의 프레임 스크린샷, 글자 수 제한을 준수한 마케팅 텍스트, 콘솔 답변 템플릿, 그리고 제출 전 해결해야 할 차단 요소들을 한 번에 생성하여 project_root/store/ 폴더에 정리합니다. Flutter 앱 위젯 테스트 하네스를 활용해 고해상도 프레임 스크린샷을 렌더링하며, 웹/데스크톱/하이브리드 앱의 경우 실제 서버와 브라우저 자동화 도구를 결합하여 사용합니다. 또한 개인정보처리방침, 결제 정책(IAP/Play Billing), 계정 삭제 기능, 데이터 안전성 답변, 출시 서명, 테스터 접근 등 주요 스토어 차단 요소를 자동으로 진단하고, 제출 완료나 커밋은 절대 수행하지 않아 사용자가 최종 컨트롤을 유지합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nowfalsalahudeen/store-pack/tree/HEAD

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

store-pack은(는) 무엇을 하나요?

프로젝트 루트에 store/ 폴더를 생성합니다: 아이콘, 프레임이 적용된 스크린샷, 기능 그래픽, 리스팅 텍스트, 콘솔 양식 답변, 그리고 차단 요소 분석 README. 절대 제출, 커밋 또는 배포하지 않으며, 해당 작업은 사용자에게 맡깁니다.

요구 사항: Python 3, Flutter SDK (이미지 합성 도구는 Flutter 테스트이며 앱 자체는 필요하지 않음), macOS (이미지 검사 및 아이콘 크기에 sips 사용). 원시 스크린샷은 앱 자체에서 제공됩니다.

워크플로우

  1. 앱의 실제 정보를 검사합니다 (절대 가정하지 않음): 패키지/번들 ID, 버전, 권한 (AndroidManifest, Info.plist), pubspec, Cargo.toml 또는 package.json 내 SDK (광고, 분석, 충돌 리포팅, 결제, 로그인), 계정 및 결제 작동 방식, 개인정보처리방침 및 지원 URL, 서명 구성, 디바이스 패밀리. 프로젝트 자체 기여자 문서의 규칙도 읽습니다.
  2. 원시 스크린샷. 실제 앱에서 현실적인 가상 데이터로 캡처합니다. 절대 프로덕션 데이터나 프로덕션 계정을 사용하지 마십시오.
    • Flutter: 실제 폰트를 사용한 위젯 테스트 하네스 (debugDisableShadows = false, 그렇지 않으면 그림자가 딱딱한 외곽선으로 렌더링됨); 전화기 440x956 at 3x = 1320x2868.
    • 웹, 데스크톱 또는 하이브리드 앱: 앱 자체 서버를 스크래치 데이터베이스에서 실행하고, API를 통해 시드한 후 브라우저 자동화 도구로 구동합니다. 별도의 브라우저 컨텍스트에서 deviceScaleFactor 3 (전화기, 뷰포트 440x956) 또는 2 (태블릿, 1032x1376)을 사용하고, 각 촬영 전에 *::-webkit-scrollbar{display:none!important}*{scrollbar-width:none!important}로 스크롤바를 숨깁니다.
    • 자신의 스크래치 포트에서 수신 대기 중인 프로세스만 종료합니다 (lsof -ti tcp:PORT -sTCP:LISTEN), 이름으로 종료하지 마십시오.
    • 각 스크린샷을 눈으로 확인합니다. 해당 너비에서 깨진 스크린샷은 폐기하고 사용자에게 알립니다.
  3. store/app.json (참조: docs/config-reference.md), 그런 다음 python3 scripts/make_pack.py store/app.json을 실행합니다. 이 명령은 스크린샷을 브랜드 그라데이션 배경에 캡션과 함께 프레임 처리하고, 기능 그래픽과 아이콘을 빌드하며, scripts/check_pack.py를 실행합니다.
    • 아이콘: 일반적으로 둥근 모서리나 텍스트가 내장된 아트만 존재합니다; icon 작업은 마크를 평평한 전체 채움 배경에 크롭합니다. 사용자에게 벡터 또는 깨끗한 1024px 소스가 여전히 필요하다고 알려주십시오.
  4. 리스팅 텍스트: store/listings.json, 그런 다음 python3 scripts/write_listings.py store/listings.json을 실행합니다 (fastlane 레이아웃, 제한이 적용됨). 빌드가 실제로 하는 일과 플랫폼 빌드에 포함된 내용만 설명합니다.
  5. 문서: store/README.md (첫 번째 차단 요소 표), google-play/console-forms.md, app-store/connect-forms.md.

스토어 사양 (콘솔에서 확인; Apple 페이지는 로드되지 않을 수 있음)

  • Play: 아이콘 512px (<= 1 MB); 기능 그래픽 1024x500, 알파 채널 없음; 2-8장의 전화기 스크린샷, 각각 짧은 변 320-3840px, 긴 변 <= 짧은 변의 2배 (1080x1920 사용); 선택 사항: 7"/10" 태블릿 스크린샷 (1200x1920, 1600x2560); 제목 30자, 짧은 설명 80자, 전체 설명 4000자.
  • App Store: iPhone 6.9" 1320x2868 (필수), 6.5" 1284x2778; iPad 지원 시 iPad 13" 2064x2752; 각각 최대 10장; 알파 채널 없음; 아이콘 1024px, 알파 채널 없음; 이름 30자, 부제목 30자, 프로모션 텍스트 170자, 키워드 100자.
  • 두 스토어 모두 알파 채널이 있는 스크린샷을 거부합니다; 합성 도구는 RGB PNG를 작성합니다.

모든 앱에서 찾아야 할 차단 요소 (경험 기반)

  • 결제: 앱 내에서 웹 결제 제공자를 통해 디지털 잠금 해제 또는 라이선스를 판매하는 것은 Play Billing / Apple IAP 규칙을 위반합니다. iOS의 경우 구매 UI 없이 출시하거나 StoreKit을 추가합니다. 모바일 빌드에 가격이나 구매 링크를 포함하지 마십시오.
  • 계정 삭제: 계정을 생성하는 모든 앱은 인앱 삭제 경로와 (Play의 경우) 이를 설명하는 공개 웹 URL이 필요합니다.
  • Apple로 로그인: iOS에서 Google 또는 다른 타사 로그인이 제공되는 모든 곳에 필요합니다.
  • 릴리스에 남아 있는 테스트 광고 ID; 실제 ID 누락.
  • Play App Signing: Play의 앱 서명 SHA-1을 Google OAuth Android 클라이언트에 추가하지 않으면 Play 설치에서 로그인이 실패합니다.
  • 제한된 권한 또는 선언된 권한: REQUEST_IGNORE_BATTERY_OPTIMIZATIONS, 포그라운드 서비스 유형 (선언 및 비디오 필요), 위치 ( maxSdkVersion 사용 시에도), 블루투스 neverForLocation.
  • 리뷰어 접근: 서버나 라이선스가 필요한 앱은 데모 서버, PIN 및 단계가 필요합니다 (Play 앱 접근, Apple 가이드라인 2.1).
  • 개인정보처리방침 URL이 존재해야 하며, 사업자 상태 (EU/UK)를 위한 연락처 주소 및 전화번호.
  • 릴리스 서명 구성됨; 버전 업데이트; Play용 AAB; Apple 팀 및 번들 ID; ITSAppUsesNonExemptEncryption; 개인정보 매니페스트.
  • 새 개인 Play 계정: 프로덕션 전에 12명 테스터, 14일 클로즈드 테스트가 필요합니다.
  • 데이터 안전성: '일시적으로만 처리됨'은 메모리에서만 사용되고 저장되지 않는 데이터 (예: AI 서비스로 전송된 사진)에만 해당합니다. 서버에 보관된 이메일이나 ID는 일시적이지 않습니다. 광고 ID: 광고 또는 전환 SDK가 없고 광고 ID 권한이 제거된 경우에만 '아니요'로 답변합니다.
  • 대상 연령: 진정으로 어린이를 위한 앱이 아니라면 18+.
  • 최소 크기 슈링커 (R8)는 선택적 라이브러리에서 실패할 수 있음: 릴리스 빌드가 'Missing classes'로 실패하면 명명된 패키지에 -dontwarn 규칙을 추가합니다.

파일

  • scripts/make_pack.py가 모든 것을 실행합니다; scripts/compose/는 Flutter 합성 도구입니다 (STORE_JOBS=jobs.json flutter test); scripts/build_icons.py; scripts/check_pack.py; scripts/write_listings.py.
  • templates/app.example.json, templates/listings.example.json - 복사할 설정 파일. examples/ - 가상 앱과 그 출력을 포함한 완전한 작업 예제.
  • docs/ - 시작 가이드, 설정 참조, 작동 방식 설명.

관련 스킬