#ASO 데이터 동기화 도구

로컬 캐시와 스토어 간 ASO(App Store Optimization) 데이터를 동기화하는 도구입니다.

#aso-pull

App Store/Google Play에서 ASO 데이터를 가져와 로컬 캐시에 저장합니다.

#파라미터

참고: app(권장) 또는 bundleId/packageName을 직접 제공하세요.

#사용 예시

// 등록된 앱으로 모든 스토어에서 가져오기
{ "app": "myapp" }

// App Store만 가져오기
{ "app": "myapp", "store": "appStore" }

// 직접 식별자 사용
{ "bundleId": "com.example.app", "packageName": "com.example.app" }

// 데이터 미리보기
{ "app": "myapp", "dryRun": true }

#가져오는 데이터

App Store:

• 앱 이름, 부제목, 설명
• 키워드, 프로모션 텍스트
• 스크린샷 (iPhone 6.5", iPhone 6.1", iPad Pro 12.9")
• 모든 지원 언어

Google Play:

• 제목, 짧은 설명, 전체 설명
• 스크린샷 (휴대폰, 태블릿)
• 대표 이미지
• 모든 지원 언어

#데이터 저장 위치

설정의 dataDir에 지정된 경로에 저장됩니다:

{dataDir}/.aso/pull/{slug}/
├── app-store/
│   ├── data.json
│   └── screenshots/{locale}/
│       ├── iphone65-1.png
│       ├── iphone65-2.png
│       └── ...
└── google-play/
    ├── data.json
    └── screenshots/{language}/
        ├── phone-1.png
        ├── phone-2.png
        └── feature-graphic.png

#응답

✅ ASO data pulled
   Google Play: ✓
   App Store: ✓

#aso-push

로컬 캐시의 ASO 데이터를 App Store/Google Play에 반영합니다.

#파라미터

#사용 예시

// 모든 스토어에 반영
{ "app": "myapp" }

// Google Play만 반영
{ "app": "myapp", "store": "googlePlay" }

// 이미지와 함께 반영
{ "app": "myapp", "uploadImages": true }

// 미리보기
{ "app": "myapp", "dryRun": true }

#데이터 소스

push 디렉토리에서 데이터를 읽습니다:

{dataDir}/.aso/push/{slug}/
├── app-store/
│   └── data.json
└── google-play/
    └── data.json

#응답

📤 ASO Push Results:
✅ Google Play: Updated 3 locales (en-US, ko, ja)
✅ App Store: Updated 3 locales (en-US, ko, ja)

에러:

📤 ASO Push Results:
❌ Google Play: Push failed: Permission denied
⏭️  Skipping App Store (not registered for App Store)

#데이터 형식

#App Store 데이터 (data.json)

{
  "defaultLocale": "en-US",
  "locales": {
    "en-US": {
      "name": "My App",
      "subtitle": "Your productivity companion",
      "description": "Full app description...",
      "keywords": "productivity,task,todo",
      "promotionalText": "Now with new features!",
      "screenshots": {
        "iphone65": ["url1", "url2"],
        "iphone61": ["url1", "url2"],
        "ipadPro129": ["url1"]
      }
    },
    "ko": {
      "name": "마이 앱",
      "subtitle": "생산성 도우미",
      "description": "전체 앱 설명...",
      "keywords": "생산성,작업,할일",
      "promotionalText": "새로운 기능 추가!",
      "screenshots": {
        "iphone65": ["url1", "url2"]
      }
    }
  }
}

#Google Play 데이터 (data.json)

{
  "defaultLocale": "en-US",
  "locales": {
    "en-US": {
      "title": "My App",
      "shortDescription": "Your productivity companion",
      "fullDescription": "Full app description...",
      "screenshots": {
        "phone": ["url1", "url2"],
        "tablet": ["url1"]
      },
      "featureGraphic": "feature-url"
    },
    "ko": {
      "title": "마이 앱",
      "shortDescription": "생산성 도우미",
      "fullDescription": "전체 앱 설명...",
      "screenshots": {
        "phone": ["url1", "url2"]
      }
    }
  }
}

#워크플로우 예시

1. 현재 데이터 가져오기:

   { "app": "myapp" }
   

2. 로컬에서 데이터 편집 ({dataDir}/.aso/push/{slug}/)

3. 변경사항 미리보기:

   { "app": "myapp", "dryRun": true }
   

4. 업데이트 반영:

   { "app": "myapp" }
   

#참고

• apps-add - ASO 도구 사용 전 앱 등록
• release-update-notes - 릴리스 노트만 별도 업데이트