Community이미지github.com

hmos-appgallery-poster

HarmonyOS 앱용 AppGallery 프로모션 이미지/스토어 스크린샷/상세 페이지 홍보 이미지 제작 도구입니다. 사용자가 '홍보 이미지', '프로모션 배너', '스토어 스크린샷' 등을 요청할 때 사용합니다.

hmos-appgallery-poster란 무엇인가요?

이 스킬은 HarmonyOS 프로젝트에서 AppGallery Connect에 직접 업로드할 수 있는 프로모션 이미지 세트(앱 상세 페이지 상단 캐러셀 소개 스크린샷/홍보 이미지)를 생성합니다. 개발자는 코드로 배경을 직접 그리는 대신, Pollinations나 Canva 같은 AI 이미지 생성 도구를 활용해 프롬프트를 작성하고 무료 이미지 모델을 호출하여 배경을 생성합니다. 이후 Python과 Pillow 라이브러리를 이용해 시뮬레이터 스크린샷, 배경 이미지, 텍스트를 합성하여 최종 프로모션 이미지를 만듭니다. 또한, 네트워크 검색을 통해 최신 AppGallery 이미지 규격을 확인하며, 휴대폰(세로 5장), 태블릿(가로 2-3장), PC(16:9 2장) 등 다양한 디바이스용 이미지를 생성합니다. 모든 결과물은 프로젝트 루트의 `promotion/` 디렉토리에 저장되며, 소스 코드를 오염시키지 않습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Huangzihengcmd/hmos-appgallery-poster/tree/HEAD

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

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

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

문서

HarmonyOS 앱 스토어 프로모션 이미지 제작

현재 HarmonyOS 프로젝트를 위해 AppGallery Connect에 직접 업로드할 수 있는 프로모션 이미지 세트(앱 상세 페이지 상단 캐러셀 소개 스크린샷/홍보 이미지)를 생성합니다.

기본 원칙

  1. 배경 일러스트는 코드로 그리지 않습니다. 사람 디자이너처럼 행동합니다: 프롬프트 작성 → 무료 이미지 생성 모델 호출 → 결과 확인 → 만족스럽지 않으면 시드(seed) 변경/프롬프트 수정 후 재시도(3단계 참조). 코드는 합성(이미지 결합, 둥근 모서리, 텍스트 배치, 크기 조정 내보내기)에만 사용합니다.
  2. 규격은 먼저 온라인으로 확인한 후 작업을 시작합니다. 이 파일에 포함된 기본 규격은 최신 버전이 아닐 수 있으므로, 각 작업 시작 시 반드시 1단계를 수행합니다.
  3. 기본적으로 '표준 프로모션 이미지 세트'를 생성합니다: 휴대폰 세로 5장(최대 8장) + 태블릿 가로 2-3장 + PC 16:9 2장. 사용자 요청이 있으면 그에 따릅니다.
  4. 모든 결과물은 <프로젝트 루트>/promotion/ 디렉토리에 저장하며, 프로젝트 소스 코드 디렉토리를 오염시키지 않습니다.
  5. 다운로드한 자료, 생성된 이미지 등 임시 파일은 프로젝트 디렉토리에 저장하며, 시스템 디스크의 Temp 디렉토리에는 저장하지 않습니다.

작업 흐름

0단계: 앱 분석

다음 파일을 읽어 정보를 추출합니다(사용자에게 묻지 말고 코드를 직접 읽습니다):

  • AppScope/app.json5: bundleName, icon, label
  • entry/src/main/module.json5: abilities, 권한, 디바이스 유형(tablet/pc 지원 여부)
  • AppScope/resources/base/element/string.json 및 resources/zh/: 앱 이름
  • entry/src/main/resources/base/profile/main_pages.json + pages/ 아래 각 페이지: 기능 목록
  • resources/base/media/ 아래 아이콘: 색상 추출 아이디어를 사용하여 브랜드 주요 색상 결정(육안으로 이미지를 보고 주요 색조 판단 가능)

promotion/plan.md를 생성합니다. 여기에는 앱 이름, 한 줄 설명, 3-5개의 핵심 기능(각 프로모션 이미지가 하나의 기능에 해당), 타겟 사용자, 브랜드 주요 색상(hex), 스타일 선택이 포함됩니다.

1단계: 온라인 규격 확인 (필수)

websearch/webfetch를 사용하여 최신 요구 사항을 검색하고 확인합니다. 검색어 예시:

  • AppGallery 프로모션 이미지 크기 규격 앱 정보
  • Huawei AppGallery 앱 소개 이미지 스크린샷 요구 사항
  • developer.huawei.com 테마 디자인 가이드 및 규격(HarmonyOS 디자인 규격)
  • AppGallery Connect 이미지 규격 업로드

