CommunityBildgithub.com

hmos-appgallery-poster

Erstellt für HarmonyOS-Apps professionelle AppGallery-Verkaufsgrafiken, Screenshots und Detailseiten-Bilder für die Veröffentlichung im Huawei AppGallery Connect.

Was ist hmos-appgallery-poster?

Dieses Skill automatisiert die Erstellung eines vollständigen Satzes von Werbegrafiken für die Huawei AppGallery-Veröffentlichung. Es analysiert zunächst das HarmonyOS-Projekt automatisch, extrahiert App-Name, Bundle-Name, Funktionen und Primärfarbe und erstellt einen Plan. Danach werden die aktuellen Spezifikationen von AppGallery Connect per Websuche verifiziert, Screenshots im Emulator erstellt und anschließend mittels KI-Bildgenerierung (standardmäßig kostenlos über Pollinations.ai) passende Hintergründe erzeugt. Das Skill synthetisiert dann die Screenshots mit den KI-Hintergründen und professioneller Typografie zu finalen Werbebildern für Smartphone (Hochformat), Tablet (Querformat) und PC (16:9). Es beachtet strikt die Richtlinien von Huawei, vermeidet Wettbewerbslogos und falsche Behauptungen und liefert die Ergebnisse in einem sauberen `promotion/`-Verzeichnis. Optionale Verbesserungen sind über Canva-Vorlagen möglich, wenn ein entsprechender MCP-Connector konfiguriert ist. Das Skill ist für Claude Code, Cursor und andere agentenbasierten Coding-Tools optimiert, die über Dateisystem- und Shell-Zugriff verfügen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Huangzihengcmd/hmos-appgallery-poster/tree/HEAD

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Erstellung von Werbegrafiken für HarmonyOS-AppGallery

Erstellt für das aktuelle HarmonyOS-Projekt einen Satz von Werbegrafiken (Screenshots / Banner für die Detailseite), die direkt in AppGallery Connect hochgeladen werden können.

Grundprinzipien

  1. Hintergrundillustrationen NIEMALS mit Code zeichnen. Wie ein menschlicher Designer: Prompt schreiben → Kostenloses Bildgenerierungsmodell aufrufen → Ergebnis betrachten → Bei Unzufriedenheit Seed ändern / Prompt umformulieren und wiederholen (siehe Schritt 3). Code wird nur für die Komposition (Collage, abgerundete Ecken, Textlayout, skalierter Export) verwendet.
  2. Spezifikationen zuerst online prüfen, dann handeln. Die eingebetteten Basisspezifikationen in dieser Datei können veraltet sein. Bei jeder Aufgabe zuerst Schritt 1 ausführen.
  3. Standardmäßig wird ein "Standard-Werbeset" erstellt: 5 Hochformat-Bilder für Smartphones (max. 8) + 2-3 Querformat-Bilder für Tablets + 2 Bilder im 16:9-Format für den PC. Wenn der Benutzer andere Anforderungen hat, diesen folgen.
  4. Alle Ausgaben werden in <Projektstamm>/promotion/ abgelegt, das Projektverzeichnis wird nicht verschmutzt.
  5. Temporäre Dateien (heruntergeladene Materialien, generierte Bilder) im Projektverzeichnis ablegen, nicht im Temp-Verzeichnis der Systemplatte.

Arbeitsablauf

Schritt 0: App analysieren

Die folgenden Dateien lesen, um Informationen zu extrahieren (nicht den Benutzer fragen, den Code selbst lesen):

  • AppScope/app.json5: bundleName, icon, label
  • entry/src/main/module.json5: abilities, Berechtigungen, Gerätetypen (Unterstützung für tablet/pc)
  • AppScope/resources/base/element/string.json und resources/zh/: App-Name
  • entry/src/main/resources/base/profile/main_pages.json + Seiten unter pages/: Funktionsliste
  • Icon unter resources/base/media/: Primärfarbe der Marke bestimmen (durch visuelle Begutachtung oder Farbanalyse)

