Add TestFlight release automation

README.md

@@ -18,7 +18,7 @@ For a Simulator launch from the command line:
 
 ```sh
 SIMCTL_CHILD_HOME_ASSISTANT_ACCESS_TOKEN='token' \
-  xcrun simctl launch booted com.zanneth.XIONControlPanel
+  xcrun simctl launch booted net.buzzert.XaibatsuControlPanel
 ```
 
 The client disconnects cleanly when the app resigns active, reconnects and
@@ -40,3 +40,24 @@ xcodebuild -project XIONControlPanel.xcodeproj \
   -only-testing:XIONControlPanelTests/HomeAssistantIntegrationTests \
   test
 ```
+
+TestFlight releases
+--------------------------------------------------------------------------------
+
+Gitea Actions publishes tags named `release/vX.X.X` to TestFlight. The semantic
+version from the tag and the Gitea `GITHUB_RUN_NUMBER` are written into the
+app's Info.plist before it is archived. For example:
+
+```sh
+git tag -a release/v2.0.0 -m 'Release 2.0.0'
+git push origin release/v2.0.0
+```
+
+The workflow uses the `macos-arm64` runner and Fastlane Match. It expects these
+repository Actions secrets:
+
+- `APP_STORE_CONNECT_KEY_ID`
+- `APP_STORE_CONNECT_ISSUER_ID`
+- `APP_STORE_CONNECT_KEY_CONTENT`
+- `MATCH_PASSWORD`
+- `MATCH_GIT_BASIC_AUTHORIZATION`