Skip to content

Latest commit

 

History

History
135 lines (94 loc) · 5.04 KB

CONTRIBUTING.md

File metadata and controls

135 lines (94 loc) · 5.04 KB
Raw

기여하기

How to release( ~ 2024.02.24 )

  1. Releases에 갑니다.
  2. 이번 버전에서 변경된 사항을 Changes에 작성합니다.드래프트로 올립니다.
  3. pubspec.yaml의 버전을 하나 올리는 커밋을 원격 저장소에 Pull Request하고 Merge 합니다.
  4. fastlane으로 Android와 iOS에 deploy를 합니다.
  5. github release 페이지에서 드래프트를 풉니다.

버전을 하나 올린 후 flutter build ios를 반드시 실행해 주도록 합니다

ios FastFile에 sh "flutter build ios --release --no-codesign --no-tree-shake-icons" 추가해서 fastlane시 항상 자동으로 빌드하도록 수정했습니다.

How to release( 2024.02.25 ~ )

릴리즈 노트를 자동으로 작성하는 cd 코드를 추가했습니다.

  1. pubspec.yaml의 버전을 하나 올리는 커밋을 원격 저장소에 Pull Request하고 Merge 합니다.
  2. 아래 How to deploy 항목을 보고 Android와 iOS에 deploy를 합니다.
  3. Releases 페이지에서 자동으로 등록된 릴리즈 노트의 내용을 수정합니다.

How to deploy

Fastlane 설정

공식 홈페이지를 참고하였습니다. Continuous Delivery using fastlane with Flutter

아래 명령어를 최초 1회 실행하여 bundler를 설치합니다.

gem install bundler

/android와 /ios폴더에서 아래 명령어를 최초 1회 실행합니다.

bundle install

Credentials(Android)

  • android/fastlane/newara-fastlane.json : Google Play 서비스 계정 JSON 파일

  • android/fastlane/upload-keystore.jks : Android App Signing Key for Upload Google Play


- `android/fastlane/.env` : 아래와 같이 각자 개인이 발급 받은 GITHUB_API_TOKEN을 추가합니다. 
GITHUB_API_TOKEN=****************************************

GITHUB_API_TOKEN 발급 받는 법 상단 우측에 한국어 버젼 선택 가능

  • android/key.properties : 아래와 같이 Signing Key 정보를 입력합니다.
storeFile=../fastlane/upload-keystore.jks
storePassword=********
keyPassword=********
keyAlias=upload

Credentials(iOS)

  • ios/fastlane/.env.default : 아래와 같이 본인의 Apple ID 계정 정보와 개인이 발급 받은 GITHUB_API_TOKEN를 입력합니다.
FASTLANE_USER=****@****.***
FASTLANE_PASSWORD=********
FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD=****-****-****-****
GITHUB_API_TOKEN=****************************************

APPLE application specific password(앱 암호) 발급 받는 법


  • ios/fastlane/Appfile : 아래와 같이 Applefile이 되어있나 확인합니다.
app_identifier("org.sparcs.new-ara-app") # The bundle identifier of your app
apple_id(ENV["FASTLANE_USER"]) # It automatically references .env.deault file

itc_team_name("SPARCS") # App Store Connect Team Name
team_id("N5V8W52U3U") # Developer Portal Team ID

알파 버전 배포 명령어

  • Android: Google Play 스토어 비공개 테스트 - Alpha 트랙으로 업로드
  • iOS: TestFlight로 업로드

앱에서 배포 서버는 production을 기본으로 합니다

프로젝트 루트 디렉토리에서 아래 명령어 시 pubspec.yaml에 있는 버젼 정보와 현재 시각으로 지정된 빌드 정보 기준으로 업로드 됩니다.

cd android && bundle exec fastlane alpha env:production && cd ../ios && bundle exec fastlane alpha env:production

아래 예시처럼 하나의 플랫폼에도 배포가 가능합니다.

cd ios && bundle exec fastlane alpha env:production

아래 예시처럼 dev 서버와 연결된 앱 배포도 가능합니다.

cd ios && bundle exec fastlane alpha env:development

아래 예시처럼 개별 fastlane 실행도 가능합니다. 아래는 깃허브 태그를 만드는 fastlane입니다.

bundle exec fastlane create_release_note short_name:prod

배포 후 작업

  • pubspec.yaml 변경 사항을 Discard 합니다.
  • iOS Xcode 프로젝트 관련 파일들( ios/Runner.xcodeproj/project.pbxproj, ios/Runner/Info.plist )의 변경사항을 Discard 합니다.

English translation

  • 외부 패키지 사용했으니 자세한 내용은 easy_localization 문서 읽어주시기 바랍니다.

  • assets/translations에 번역 파일을 json 형식으로 저장하고 있습니다.

  • json 수정할 때마다 프로젝트의 root 디렉토리에서 아래 명령어 실행 후 dart 파일 내에서 LocaleKeys.**** 같은 클래스 형식으로 가능합니다.

dart run easy_localization:generate -S "assets/translations" -O "lib/translations" && dart run easy_localization:generate -S "assets/translations" -O "lib/translations" -f keys -o locale_keys.g.dart