Erstelle promotion/plan.md mit: App-Name, Ein-Satz-Positionierung, 3-5 Kernfunktionen (jedes Werbebild entspricht einer Funktion), Zielgruppe, Primärfarbe (Hex), Stilauswahl.

Schritt 1: Spezifikationen online prüfen (Pflicht)

Mit websearch / webfetch die neuesten Anforderungen suchen und abgleichen. Beispielsuchbegriffe:

  • AppGallery Werbebild Größe Spezifikationen App-Informationen
  • Huawei AppGallery App-Vorstellungsbild Screenshot Anforderungen
  • developer.huawei.com Designrichtlinien und Spezifikationen (HarmonyOS Design-Spezifikationen)
  • AppGallery Connect Bildspezifikationen Veröffentlichung

Die offiziellen Huawei-Dokumente (developer.huawei.com / AppGallery Connect Hilfezentrum) sind maßgeblich. Falls die offizielle Seite aufgrund von JS-Rendering nicht lesbar ist, die angegebenen Schlüsselwörter für sekundäre, autoritative Quellen zur Kreuzvalidierung verwenden.

Basis-Spezifikationstabelle (Stand: November 2026, muss dennoch online geprüft werden):

MaterialGröße/VerhältnisFormat & Einschränkungen
Smartphone Hochformat1080×1920 / 1080×2340 / 1080×2400 (9:16 ~ 9:19.5)JPG/PNG, einzeln ≤2MB, 3-8 Stück
Tablet Querformat2560×1440 (16:9) oder 3:2Gleich wie oben
PC1920×1080 (16:9)Gleich wie oben
AppGallery Icon216×216 (AGC Backend) / 512×512PNG, abgerundete Ecken durch Backend
HarmonyOS Desktop Icon Vorder-/Hintergrund1024×1024PNG, transparent, keine eigenen abgerundeten Ecken, Ränder oder Schatten

Prüfungs-Richtlinien: Bilder dürfen keine iOS / iPhone / Apple Store / konkurrierende App Store Namen oder Geräte zeigen; keine irreführenden Behauptungen, die nicht den tatsächlichen Funktionen entsprechen; keine Nationalflaggen, politisch sensiblen Elemente; keine privaten Informationen in Screenshots.

Die Ergebnisse der Prüfung in promotion/plan.md festhalten.

Schritt 2: Emulator-Screenshots (Material für Produktvorstellungsbilder)

  1. devecocli devices prüfen; wenn kein Gerät vorhanden, Emulator starten.
  2. Wenn das Projekt nicht gebaut ist: devecocli build; dann devecocli run --skip-build installieren und starten.
  3. Seite für Seite Screenshots machen (Standard: hdc für Screenshots verwenden, nicht verify_ui; UI-Überprüfung nur, wenn der Benutzer explizit eine UI-Überprüfung verlangt):
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. Screenshots gemäß den Verkaufsargumenten planen: mindestens ein Screenshot pro Kernfunktion; zur entsprechenden Seite navigieren, bevor der nächste Screenshot gemacht wird.
  2. Wenn die Screenshots nicht 1080 breit sind, die tatsächliche Auflösung in plan.md notieren und bei der Komposition proportional skalieren.

Schritt 3: KI-Bildgenerierung – menschliches Malen simulieren (mehrere Stile, Hintergründe)

Option A (Standard, kostenlos, kein API-Key): Pollinations direkt

URL-Form (Prompt muss URL-kodiert sein, auf Englisch):

https://image.pollinations.ai/prompt/{encoded_prompt}?width=1024&height=2048&seed={n}

Hinweise aus der praktischen Erprobung (November 2026):

  • nologo=true nicht mitgeben, dieser Parameter ist kostenpflichtig (gibt 402 Payment Required zurück). Auch model=flux nicht mitgeben; das Standardmodell verwenden.
  • Der kostenlose Kanal hat eine Ratenbegrenzung. Erste Anfrage gibt oft 503 (Hinweis: Retry after 10s) zurück. 12 Sekunden warten, dann wiederholen; maximal 5 Versuche, meist klappt es dann.
