用途:该技能用于组织、校验并上传 Android 应用在 Google Play 商店的截图与图形素材,覆盖 gplay 专属的上传与校验流程,不涉及截图拍摄本身。拍摄可用 adb shell screencap 配合 adb pull,或用 Espresso/UI Automator 测试驱动,切换模拟器语言可用 setprop persist.sys.locale。
目录结构:gplay 采用 Fastlane 风格目录树,sync import-images 与 release --screenshots-dir 均读取该结构,例如 metadata/en-US/images/phoneScreenshots/1_home.png。截图按文件名顺序上传,用 1_、2_ 前缀控制商店展示顺序。
图片类型:phoneScreenshots(必需,2-8 张)、sevenInchScreenshots、tenInchScreenshots、tvScreenshots、wearScreenshots、featureGraphic(1024x500)、promoGraphic(180x120)、icon(512x512)、tvBanner(1280x720)。Google Play 要求 PNG 或 JPEG(推荐 PNG),单图最大 8 MB。
使用方式:上传前先校验,如 gplay validate screenshots --dir ./metadata --output table,可加 --locale 校验单个语言。批量导入需先创建 edit:EDIT_ID=$(gplay edits create --package com.example.app | jq -r '.id'),再执行 gplay sync import-images --package com.example.app --edit "$EDIT_ID" --dir ./metadata,支持 --locale 与 --dry-run。单图上传用 gplay images upload 指定 --locale、--type、--file。也可在发布时用 gplay release 加 --screenshots-dir 一并上传。替换已有截图需先 gplay images delete-all 并加 --confirm,再重新上传。最后用 gplay edits validate 与 gplay edits commit 提交。可用 gplay images list 查看线上内容。
限制与注意:所有写入都经过 edit 流程(create → upload/import → validate → commit);delete-all 必须带 --confirm;建议优先使用 sync import-images 而非多次单图上传;运行前用 --help 确认参数;机器步骤默认 JSON,人工查看用 --output table。