project-auto-wizard 0.13.2 → 0.14.0

package/payload/flutter-app/ios/fastlane/Fastfile

@@ -1,55 +1,69 @@
 # ===================================================================
-# 이 파일은 사용자 소유입니다. 모드별 동작을 여기서 수정하세요.
+# This file is user-owned. Edit the per-mode behavior here.
 # ===================================================================
 #
-# iOS 배포용 Fastfile 템플릿입니다. Flutter 워크플로우가 IPA를 만든 뒤
-# `cd ios && bundle exec fastlane <lane>`으로 실행합니다.
-# project-auto-wizard는 이 파일이 이미 있으면 덮어쓰지 않으므로 자유롭게 수정해도 됩니다.
+# Fastfile template for iOS deployment. After the Flutter workflow builds the IPA, it runs
+# `cd ios && bundle exec fastlane <lane>`.
+# project-auto-wizard does not overwrite this file if it already exists, so feel free to edit it.
 #
-# lane
-#   deploy              PROJECT-FLUTTER-IOS-TESTFLIGHT 워크플로우 (DEPLOY_MODE에 따라 분기)
-#   upload_testflight   PROJECT-FLUTTER-IOS-TEST-TESTFLIGHT 워크플로우 (IPA를 TestFlight에 올리기만 함)
+# Lanes
+#   deploy              PROJECT-FLUTTER-IOS-TESTFLIGHT workflow (branches on DEPLOY_MODE)
+#   upload_testflight   PROJECT-FLUTTER-IOS-TEST-TESTFLIGHT workflow (only uploads the IPA to TestFlight)
 #
-# deploy lane의 배포 모드 (워크플로우가 DEPLOY_MODE 환경변수로 전달)
-# ┌───────────────┬──────────────────────────────────────────────────────────────┐
-# │ DEPLOY_MODE   │ 동작                                                         │
-# ├───────────────┼──────────────────────────────────────────────────────────────┤
-# │ store_only    │ TestFlight 업로드까지 (upload_to_testflight)                 │
-# │ store_prepare │ TestFlight 업로드 후, App Store 버전과 메타데이터를 준비     │
-# │               │ (upload_to_app_store, submit_for_review: false). 빌드는 이   │
-# │               │ 단계에서 버전에 연결되지 않고, store_submit이 build_number   │
-# │               │ 로 다시 호출될 때 한번에 연결·제출됩니다.                    │
-# │ store_submit  │ store_prepare와 같은 호출이고 심사 제출까지 진행             │
-# │               │ (submit_for_review: true, 이때 빌드가 버전에 연결됩니다)     │
-# └───────────────┴──────────────────────────────────────────────────────────────┘
-# 알 수 없는 값이나 빈 값은 store_only로 처리합니다.
+# Deploy modes of the deploy lane (passed by the workflow via the DEPLOY_MODE environment variable)
+# +---------------+--------------------------------------------------------------+
+# | DEPLOY_MODE   | Behavior                                                     |
+# +---------------+--------------------------------------------------------------+
+# | store_only    | Up to the TestFlight upload (upload_to_testflight)           |
+# | store_prepare | After the TestFlight upload, prepare the App Store version   |
+# |               | and metadata (upload_to_app_store, submit_for_review: false).|
+# |               | The build is not attached to the version at this stage; it   |
+# |               | is attached and submitted in one go when store_submit calls  |
+# |               | this again with build_number.                                |
+# | store_submit  | Same call as store_prepare, but also submits for review      |
+# |               | (submit_for_review: true; the build is attached to the       |
+# |               | version at this point)                                       |
+# +---------------+--------------------------------------------------------------+
+# Unknown or empty values are treated as store_only.
 #
-# 워크플로우가 넘기는 환경변수
+# Environment variables passed by the workflow
 #   APP_STORE_CONNECT_API_KEY_ID   App Store Connect API Key ID
 #   APP_STORE_CONNECT_ISSUER_ID    App Store Connect Issuer ID
-#   API_KEY_PATH                   AuthKey_XXXX.p8 파일 경로
-#   IPA_PATH                       업로드할 .ipa 절대경로
-#   RELEASE_NOTES                  TestFlight "What to Test" 문구 (changelog)
-#   APP_IDENTIFIER                 번들 ID (upload_testflight lane은 없으면 fastlane이 추론하지만,
-#                                  deploy lane의 store_prepare/store_submit은 필수입니다)
-#   DEPLOY_MODE                    위 표의 배포 모드 (deploy lane만)
-#   APP_VERSION, BUILD_NUMBER      앱 버전, 빌드 번호 (deploy lane만)
-#   SKIP_WAITING_FOR_BUILD_PROCESSING  "true"면 빌드 처리 완료를 기다리지 않음 (store_only만 적용)
+#   API_KEY_PATH                   Path to the AuthKey_XXXX.p8 file
+#   IPA_PATH                       Absolute path of the .ipa to upload
+#   RELEASE_NOTES                  TestFlight "What to Test" text (changelog)
+#   APP_IDENTIFIER                 Bundle ID (the upload_testflight lane lets fastlane infer it if missing,
+#                                  but store_prepare/store_submit in the deploy lane require it)
+#   DEPLOY_MODE                    Deploy mode from the table above (deploy lane only)
+#   APP_VERSION, BUILD_NUMBER      App version and build number (deploy lane only)
+#   SKIP_WAITING_FOR_BUILD_PROCESSING  If "true", do not wait for build processing (store_only only)
 #
