fix: improve TestFlight beta distribution configuration

- Handle missing API key gracefully for local environments
- Use default 'External' group for testers
- Add beta app review information
- Add error handling for distribution failures
- Support both CI and local environments

Author: graycreate

fastlane/Fastfile

@@ -5,12 +5,26 @@ default_platform(:ios)
 platform :ios do
   # Helper method to get App Store Connect API key
   private_lane :get_api_key do
-    # Read the key content directly
-    key_content = File.read(ENV["APP_STORE_CONNECT_API_KEY_KEY"])
+    # Check if running in CI or local
+    if ENV["APP_STORE_CONNECT_API_KEY_KEY"]
+      # CI environment with key file path
+      key_content = File.read(ENV["APP_STORE_CONNECT_API_KEY_KEY"])
+    elsif ENV["APP_STORE_CONNECT_API_KEY_CONTENT"]
+      # Local environment with key content directly
+      key_content = ENV["APP_STORE_CONNECT_API_KEY_CONTENT"]
+    else
+      # Try to read from standard location
+      key_path = File.expand_path("~/.appstoreconnect/private_keys/AuthKey_#{ENV["APP_STORE_CONNECT_KEY_ID"]}.p8")
+      if File.exist?(key_path)
+        key_content = File.read(key_path)
+      else
+        UI.user_error!("App Store Connect API key not found. Please set APP_STORE_CONNECT_API_KEY_CONTENT environment variable or place the key at #{key_path}")
+      end
+    end
 
     app_store_connect_api_key(
-      key_id: ENV["APP_STORE_CONNECT_API_KEY_KEY_ID"],
-      issuer_id: ENV["APP_STORE_CONNECT_API_KEY_ISSUER_ID"],
+      key_id: ENV["APP_STORE_CONNECT_KEY_ID"] || ENV["APP_STORE_CONNECT_API_KEY_KEY_ID"],
+      issuer_id: ENV["APP_STORE_CONNECT_ISSUER_ID"] || ENV["APP_STORE_CONNECT_API_KEY_ISSUER_ID"],
       key_content: key_content,
       in_house: false
     )
@@ -58,28 +72,33 @@ platform :ios do
     # Get the build number to distribute (optional)
     build_number = options[:build_number]
 
-    if build_number
-      # Distribute specific build
-      distribute_build(
-        api_key: api_key,
-        build_number: build_number,
-        groups: ["Beta Testers"],
-        notify_external_testers: true,
-        uses_non_exempt_encryption: false,
-        submit_beta_review: true
-      )
-    else
-      # Wait for latest build to process and distribute
+    begin
+      # Distribute to beta testers
       testflight(
         api_key: api_key,
+        app_identifier: "v2er.app",
         skip_submission: false,
         distribute_external: true,
-        groups: ["Beta Testers"],
+        groups: ["External"],  # Default external tester group
         notify_external_testers: true,
         uses_non_exempt_encryption: false,
         submit_beta_review: true,
-        wait_for_uploaded_build: true
+        wait_for_uploaded_build: true,
+        beta_app_review_info: {
+          contact_email: "support@v2er.app",
+          contact_first_name: "V2er",
+          contact_last_name: "Support",
+          contact_phone: "+1234567890",
+          demo_account_name: "",
+          demo_account_password: "",
+          notes: "This is a V2EX forum client app. No special account needed for testing."
+        }
       )
+
+      UI.success("✅ Successfully distributed build to beta testers!")
+    rescue => e
+      UI.error("Failed to distribute: #{e.message}")
+      UI.message("You may need to manually distribute the build in App Store Connect")
     end
   end
 

fastlane/README.md

@@ -0,0 +1,72 @@
+fastlane documentation
+----
+
+# Installation
+
+Make sure you have the latest version of the Xcode command line tools installed:
+
+```sh
+xcode-select --install
+```
+
+For _fastlane_ installation instructions, see [Installing _fastlane_](https://docs.fastlane.tools/#installing-fastlane)
+
+# Available Actions
+
+## iOS
+
+### ios sync_certificates
+
+```sh
+[bundle exec] fastlane ios sync_certificates
+```
+
+Sync certificates and provisioning profiles
+
+### ios distribute_beta
+
+```sh
+[bundle exec] fastlane ios distribute_beta
+```
+
+Distribute existing build to beta testers
+
+### ios beta
+
+```sh
+[bundle exec] fastlane ios beta
+```
+
+Build and upload to TestFlight
+
+### ios release
+
+```sh
+[bundle exec] fastlane ios release
+```
+
+Submit to App Store Review
+
+### ios create_app_version
+
+```sh
+[bundle exec] fastlane ios create_app_version
+```
+
+Create a new version on App Store Connect
+
+### ios download_metadata
+
+```sh
+[bundle exec] fastlane ios download_metadata
+```
+
+Download metadata from App Store Connect
+
+----
+
+This README.md is auto-generated and will be re-generated every time [_fastlane_](https://fastlane.tools) is run.
+
+More information about _fastlane_ can be found on [fastlane.tools](https://fastlane.tools).
+
+The documentation of _fastlane_ can be found on [docs.fastlane.tools](https://docs.fastlane.tools).