鴻蒙アプリ宣伝画像作成
現在の 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 のコアセールスポイント(各宣伝画像が 1 つのセールスポイントに対応)、ターゲットユーザー、ブランドメインカラーの hex、スタイルの選定。
ステップ 1:ネットで仕様確認(必須)
websearch / webfetch を使って最新要件を検索・確認します。検索キーワード例:
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、1枚 ≤2MB、3〜8 枚 |
| タブレット宣伝画像(横) | 2560×1440(16:9)または 3:2 | 同上 |
| PC 宣伝画像 | 1920×1080(16:9) | 同上 |
| AppGallery アイコン | 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(デフォルト、無料で Key 不要):Pollinations 直接接続
URL 形式(プロンプトは URL エンコード、英語で記述):
https://image.pollinations.ai/prompt/{encoded_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 を生成し、1 枚ずつ確認(画質を目視判定)、不満ならプロンプトを修正するか seed を変えてやり直します。一度に何十枚も生成しないでください。
方法 B(フォールバック、ユーザーが「人間のように Web ページを操作して」と要求した場合):ブラウザ自動化
deveco.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 で合成(ない場合は pip install pillow)。縦型画像の構成:
┌─────────────────────┐ 1080×2400
│ アプリ名(大見出し) │ ← タイトルエリア:アプリ名 + 一言キャッチコピー、メインカラー/白文字
│ 一言キャッチコピー │
│ ┌─────────────┐ │
│ │ 端末輪郭 │ │ ← 端末本体:メインカラーグラデーション角丸長方形(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 してからリサイズし比率を維持
img = bg.copy()
draw = ImageDraw.Draw(img)
# 端末の輪郭
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 で確認した結果に従う。
- 出力後、1 枚ずつ確認:1枚 ≤2MB(超えたら JPG quality=88 に変換するかダウンサンプリング)、テキストがメイン被写体を圧迫していない、角丸が自然。
- テキストは plan.md のセールスポイントから抽出し、短文にする(1行 ≤12 文字)、虚偽の機能説明を禁止。
ステップ 5:オプションの強化——Web デザインツール(Canva コネクターなど)
Canva には多数の内蔵グラフィックアセットがあります:既存テンプレート(アプリプロモーション/携帯電話ポスター系)、シェイプ、イラストステッカー、アイコン、フォント、タイポグラフィ。AI が Canva コネクターを介してこれらの内蔵グラフィックを直接流用して仕上げることができ、ゼロから描く必要はありません。
- プロジェクトの
deveco.json/ グローバル設定のmcpセクションに Canva、Figma、MasterGo、Pixso などのデザインコネクターがあるか確認します。 - Canva がある場合:内蔵テンプレートを検索(キーワード "app promotion" / "携帯電話ポスター")→ ステップ 3 の AI 背景とステップ 2 のスクリーンショットをテンプレートのプレースホルダーに差し替え → 内蔵グラフィックでレイアウトとテキストを微調整 →
promotion/final/にエクスポート。Canva の既存デザインアセットを活用するため、高速でプロフェッショナルです。 - ない場合:このステップはスキップ。メインフロー(無料画像生成+合成)で十分です。納品時に、Canva コネクターを設定すればテンプレート精修機能が得られることをユーザーに伝えます。
位置づけ:このステップは、仕上げを強化するオプションです。宣伝画像の主な成果物は常にステップ 3(Pollinations での無料画像生成)+ステップ 4(コード合成)です。Canva はコネクターが存在し、ユーザーがより洗練されたテンプレートベースのレイアウトを必要とする場合にのみ使用します。
ステップ 6:自己チェックと納品
promotion/final/ の各画像について以下を確認:
- 解像度 = ステップ 1 で確認した仕様(サイズ、アスペクト比)
- 形式 JPG/PNG、1枚 ≤2MB
- スマホ版 3〜8 枚、各画像が 1 つのセールスポイントに対応
- iOS/Apple/競合の表記なし、透かしなし、文字化けなし
- テキストに誤字脱字なし、アプリの実際の機能と一致
ディレクトリ構成:
promotion/
plan.md # セールスポイント、仕様確認記録、スタイル選定
shots/ # エミュレーターの生スクリーンショット
bg/ # AI 生成背景(複数スタイル、複数 seed)
final/phone/ # スマホ版完成品
final/tablet/ # タブレット版完成品(該当する場合)
final/pc/ # PC 版完成品(該当する場合)
manifest.md # 納品リスト:ファイル名、サイズ、容量、対応セールスポイント
納品時にユーザーに報告:完成品のパス、各画像のサイズと対応するセールスポイント、および AppGallery Connect に掲載する際のアップロード場所(アプリ情報 → 紹介画像/宣伝画像)。