gplay-migrate-fastlane

已同步 v1.1.0 授權: MIT 來源: tamtom/gplay-cli-skills/skills/gplay-migrate-fastlane 提交: 10301b2 收錄的最新變更: 2026-07-04

Migration from Fastlane supply to gplay CLI using the gplay migrate fastlane command. Use when asked to convert a Fastlane-based Play Store workflow to gplay, or to import existing Fastlane metadata directories.

摘要

用途: 將 Fastlane 的 Android 中繼資料目錄轉換為 gplay 的檔案式格式，把上架文字整合至 listing.json，並保留變更記錄與圖片。
使用時機: 當需要分階段遷移、先以試執行預覽變更，或僅轉換指定語系時使用。
輸出結果: 產生含各語系 listing.json、複製的變更記錄與圖片的 gplay 中繼資料目錄；試執行則會預覽變更而不寫入檔案。

上游變更（2 筆，最新收錄 2026-07-04）

439c9ae 2026-07-04 fix(skills): audit cleanup — correct every command, cut dead weight, add drift guardrail (#3) 更新遷移指南，將輸出格式說明為 gplay 檔案式 metadata 指令所用的格式，並將正式環境 rollout 範例從 `10` 修正為 `0.1`。

f8592d5 2026-02-15 feat: add skills for v0.4.2 new commands (vitals, users, migrate) 新增 Fastlane 轉移至 gplay 的指南，涵蓋指令範例、選項、檔案轉換與輸出細節、工作流程範例、指令對照及最佳實務。

npx skills add "lettucebo/Skills#v2.2.0@gplay-migrate-fastlane" --full-depth

⚠ v2.2.0 發布後即可使用

Fastlane Migration

Use this skill when you need to migrate from Fastlane supply to the gplay CLI.

Preconditions

Existing Fastlane metadata directory structure.
gplay CLI installed and authenticated.
Familiarity with the source Fastlane directory layout.

Migrate Command

Basic migration

gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata

Dry run (preview without writing files)

gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata \
  --dry-run

Migrate specific locales only

gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata \
  --locales en-US,es-ES,fr-FR

Dry run with specific locales

gplay migrate fastlane \
  --source ./fastlane/metadata/android \
  --output-dir ./metadata \
  --locales en-US,ja-JP \
  --dry-run

Flags

Flag	Description	Required
`--source`	Path to Fastlane metadata directory	Yes
`--output-dir`	Output directory for gplay metadata	Yes
`--dry-run`	Preview changes without writing files	No
`--locales`	Comma-separated list of locales to migrate	No (all by default)

What Gets Migrated

The command converts the Fastlane directory structure into the format used by gplay's file-based metadata commands (metadata pull / metadata push / metadata validate):

Fastlane source structure

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/
│   └── ...

Migrated output structure

metadata/
├── en-US/
│   ├── listing.json
│   ├── changelogs/
│   │   ├── 100.txt
│   │   └── 101.txt
│   └── images/
│       ├── phoneScreenshots/
│       │   ├── 1.png
│       │   └── 2.png
│       ├── icon.png
│       └── featureGraphic.png
├── es-ES/
│   └── ...

File conversions

title.txt, short_description.txt, full_description.txt, video.txt are consolidated into listing.json.
changelogs/ are copied as-is.
images/ are copied as-is.

Workflow Examples

Full migration from 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

Incremental locale migration

# 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 migration validation

# 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

Replacing Fastlane Supply Commands

Fastlane Command	gplay Equivalent
`fastlane supply init`	`gplay sync export-listings --dir ./metadata`
`fastlane supply`	`gplay sync import-listings --dir ./metadata`
`fastlane supply --skip_upload_images`	`gplay sync import-listings --dir ./metadata`
`fastlane supply --track beta`	`gplay release --track beta --bundle app.aab`
`fastlane supply --track production --rollout 0.1`	`gplay release --track production --bundle app.aab --rollout 0.1`

Best Practices

Always dry-run first - Preview the migration output before writing files.
Migrate locale by locale - Start with your primary locale and verify.
Keep Fastlane source - Do not delete the Fastlane directory until fully migrated and verified.
Validate after migration - Use gplay validate listing to check character limits.
Update CI/CD gradually - Replace Fastlane commands one at a time.
Version control the output - Commit migrated metadata to track changes.