Flutter 앱을 구글 플레이에 올리기

Flutter → Google Play Release

무료로 내려받기 (zip, 8KB)

압축 안에 든 것

  • flutter-play-release/SKILL.md
  • flutter-play-release/files/android_release.ps1

압축을 풀어 내 프로젝트의 .claude/skills/ 폴더에 넣으면 돼요. 무료이고, 고쳐 쓰셔도 됩니다.

한 줄 소개

윈도우 PC에서 Flutter 앱을 서명해 APK·AAB로 만들고, 플레이 콘솔에 등록해 내부 테스트로 내보내기까지의 순서와, 그 과정에서 실제로 걸렸던 함정을 모은 스킬입니다.

이런 분께 맞아요

  • Flutter로 앱은 만들었는데 플레이 스토어에 올려 본 적이 없는 분
  • 업로드 키와 서명 설정을 어떻게 해야 하는지 모르겠는 분
  • AAB 빌드가 이유를 알 수 없는 오류로 자꾸 실패하는 분 (폴더 이름에 한글이 있는 PC 포함)
  • 플레이 콘솔의 앱 콘텐츠 선언, 데이터 보안, 콘텐츠 등급에서 막힌 분
  • 클로드에게 콘솔 입력까지 맡기고 싶은 분

쓰면 이렇게 달라져요

전: 빌드 명령을 하나씩 치다가 오류가 나면 검색하고, 콘솔에서는 "주의 필요"가 왜 안 없어지는지 몰라 화면을 돌아다닙니다.

후: 스크립트 하나가 검사부터 파일 복사까지 한 번에 합니다.

.\scripts\android_release.ps1              # 테스트 빌드
.\scripts\android_release.ps1 -Production  # 스토어 정식 빌드

flutter analyze → flutter test → AAB → APK → dist\ 폴더에 버전 이름으로 복사까지 이어집니다. 콘솔은 앱 만들기부터 테스터 링크까지 여덟 단계 순서대로 채우고, "주의 필요"가 0개가 될 때까지 확인합니다.

쓰는 법

  1. 내려받기
  2. 프로젝트의 .claude/skills/flutter-play-release/에 넣기 (files/android_release.ps1은 내 프로젝트의 scripts\에 복사하고 맨 위 CONFIG 값만 고치기)
  3. 클로드 코드에 이렇게 말하기: "flutter-play-release 스킬대로 이 앱을 구글 플레이 내부 테스트까지 올릴 준비해 줘. 내가 직접 해야 하는 일은 그때그때 알려 줘."
무료로 내려받기 (zip, 8KB)

사람이 직접 해야 하는 일

  • 구글 플레이 개발자 계정 만들기와 등록비 결제 (US$25, 처음 한 번)
  • 로그인
  • AAB 파일을 콘솔에 끌어다 놓기 (수십 MB라 자동 업로드가 안 되는 경우가 많습니다)
  • 스토어 그림 올리기 (자동 업로드가 자주 멈춰서 처음부터 직접 하는 편이 빠릅니다)
  • 키 폴더 백업 — 업로드 키를 잃으면 앱을 업데이트할 수 없습니다
  • 마지막 출시 버튼 승인

우리가 실제로 써 본 이야기

뉴스 앱 하나를 처음부터 내부 테스트까지 올리면서 겪은 일을 그대로 적었습니다. 폴더 경로에 한글이 있어서 Flutter와 Gradle이 깨졌고, PC에 Android cmdline-tools가 없어서 정상인 AAB가 "실패"로 표시됐고, PowerShell이 Flutter의 경고를 오류로 받아들여 멈췄습니다. 콘솔에서는 콘텐츠 등급 설문 중간에 새 질문이 끼어들어 누르는 자리가 밀렸고, 데이터 보안 화면이 옆으로 밀려 체크가 안 먹은 항목이 있었습니다. 스킬 안의 함정 표와 콘솔 순서는 이렇게 실제로 걸렸던 것들로 만들었습니다.

자주 묻는 질문

Q. 맥이나 리눅스에서도 쓸 수 있나요?
빌드 스크립트는 윈도우 PowerShell용입니다. 키 만들기, Gradle 서명 연결, 플레이 콘솔 순서는 어느 PC에서나 그대로 참고할 수 있습니다.
Q. 비용은 얼마나 드나요?
스킬은 그냥 받아 쓰시면 됩니다. 구글 플레이 개발자 등록비 US$25(처음 한 번)는 구글에 직접 내야 하고, 클로드 코드를 쓰는 요금은 따로입니다.
Q. 웹앱을 Capacitor로 감싼 앱에도 쓸 수 있나요?
빌드 부분은 Flutter 전용입니다. 플레이 콘솔에 등록하는 순서는 똑같아서 그 부분은 그대로 쓸 수 있습니다.
Q. 이 스킬대로 하면 바로 스토어에 공개되나요?
내부 테스트 출시까지 다룹니다. 정식 공개 전에 해야 할 일(새 개인 계정의 테스터 12명·14일 요건 등)은 스킬 7번에 정리해 두었습니다.
스킬 뱅크의 다른 스킬 보기 →