화웨이 공식 문서(developer.huawei.com / AppGallery Connect 도움말 센터)를 기준으로 삼습니다. 공식 페이지가 JS 렌더링으로 인해 크롤링되지 않으면, 위 키워드로 보조 신뢰 출처를 검색하여 교차 검증합니다.

기본 규격표 (2026년 11월 확인 버전, 온라인 재확인 필요):

자료크기/비율형식 및 제한 사항
휴대폰 프로모션 이미지 (세로)1080×1920 / 1080×2340 / 1080×2400 (9:16 ~ 9:19.5)JPG/PNG, 개별 2MB 이하, 3-8장
태블릿 프로모션 이미지 (가로)2560×1440 (16:9) 또는 3:2동일
PC 프로모션 이미지1920×1080 (16:9)동일
앱 스토어 아이콘216×216 (AGC 백엔드) / 512×512PNG, 둥근 모서리는 백엔드에서 처리
HarmonyOS 데스크톱 아이콘 전경/배경1024×1024PNG, 투명, 자체 둥근 모서리/테두리/그림자 금지

심사 위반 사항: 이미지에 iOS / iPhone / Apple Store / 경쟁 앱 스토어 명칭 또는 디바이스 외관이 포함되어서는 안 됩니다. 실제 기능과 일치하지 않는 허위 광고는 금지됩니다. 국기, 정치적으로 민감한 요소를 포함하지 마십시오. 스크린샷에 개인 정보가 노출되지 않도록 하십시오.

확인 결과를 promotion/plan.md에 기록합니다.

2단계: 시뮬레이터 스크린샷 (제품 소개 이미지 자료)

  1. devecocli devices 명령어로 디바이스를 확인합니다. 디바이스가 없으면 시뮬레이터를 시작합니다.
  2. 프로젝트가 빌드되지 않았으면 devecocli build를 실행합니다. 그런 다음 devecocli run --skip-build로 설치 및 실행합니다.
  3. 페이지별로 스크린샷을 촬영합니다(기본적으로 hdc를 사용하여 스크린샷을 캡처하며, verify_ui는 사용하지 않습니다. UI 검증 도구는 사용자가 명시적으로 UI 검증을 요청할 때만 사용합니다):
hdc shell "snapshot_display -f /data/local/tmp/shot_1.jpeg"
hdc file recv /data/local/tmp/shot_1.jpeg .\promotion\shots\shot_1.jpeg
  1. 주요 기능에 따라 스크린샷을 계획합니다: 각 핵심 기능 페이지당 최소 1장. 해당 페이지로 이동한 후 다음 스크린샷을 촬영합니다.
  2. 스크린샷의 너비가 1080이 아닌 경우, plan.md에 실제 해상도를 기록하고 합성 시 비율에 맞게 크기를 조정합니다.

3단계: AI 이미지 생성 – 사람의 그림 모방 (다중 스타일 배경)

방식 A (기본값, 무료, API 키 불필요): Pollinations 직접 연결

URL 형식(prompt는 URL 인코딩 필수, 영어 사용):

https://image.pollinations.ai/prompt/{인코딩된_프롬프트}?width=1024&height=2048&seed={n}

2026년 11월 실제 테스트 시 주의사항:

  • nologo=true를 포함하지 마십시오. 이 매개변수는 유료로 전환되었습니다(402 Payment Required 반환). model=flux도 포함하지 말고 기본 모델을 사용하십시오.
  • 무료 채널에는 속도 제한이 있습니다. 첫 번째 요청은 종종 503 오류를 반환합니다(Retry after 10s 메시지). 12초 동안 기다렸다가 재시도하며, 최대 5회 시도하면 일반적으로 성공합니다.
$prompt = [uri]::EscapeDataString("soft gradient fluid abstract background, deep blue and cyan, smooth flowing shapes, no text, no watermark")
foreach ($i in 1..5) {
  Start-Sleep -Seconds 12
  try {
    Invoke-WebRequest -Uri "https://image.pollinations.ai/prompt/$prompt`?width=1024&height=2048&seed=42" -OutFile .\promotion\bg\style1_s42.png -TimeoutSec 120
    break
  } catch { }
}

사람처럼 반복 수행: 각 스타일별로 2-3개의 시드(seed)를 생성하고, 하나씩 확인합니다(이미지 품질을 육안으로 판단). 만족스럽지 않으면 프롬프트를 수정하거나 시드를 변경하여 다시 생성합니다. 한 번에 수십 장을 생성하지 마십시오.

