HarmonyOS 앱 스토어 프로모션 이미지 제작
현재 HarmonyOS 프로젝트를 위해 AppGallery Connect에 직접 업로드할 수 있는 프로모션 이미지 세트(앱 상세 페이지 상단 캐러셀 소개 스크린샷/홍보 이미지)를 생성합니다.
기본 원칙
- 배경 일러스트는 코드로 그리지 않습니다. 사람 디자이너처럼 행동합니다: 프롬프트 작성 → 무료 이미지 생성 모델 호출 → 결과 확인 → 만족스럽지 않으면 시드(seed) 변경/프롬프트 수정 후 재시도(3단계 참조). 코드는 합성(이미지 결합, 둥근 모서리, 텍스트 배치, 크기 조정 내보내기)에만 사용합니다.
- 규격은 먼저 온라인으로 확인한 후 작업을 시작합니다. 이 파일에 포함된 기본 규격은 최신 버전이 아닐 수 있으므로, 각 작업 시작 시 반드시 1단계를 수행합니다.
- 기본적으로 '표준 프로모션 이미지 세트'를 생성합니다: 휴대폰 세로 5장(최대 8장) + 태블릿 가로 2-3장 + PC 16:9 2장. 사용자 요청이 있으면 그에 따릅니다.
- 모든 결과물은
<프로젝트 루트>/promotion/디렉토리에 저장하며, 프로젝트 소스 코드 디렉토리를 오염시키지 않습니다. - 다운로드한 자료, 생성된 이미지 등 임시 파일은 프로젝트 디렉토리에 저장하며, 시스템 디스크의 Temp 디렉토리에는 저장하지 않습니다.
작업 흐름
0단계: 앱 분석
다음 파일을 읽어 정보를 추출합니다(사용자에게 묻지 말고 코드를 직접 읽습니다):
AppScope/app.json5: bundleName, icon, labelentry/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×512 | PNG, 둥근 모서리는 백엔드에서 처리 |
| HarmonyOS 데스크톱 아이콘 전경/배경 | 1024×1024 | PNG, 투명, 자체 둥근 모서리/테두리/그림자 금지 |
심사 위반 사항: 이미지에 iOS / iPhone / Apple Store / 경쟁 앱 스토어 명칭 또는 디바이스 외관이 포함되어서는 안 됩니다. 실제 기능과 일치하지 않는 허위 광고는 금지됩니다. 국기, 정치적으로 민감한 요소를 포함하지 마십시오. 스크린샷에 개인 정보가 노출되지 않도록 하십시오.
확인 결과를 promotion/plan.md에 기록합니다.
2단계: 시뮬레이터 스크린샷 (제품 소개 이미지 자료)
devecocli devices명령어로 디바이스를 확인합니다. 디바이스가 없으면 시뮬레이터를 시작합니다.- 프로젝트가 빌드되지 않았으면
devecocli build를 실행합니다. 그런 다음devecocli run --skip-build로 설치 및 실행합니다. - 페이지별로 스크린샷을 촬영합니다(기본적으로 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장. 해당 페이지로 이동한 후 다음 스크린샷을 촬영합니다.
- 스크린샷의 너비가 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개의 프로모션 이미지에 해당):
| 스타일 | 적용 | 프롬프트 키워드 |
|---|---|---|
| 그라데이션 플루이드 | 도구/기술/AI | soft 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 커넥터를 사용하여 이러한 내장 그래픽을 직접 활용하여 정밀하게 다듬을 수 있으며, 처음부터 직접 그릴 필요가 없습니다.
- 프로젝트
deveco.json/ 전역 구성의mcp섹션에 Canva, Figma, MasterGo, Pixso 등 디자인 커넥터가 있는지 확인합니다. - Canva가 있는 경우: 내장 템플릿을 검색합니다(키워드 "app promotion" / "휴대폰 포스터") → 3단계 AI 배경과 2단계 스크린샷을 템플릿 자리 표시자 영역에 교체 → 내장 그래픽으로 레이아웃과 텍스트를 미세 조정 →
promotion/final/로 내보냅니다. Canva의 기성 디자인 자산을 활용하므로 속도가 빠르고 전문적입니다. - 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에 업로드 시 위치(앱 정보 → 소개 이미지/프로모션 이미지).