-# 참고
-# - store_prepare/store_submit은 App Store 버전에 빌드를 연결해야 하므로 빌드 처리가 끝날 때까지
-#   기다립니다 (SKIP_WAITING_FOR_BUILD_PROCESSING을 무시).
-# - 스크린샷은 올리지 않습니다. 메타데이터는 ios/fastlane/metadata/ 아래에 파일이 있을 때만 올립니다.
-#   심사 제출 시 "What's New" 등 필수 항목은 이 폴더나 App Store Connect에서 미리 채워 두세요.
-# - store_submit에서 수출 규정 오류가 나면 Info.plist에 ITSAppUsesNonExemptEncryption을 지정하거나
-#   upload_to_app_store에 submission_information을 추가하세요.
-# - store_submit은 심사 승인 후 자동 출시하지 않습니다 (automatic_release: false).
+# Notes
+# - store_prepare/store_submit must attach the build to the App Store version, so they wait until
+#   build processing finishes (SKIP_WAITING_FOR_BUILD_PROCESSING is ignored).
+# - Screenshots are not uploaded. Metadata is uploaded only when files exist under ios/fastlane/metadata/.
+#   Fill in required items such as "What's New" in that folder or in App Store Connect before submitting for review.
+# - If store_submit fails on export compliance, set ITSAppUsesNonExemptEncryption in Info.plist or
+#   add submission_information to upload_to_app_store.
+# - store_submit does not auto-release after review approval (automatic_release: false).
 
 default_platform(:ios)
 
+# Look up a user-facing message in the installed catalog so it follows `language` in version.yml.
+# Finds the repo root by walking up to .github/scripts/messages.py (it reads ./version.yml from there);
+# falls back to the key when the catalog is unavailable (for example when fastlane runs on a laptop).
+def paw_msg(key, **params)
+  root = Dir.pwd
+  root = File.dirname(root) until File.exist?(File.join(root, ".github", "scripts", "messages.py")) || root == File.dirname(root)
+  out = IO.popen(["python3", File.join(root, ".github", "scripts", "messages.py"), "get", key, *params.map { |k, v| "#{k}=#{v}" }], chdir: root, err: File::NULL, &:read)
+  $?.success? && !out.to_s.strip.empty? ? out.chomp : key
+rescue StandardError
+  key
+end
+
 def require_env(name)
   value = ENV[name].to_s.strip
-  UI.user_error!("#{name} 환경변수가 비어 있습니다. 워크플로우에서 값을 전달하는지 확인하세요.") if value.empty?
+  UI.user_error!(paw_msg("fastlane.env_empty", name: name)) if value.empty?
   value
 end
 
@@ -61,7 +75,7 @@ def load_api_key
   )
 end
 
-# APP_IDENTIFIER가 있을 때만 옵션에 포함해, 없으면 fastlane 기본 추론에 맡깁니다.
+# Include APP_IDENTIFIER in the options only when set; otherwise leave it to fastlane's default inference.
 def app_identifier_option
   app_identifier = ENV["APP_IDENTIFIER"].to_s.strip
   app_identifier.empty? ? {} : { app_identifier: app_identifier }
@@ -79,19 +93,19 @@ def upload_ipa_to_testflight(api_key, skip_waiting_for_build_processing)
 end
 
 platform :ios do
-  desc "IPA를 TestFlight에 업로드합니다 (테스트 빌드용)"
+  desc "Uploads the IPA to TestFlight (for test builds)"
   lane :upload_testflight do
     upload_ipa_to_testflight(load_api_key, false)
   end
 
-  desc "IPA를 업로드하고 DEPLOY_MODE에 따라 TestFlight / 심사 준비 / 심사 제출까지 진행합니다"
+  desc "Uploads the IPA and, depending on DEPLOY_MODE, proceeds to TestFlight / review preparation / review submission"
   lane :deploy do
     api_key = load_api_key
     deploy_mode = ENV["DEPLOY_MODE"].to_s.strip
 
     case deploy_mode
     when "store_prepare", "store_submit"
-      UI.message("DEPLOY_MODE=#{deploy_mode}: 빌드 처리 완료까지 기다린 뒤 App Store 버전을 준비합니다.")
+      UI.message(paw_msg("fastlane.ios_prepare_wait", deploy_mode: deploy_mode))
       upload_ipa_to_testflight(api_key, false)
 
       upload_to_app_store(
@@ -110,7 +124,7 @@ platform :ios do
     when "store_only"
       upload_ipa_to_testflight(api_key, ENV["SKIP_WAITING_FOR_BUILD_PROCESSING"].to_s.strip.downcase == "true")
     else
-      UI.important("알 수 없는 DEPLOY_MODE '#{deploy_mode}' 입니다. store_only로 처리합니다.") unless deploy_mode.empty?
+      UI.important(paw_msg("fastlane.deploy_mode_unknown", deploy_mode: deploy_mode)) unless deploy_mode.empty?
       upload_ipa_to_testflight(api_key, ENV["SKIP_WAITING_FOR_BUILD_PROCESSING"].to_s.strip.downcase == "true")
     end
   end