방식 B (대체, 사용자가 '사람처럼 웹페이지를 조작'하기를 요청할 때): 브라우저 자동화

devoco.json에 브라우저 MCP(예: @playwright/mcp)가 구성된 경우, 무료 이미지 생성 사이트(pollinations.ai 등)를 열고 사람처럼 행동합니다: 프롬프트 입력 → 이미지 생성 대기 → promotion/bg/에 다운로드. 해당 MCP가 없으면 방식 A를 직접 사용합니다.

방식 C: 환경에 이미 구성된 이미지 생성 MCP/커넥터(예: Canva 커넥터 내장 AI 이미지 생성). 존재하는 경우 방식 A보다 우선합니다.

스타일 라이브러리 (plan.md에서 앱 유형에 따라 3-5개 선택, 각 스타일은 1-2개의 프로모션 이미지에 해당):

스타일적용프롬프트 키워드
그라데이션 플루이드도구/기술/AIsoft gradient fluid abstract, smooth flowing shapes
미니멀리스트 기하생산성/비즈니스minimalist flat design, geometric shapes, clean, pastel
3D 카툰 렌더링어린이/교육/캐주얼cute 3d cartoon render, soft lighting, playful
자연 풍경 사진라이프스타일/건강/여행natural landscape photography, golden hour, bokeh
국풍 일러스트콘텐츠/문화chinese traditional illustration, modern guochao style
다크 네온게임/e스포츠dark neon glow, cyberpunk, dramatic lighting
소프트 디퓨즈 라이트소셜/감성soft diffuse light, dreamy pastel, warm

프롬프트 철칙: 반드시 no text, no watermark를 포함해야 합니다. 이미지 속 텍스트는 4단계에서 배치하며, 이미지 생성 모델의 텍스트는 반드시 깨집니다. 색상 조합은 브랜드 주요 색상에 맞춰 작성합니다.

4단계: 제품 소개 이미지 합성 (HarmonyOS 휴대폰 외곽선 + 텍스트)

Python + Pillow로 합성합니다(Pillow가 없으면 pip install pillow 실행). 각 세로 이미지 구조:

┌─────────────────┐  1080×2400
│  앱 이름 (큰 제목)   │  ← 제목 영역: 앱 이름 + 한 줄 핵심 기능, 주요 색상/흰색 텍스트
│  한 줄 핵심 기능     │
│ ╭─────────────╮ │
│ │ HarmonyOS 휴대폰 외곽선 │ │  ← 본체: 브랜드 주요 색상 그라데이션 둥근 모서리 사각형(r≈140px),
│ │ ┌─────────┐ │ │     테두리 하이라이트, 내부에 2단계 스크린샷 삽입(동일하게 둥근 모서리로 자름)
│ │ │ 시뮬레이터 스크린샷│ │ │
│ │ └─────────┘ │ │
│ ╰─────────────╯ │
│  icon + 앱 이름    │  ← 하단 브랜드 영역
└─────────────────┘

최소한의 사용 가능한 기본 코드(필요에 따라 매개변수를 변경하고, 그대로 복사하여 사용하지 마십시오):

from PIL import Image, ImageDraw, ImageFilter, ImageFont

W, H = 1080, 2400
bg = Image.open("bg/style1_s42.png").convert("RGB")
bg = bg.resize((W, H))  # 배경을 꽉 채움, 필요시 먼저 crop한 후 resize하여 비율 유지

img = bg.copy()
draw = ImageDraw.Draw(img)

# HarmonyOS 휴대폰 외곽선
frame_w, frame_h = 760, 1560
fx, fy = (W - frame_w) // 2, 560
body = Image.new("RGB", (frame_w, frame_h), (20, 20, 25))
mask = Image.new("L", (frame_w, frame_h), 0)
ImageDraw.Draw(mask).rounded_rectangle([0, 0, frame_w, frame_h], radius=110, fill=255)
img.paste(body, (fx, fy), mask)

shot = Image.open("shots/shot_1.jpeg").convert("RGB")
shot = shot.resize((frame_w - 24, int((frame_w - 24) * shot.height / shot.width)))
if shot.height > frame_h - 24:
    shot = shot.crop((0, 0, shot.width, frame_h - 24))
smask = Image.new("L", shot.size, 0)
ImageDraw.Draw(smask).rounded_rectangle([0, 0, shot.width, shot.height], radius=98, fill=255)
img.paste(shot, (fx + 12, fy + 12), smask)
draw.rounded_rectangle([fx, fy, fx + frame_w, fy + frame_h], radius=110, outline=(255, 255, 255), width=4)

