mcpField
G
gplay-migrate-fastlane

gplay-migrate-fastlane

github.com/tamtom云与 DevOps52336 次安装13 周前更新
代码仓库

关于 gplay-migrate-fastlane

用于将 Android 商店元数据从 Fastlane supply 转换为 gplay 的文件式元数据格式，适合迁移元数据工作流的团队。支持预览变更和按语言区域迁移。

主要功能

  1. 01将商品页文本合并为 listing.json
  2. 02复制更新日志和图片
  3. 03使用 dry-run 预览变更
  4. 04迁移指定语言区域

适用场景

  1. 01将现有 Fastlane 元数据迁至 gplay
  2. 02写入文件前预览输出
  3. 03逐步迁移不同语言区域

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tamtom/gplay-cli-skills --skill gplay-migrate-fastlane

安装后在 Claude Code 中输入/gplay-migrate-fastlane确认已加载。

详细介绍

Fastlane 迁移

需要从 Fastlane supply 迁移到 gplay CLI 时，请使用此技能。

前提条件

  • 已有 Fastlane 元数据目录结构。
  • 已安装并完成身份验证的 gplay CLI。
  • 熟悉 Fastlane 源目录布局。

迁移命令

基本迁移
gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata
试运行（预览但不写入文件）
gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata \
  --dry-run
仅迁移指定区域设置
gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata \
  --locales en-US,es-ES,fr-FR
对指定区域设置进行试运行
gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata \
  --locales en-US,ja-JP \
  --dry-run

标志

标志说明必需
--sourceFastlane 元数据目录的路径是
--output-dirgplay 元数据的输出目录是
--dry-run预览更改但不写入文件否
--locales要迁移的区域设置列表，以逗号分隔否（默认全部）

迁移内容

此命令会将 Fastlane 目录结构转换为 gplay 基于文件的元数据命令（metadata pull / metadata push / metadata validate）所使用的格式：

Fastlane 源结构
fastlane/metadata/android/
├── en-US/
│   ├── title.txt
│   ├── short_description.txt
│   ├── full_description.txt
│   ├── video.txt
│   ├── changelogs/
│   │   ├── 100.txt
│   │   └── 101.txt
│   └── images/
│       ├── phoneScreenshots/
│       │   ├── 1.png
│       │   └── 2.png
│       ├── icon.png
│       └── featureGraphic.png
├── es-ES/
│   └── ...
迁移后的输出结构
metadata/
├── en-US/
│   ├── listing.json
│   ├── changelogs/
│   │   ├── 100.txt
│   │   └── 101.txt
│   └── images/
│       ├── phoneScreenshots/
│       │   ├── 1.png
│       │   └── 2.png
│       ├── icon.png
│       └── featureGraphic.png
├── es-ES/
│   └── ...
文件转换
  • title.txt、short_description.txt、full_description.txt、video.txt 会合并到 listing.json 中。
  • changelogs/ 会原样复制。
  • images/ 会原样复制。

工作流示例

从 Fastlane 完整迁移
# 1. Preview the migration
gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata \
  --dry-run

# 2. Run the actual migration
gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata

# 3. Verify the output
ls -R ./metadata

# 4. Import to Play Store
gplay sync import-listings \
  --package com.example.app \
  --dir ./metadata
增量迁移区域设置
# Migrate English first
gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata \
  --locales en-US

# Verify and test
gplay sync diff-listings \
  --package com.example.app \
  --dir ./metadata

# Migrate remaining locales
gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata \
  --locales es-ES,fr-FR,de-DE,ja-JP
CI/CD 迁移验证
# In CI, validate that migration produces expected output
gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata-test \
  --dry-run

# Check exit code
if [ $? -eq 0 ]; then
  echo "Migration validation passed"
else
  echo "Migration validation failed"
  exit 1
fi

替换 Fastlane Supply 命令

Fastlane 命令gplay 对应命令
fastlane supply initgplay sync export-listings --dir ./metadata
fastlane supplygplay sync import-listings --dir ./metadata
fastlane supply --skip_upload_imagesgplay sync import-listings --dir ./metadata
fastlane supply --track betagplay release --track beta --bundle app.aab
fastlane supply --track production --rollout 0.1gplay release --track production --bundle app.aab --rollout 0.1

最佳实践

  1. 始终先进行试运行 - 写入文件前预览迁移输出。
  2. 逐个区域设置迁移 - 从主要区域设置开始并进行验证。
  3. 保留 Fastlane 源目录 - 完全迁移并验证之前，不要删除 Fastlane 目录。
  4. 迁移后进行验证 - 使用 gplay validate listing 检查字符数限制。
  5. 逐步更新 CI/CD - 一次替换一条 Fastlane 命令。
  6. 对输出进行版本控制 - 提交迁移后的元数据以跟踪更改。

评论

支持 Markdown