gplay-migrate-fastlane

リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

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

bash

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

Dry run (preview without writing files)

bash

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

Migrate specific locales only

bash

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

Dry run with specific locales

bash

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

bash

# 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

bash

# 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

bash

# 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.

Fastlane Migration

Preconditions

Migrate Command

Basic migration

Dry run (preview without writing files)

Migrate specific locales only

Dry run with specific locales

Flags

What Gets Migrated

Fastlane source structure

Migrated output structure

File conversions

Workflow Examples

Full migration from Fastlane

Incremental locale migration

CI/CD migration validation

Replacing Fastlane Supply Commands

Best Practices

関連する Skills

gplay-user-management