# 텍스트 (한글 폰트: Windows는 msyh.ttc 사용, HarmonyOS Sans가 설치되어 있으면 우선 사용)
font_big = ImageFont.truetype("C:/Windows/Fonts/msyh.ttc", 88)
font_sub = ImageFont.truetype("C:/Windows/Fonts/msyh.ttc", 46)
draw.text((W // 2, 300), "앱 이름", font=font_big, fill=(255, 255, 255), anchor="mm")
draw.text((W // 2, 410), "한 줄 핵심 기능", font=font_sub, fill=(230, 230, 230), anchor="mm")

img.save("final/phone/poster_1.png", optimize=True)

요구 사항:

  • 태블릿/PC 버전은 가로 구성으로 변경: 스크린샷은 왼쪽 또는 오른쪽에 배치하고, 텍스트 영역은 반대쪽에 배치합니다. 해상도는 1단계 확인 결과에 따릅니다.
  • 내보낸 후 각 이미지를 확인: 개별 2MB 이하(초과 시 JPG quality=88로 변환하거나 다운샘플링), 텍스트가 주요 대상을 가리지 않음, 둥근 모서리가 자연스러움.
  • 텍스트는 plan.md의 핵심 기능에서 추출하여 짧은 문장으로 만듭니다(줄당 ≤12자). 허위 기능 설명을 금지합니다.

5단계: 선택적 개선 – 웹 그래픽 도구 (Canva 커넥터 등)

Canva에는 풍부한 내장 그래픽 자산이 있습니다: 기성 템플릿(앱 홍보/휴대폰 포스터 유형), 도형, 일러스트 스티커, 아이콘, 폰트, 텍스트 레이아웃. AI는 Canva 커넥터를 사용하여 이러한 내장 그래픽을 직접 활용하여 정밀하게 다듬을 수 있으며, 처음부터 직접 그릴 필요가 없습니다.

  1. 프로젝트 deveco.json / 전역 구성의 mcp 섹션에 Canva, Figma, MasterGo, Pixso 등 디자인 커넥터가 있는지 확인합니다.
  2. Canva가 있는 경우: 내장 템플릿을 검색합니다(키워드 "app promotion" / "휴대폰 포스터") → 3단계 AI 배경과 2단계 스크린샷을 템플릿 자리 표시자 영역에 교체 → 내장 그래픽으로 레이아웃과 텍스트를 미세 조정 → promotion/final/로 내보냅니다. Canva의 기성 디자인 자산을 활용하므로 속도가 빠르고 전문적입니다.
  3. Canva가 없는 경우: 이 단계를 건너뜁니다. 기본 흐름(무료 이미지 생성 + 합성)으로도 충분합니다. 제공 시 사용자에게 Canva 커넥터를 구성하면 템플릿을 통한 정밀 다듬기 기능을 사용할 수 있다고 안내합니다.

위치: 이 단계는 선택적이며, 결과물을 한층 더 개선하는 역할을 합니다. 프로모션 이미지의 주요 결과물은 항상 3단계 무료 이미지 생성(Pollinations) + 4단계 코드 합성을 기준으로 하며, Canva는 커넥터가 존재하고 사용자가 더 정교한 템플릿 기반 레이아웃을 필요로 할 때만 사용합니다.

6단계: 자체 점검 및 전달

promotion/final/의 각 이미지에 대해 다음을 확인합니다:

  • 해상도 = 1단계에서 확인한 규격(크기, 비율)
  • 형식 JPG/PNG, 개별 2MB 이하
  • 휴대폰용 3-8장, 각 이미지는 하나의 핵심 기능에 해당
  • iOS/Apple/경쟁 앱 명칭 없음, 워터마크 없음, 깨진 텍스트 없음
  • 한글 텍스트에 오타 없음, 앱의 실제 기능과 일치

디렉토리 구조:

promotion/
  plan.md          # 핵심 기능, 규격 확인 기록, 스타일 선택
  shots/           # 시뮬레이터 원본 스크린샷
  bg/              # AI 생성 배경 (다중 스타일, 다중 seed)
  final/phone/     # 휴대폰용 완성본
  final/tablet/    # 태블릿용 완성본 (해당하는 경우)
  final/pc/        # PC용 완성본 (해당하는 경우)
  manifest.md      # 전달 목록: 파일 이름, 크기, 용량, 해당 핵심 기능

전달 시 사용자에게 보고: 완성본 경로, 각 이미지의 크기와 해당 핵심 기능, AppGallery Connect에 업로드 시 위치(앱 정보 → 소개 이미지/프로모션 이미지).

관련 스킬