Flutter/ShoreBird

Flutter ) ShoreBird 배포가이드

EEYatHo 2025. 4. 14. 16:54
반응형

OTA가 아닌, 새로운 버전을 스토어에 배포할 경우 shorebird Release

  1. pubspec.yaml 에서 version 수정 후 저장 (ex. version: 1.0.0+4 -> 1.0.1+5)
    • iOS의 Xcode 빌드 버전이나, Android의 local.properties 버전이 바로 바뀌지 않음
    • 앞의 버전이 바뀌어도 빌드번호는 올라가야함 (Android는 중복 빌드버전 금지)
  2. android 배포
    1. shorebird release android --artifact apk 실행
      • 이 명령어 실행시 Android의 local.properties 버전이 바뀜
    2. 이 파일로 Firebase App Distribution 배포 진행 build/app/outputs/apk/release/app-release.apk
    3. 이 파일로 PlayStore 배포 진행 build/app/outputs/bundle/release/app-release.aab
  3. iOS 배포
    1. shorebird release ios 실행
      • 이 명령어 실행시 Xcode의 빌드 버전이 바뀜
      • Xcode15 에러 발생시, 16.1로 변경 ( sudo xcode-select -s /Applications/Xcode16.1.app/Contents/Developer )
    2. build/ios/archive/Runner.xcarchive 파일 실행 (organizer 노출)
    3. custom > Manage Version and Build Number 체크 해제 후 Distribute App 진행

 

OTA 배포 할 경우, 해당 릴리즈에 Patch를 생성 (shorebird patch)

  • 릴리즈 생성 직후는 패치할 필요 없음. 아무 패치 없는 릴리즈가 기본.
  1. shorebird patch android
  2. shorebird patch ios
  • 이후 앱 실행시, 재실행 해달라는 업데이트 팝업 노출 재실행하면 Patch 적용됨
    (https://eeyatho.tistory.com/302 여기 글대로 팝업노출 작업을 했을 경우.)

 

Shorebird 문제 생겼을 경우, flutter 기본 배포 방법

flutter build apk --release --verbose

flutter build ios --release --verbose