$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 { }
}

Menschlicher Iterationsstil: Pro Stil 2-3 Seeds generieren, einzeln ansehen (Qualität visuell beurteilen). Bei Unzufriedenheit Prompt ändern oder Seed wechseln und neu beginnen. Nicht Dutzende auf einmal generieren.

Option B (Herabstufung, wenn Benutzer "wie ein Mensch im Browser arbeiten" möchte): Browser-Automatisierung

Falls in deveco.json ein Browser-MCP konfiguriert ist (z. B. @playwright/mcp), eine kostenlose Bildgenerierungsseite öffnen (pollinations.ai usw.) und menschliches Verhalten simulieren: Prompt eingeben → auf Bild warten → in promotion/bg/ herunterladen. Wenn kein solcher MCP vorhanden ist, direkt Option A verwenden.

Option C: Bereits konfigurierte Bildgenerierungs-MCP/Connectors (z. B. Canva-Connector mit integrierter KI-Bildgenerierung). Wenn vorhanden, vor Option A verwenden.

Stilbibliothek (pro App-Typ in plan.md 3-5 Stile auswählen, jeder Stil für 1-2 Werbebilder):

StilGeeignet fürPrompt-Schlüsselwörter
Gradient FluidTools / Technologie / KIsoft gradient fluid abstract, smooth flowing shapes
Minimalistisch GeometrischProduktivität / Businessminimalist flat design, geometric shapes, clean, pastel
3D Cartoon RenderKinder / Bildung / Freizeitcute 3d cartoon render, soft lighting, playful
NaturfotografieLifestyle / Gesundheit / Reisennatural landscape photography, golden hour, bokeh
Chinesische Guochao-IllustrationInhalte / Kulturchinese traditional illustration, modern guochao style
Dunkel NeonSpiele / E-Sportdark neon glow, cyberpunk, dramatic lighting
Weiches Diffuses LichtSoziales / Emotionensoft diffuse light, dreamy pastel, warm

Eiserne Regeln für Prompts: Muss no text, no watermark enthalten – Text wird in Schritt 4 gesetzt; KI-generierter Text ist immer fehlerhaft. Farbgebung an der Primärfarbe der Marke orientieren.

Schritt 4: Produktvorstellungsbilder synthetisieren (HarmonyOS-Smartphone-Umriss + Text)

Mit Python + Pillow synthetisieren (falls nicht vorhanden: pip install pillow). Struktur jedes Hochformats:

┌─────────────────┐  1080×2400
│  App-Name (Titel) │  ← Titelbereich: App-Name + Ein-Satz-Verkaufsargument, Primärfarbe/weißer Text
│  Ein-Satz-Verkaufsargument │
│ ╭─────────────╮ │
│ │ HarmonyOS- │ │  ← Geräterahmen: Abgerundetes Rechteck mit Primärfarbverlauf (r≈140px),
│ │ Smartphone-│ │     Rand-Highlight, integriert Screenshot aus Schritt 2 (ebenfalls abgerundet)
│ │ Umriss     │ │
│ │ ┌─────────┐ │ │
│ │ │ Emulator│ │ │
│ │ │Screenshot│ │ │
│ │ └─────────┘ │ │
│ ╰─────────────╯ │
│  Icon + App-Name  │  ← Footer-Bereich
└─────────────────┘

Minimales, funktionsfähiges Grundgerüst (Parameter nach Bedarf anpassen, nicht blind übernehmen):

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))  # Hintergrund ausfüllen, ggf. zuschneiden vor skalieren, um Seitenverhältnis zu halten

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

# HarmonyOS-Smartphone-Umriss
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)

