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

フラグ

フラグ	説明	必須
--source	Fastlane メタデータディレクトリへのパス	はい
--output-dir	gplay メタデータの出力ディレクトリ	はい
--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 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

ベストプラクティス

1. 必ず最初にドライランを実行する - ファイルを書き込む前に移行結果をプレビューしてください。
2. ロケールごとに移行する - まず主要なロケールから始めて、結果を確認してください。
3. Fastlane のソースを保持する - 移行と検証が完了するまで Fastlane ディレクトリを削除しないでください。
4. 移行後に検証する - gplay validate listing を使用して文字数制限を確認してください。
5. CI/CD を段階的に更新する - Fastlane コマンドを一度に1つずつ置き換えてください。
6. 出力をバージョン管理する - 変更を追跡できるよう、移行したメタデータをコミットしてください。