# Text (Chinesische Schriftart: Windows verwendet msyh.ttc, falls HarmonyOS Sans installiert, bevorzugen)
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), "App-Name", font=font_big, fill=(255, 255, 255), anchor="mm")
draw.text((W // 2, 410), "Ein-Satz-Verkaufsargument", font=font_sub, fill=(230, 230, 230), anchor="mm")

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

Anforderungen:

  • Tablet/PC-Versionen als Querformat: Screenshot links oder rechts, Text auf der Gegenseite; Auflösung gemäß Schritt 1.
  • Nach Export jedes Bild prüfen: Einzeln ≤2MB (bei Überschreitung in JPG mit quality=88 konvertieren oder herunterskalieren), Text überdeckt kein Hauptelement, abgerundete Ecken natürlich.
  • Text aus den Verkaufsargumenten in plan.md extrahieren, kurze Sätze (≤12 Zeichen/Zeile), keine falschen Funktionsbeschreibungen.

Schritt 5: Optionale Verbesserung – Web-Designtools (Canva-Connector usw.)

Canva bietet viele eingebaute Grafikressourcen: vorgefertigte Vorlagen (App-Promotion / Smartphone-Poster), Formen, Illustrations-Sticker, Symbole, Schriftarten-Layout. Mit dem KI-Canva-Connector können diese eingebauten Grafiken direkt verwendet werden, nicht von Grund auf neu zeichnen.

  1. Prüfen, ob im deveco.json / globalen mcp-Abschnitt Canva-, Figma-, MasterGo-, Pixso-Design-Connector vorhanden ist.
  2. Canva vorhanden: Eingebaute Vorlagen durchsuchen (Stichworte "app promotion" / "Handy Poster") → KI-Hintergrund aus Schritt 3 und Screenshot aus Schritt 2 in die Vorlagen- Platzhalter einfügen → Mit eingebauten Grafiken Layout und Text verfeinern → Nach promotion/final/ exportieren. Nutzt die vorgefertigten Design-Assets von Canva, schnell und professionell.
  3. Nicht vorhanden: Diesen Schritt überspringen. Der Hauptablauf (kostenlose Bildgenerierung + Komposition) ist bereits ausreichend. Dem Benutzer bei Übergabe mitteilen, dass durch Konfiguration eines Canva-Connectors eine Vorlagenverfeinerung möglich ist.

Einordnung: Dieser Schritt ist eine optionale Verfeinerung. Die Hauptausgabe der Werbebilder basiert immer auf der kostenlosen Bildgenerierung aus Schritt 3 (Pollinations) und der Code-Komposition aus Schritt 4. Canva wird nur verwendet, wenn der Connector vorhanden ist und der Benutzer ein feineres, vorlagenbasiertes Layout wünscht.

Schritt 6: Selbstprüfung und Übergabe

Jedes Bild in promotion/final/ prüfen:

  • Auflösung = Spezifikation aus Schritt 1 (Größe, Seitenverhältnis)
  • Format JPG/PNG, einzeln ≤2MB
  • Smartphone: 3-8 Stück, jedes entspricht einem Verkaufsargument
  • Keine iOS/Apple/Wettbewerbs-Logos, keine Wasserzeichen, kein verstümmelter Text
  • Chinesischer Text keine Tippfehler, entspricht den tatsächlichen App-Funktionen

Verzeichnisstruktur:

promotion/
  plan.md          # Verkaufsargumente, Aufzeichnung der Spezifikationsprüfung, Stilauswahl
  shots/           # Original-Emulator-Screenshots
  bg/              # KI-generierte Hintergründe (mehrere Stile, mehrere Seeds)
  final/phone/     # Fertige Smartphone-Bilder
  final/tablet/    # Fertige Tablet-Bilder (falls zutreffend)
  final/pc/        # Fertige PC-Bilder (falls zutreffend)
  manifest.md      # Übergabeliste: Dateiname, Größe, Abmessungen, zugehöriges Verkaufsargument

Dem Benutzer bei Übergabe berichten: Pfad der fertigen Dateien, Größe jedes Bildes und zugehöriges Verkaufsargument, sowie wo in AppGallery Connect hochgeladen werden sollte (App-Informationen → Vorstellungsbilder / Werbebilder).

Verwandte Skills