botrun-horse 2.29.2 → 2.31.0

package/botrun-c/mobile-ios/fastlane/Fastfile

@@ -0,0 +1,326 @@
+# Fastfile for Botrun iOS Deployment
+# 自動化 iOS 部署流程
+
+default_platform(:ios)
+
+platform :ios do
+  # === 前置作業 ===
+
+  before_all do
+    # 確認環境變數
+    ensure_env_vars(
+      env_vars: ["IOS_PROJECT_PATH", "IOS_SCHEME"]
+    )
+  end
+
+  # === 輔助 Lane ===
+
+  # 建置 Web 專案並同步到 iOS
+  lane :build_web do
+    Dir.chdir("../../web") do
+      sh("npm run build")
+    end
+    UI.success("✅ Web 專案建置完成")
+  end
+
+  # 同步 Capacitor
+  lane :sync_capacitor do
+    Dir.chdir("../../mobile-ios") do
+      sh("npx cap sync ios")
+    end
+    UI.success("✅ Capacitor 同步完成")
+  end
+
+  # === 主要部署 Lane ===
+
+  # 🧪 內部測試 - Firebase App Distribution
+  desc "部署到 Firebase App Distribution（內部快速測試）"
+  lane :internal_firebase do
+    UI.header("🧪 開始 Firebase App Distribution 部署流程")
+
+    # 1. 建置 Web
+    build_web
+
+    # 2. 同步 Capacitor
+    sync_capacitor
+
+    # 3. 建置 Debug IPA（用於快速測試，不需要簽署配置）
+    ios_project = File.expand_path(ENV["IOS_PROJECT_PATH"], Dir.pwd)
+
+    build_app(
+      workspace: File.join(ios_project, "App.xcworkspace"),
+      scheme: ENV["IOS_SCHEME"],
+      configuration: "Debug",
+      export_method: "development",  # Development 簽署（需要開發者憑證）
+      output_directory: "./build",
+      output_name: "app-debug.ipa",
+      clean: true,
+      skip_codesigning: false
+    )
+
+    # 4. 上傳到 Firebase（如果有設定 Firebase）
+    if ENV["FIREBASE_APP_ID"] && ENV["FIREBASE_SERVICE_ACCOUNT"]
+      service_account_path = File.expand_path(ENV["FIREBASE_SERVICE_ACCOUNT"], Dir.pwd)
+
+      firebase_app_distribution(
+        app: ENV["FIREBASE_APP_ID"],
+        ipa_path: "./build/app-debug.ipa",
+        service_credentials_file: service_account_path,
+        groups: "internal-testers",
+        release_notes: "🔧 Internal build for testing\n\n#{changelog_from_git_commits(commits_count: 5, pretty: '- %s')}",
+        debug: true
+      )
+
+      UI.success("✅ Firebase App Distribution 部署完成！")
+      UI.important("📱 測試人員將收到 email 通知")
+    else
+      UI.important("⚠️  未設定 Firebase 環境變數，已建置 IPA 但未上傳")
+      UI.message("IPA 位置：./build/app-debug.ipa")
+    end
+  end
+
+  # 📦 TestFlight 內部測試
+  desc "部署到 TestFlight（Apple 官方內部測試）"
+  lane :internal_testflight do
+    UI.header("📦 開始 TestFlight 部署流程")
+
+    # 1. 建置 Web
+    build_web
+
+    # 2. 同步 Capacitor
+    sync_capacitor
+
+    # 3. 自動遞增 Build Number
+    ios_project = File.expand_path(ENV["IOS_PROJECT_PATH"], Dir.pwd)
+    xcodeproj_path = File.join(ios_project, "App.xcodeproj")
+
+    increment_build_number(
+      xcodeproj: xcodeproj_path
+    )
+
+    build_number = get_build_number(xcodeproj: xcodeproj_path)
+    UI.message("📱 新的 Build Number: #{build_number}")
+
+    # 4. 建置 Release IPA
+    build_app(
+      workspace: File.join(ios_project, "App.xcworkspace"),
+      scheme: ENV["IOS_SCHEME"],
+      configuration: "Release",
+      export_method: "app-store",  # App Store 簽署
+      output_directory: "./build",
+      output_name: "app-release.ipa",
+      clean: true,
+      include_bitcode: false,  # 2024 不再需要 bitcode
+      include_symbols: true,
+      xcargs: "-allowProvisioningUpdates",  # Archive 階段允許自動更新
+      export_xcargs: "-allowProvisioningUpdates"  # Export 階段允許自動更新
+    )
+
+    # 5. 上傳到 TestFlight
+    # 使用 App Store Connect API Key（2024 最佳實踐）
+    if ENV["IOS_API_KEY_PATH"]
+      # 1. 解析絕對路徑
+      api_key_path = File.expand_path(ENV["IOS_API_KEY_PATH"], File.dirname(__FILE__))
+      UI.message("🔑 API Key 路徑: #{api_key_path}")
+
+      # 2. 讀取檔案內容（避免路徑解析問題，更符合 Lane Context 機制）
+      api_key_content = File.read(api_key_path)
+      UI.message("📁 已讀取 API Key 內容 (#{api_key_content.bytesize} bytes)")
+
+      # 3. 設定 API Key（存入 Lane Context）
+      app_store_connect_api_key(
+        key_id: ENV["APP_STORE_CONNECT_API_KEY_ID"],
+        issuer_id: ENV["APP_STORE_CONNECT_API_ISSUER_ID"],
+        key_content: api_key_content,      # 使用內容而非路徑
+        is_key_content_base64: false,      # 明確指定不是 base64
+        duration: 1200,
+        in_house: false
+      )
+
+      # 4. 上傳（會從 Lane Context 讀取，不會被環境變數干擾）
+      upload_to_testflight(
+        ipa: "./build/app-release.ipa",
+        skip_waiting_for_build_processing: true,  # 不等待處理完成
+        changelog: changelog_from_git_commits(commits_count: 5, pretty: '- %s')
+      )
+    else
+      # 使用 Apple ID 登入（舊方法，不建議）
+      upload_to_testflight(
+        username: ENV["APPLE_ID"],
+        ipa: "./build/app-release.ipa",
+        skip_waiting_for_build_processing: true,
+        changelog: changelog_from_git_commits(commits_count: 5, pretty: '- %s')
+      )
+    end
+
+    UI.success("✅ TestFlight 部署完成！")
+    UI.important("⏳ 等待 Apple 審核（通常 10-30 分鐘）")
+    UI.message("📱 審核通過後，測試人員可在 TestFlight App 下載")
+  end
+
+  # 🚀 正式發佈 - Production
+  desc "部署到 App Store Production（正式發佈）"
+  lane :production do
+    UI.header("🚀 開始 App Store Production 部署流程")
+    UI.important("⚠️  即將發佈到 Production，影響所有用戶")
+
+    # 1. 建置 Web
+    build_web
+
+    # 2. 同步 Capacitor
+    sync_capacitor
+
+    # 3. 自動遞增 Build Number
+    ios_project = File.expand_path(ENV["IOS_PROJECT_PATH"], Dir.pwd)
+    xcodeproj_path = File.join(ios_project, "App.xcodeproj")
+
+    increment_build_number(
+      xcodeproj: xcodeproj_path
+    )
+
+    build_number = get_build_number(xcodeproj: xcodeproj_path)
+    version_number = get_version_number(xcodeproj: xcodeproj_path, target: ENV["IOS_SCHEME"])
+    UI.message("📱 版本: #{version_number} (#{build_number})")
+
+    # 4. 建置 Release IPA
+    build_app(
+      workspace: File.join(ios_project, "App.xcworkspace"),
+      scheme: ENV["IOS_SCHEME"],
+      configuration: "Release",
+      export_method: "app-store",
+      output_directory: "./build",
+      output_name: "app-release.ipa",
+      clean: true,
+      include_bitcode: false,
+      include_symbols: true,
+      xcargs: "-allowProvisioningUpdates",  # Archive 階段允許自動更新
+      export_xcargs: "-allowProvisioningUpdates"  # Export 階段允許自動更新
+    )
+
+    # 5. 上傳到 App Store Connect 並自動發佈
+    # 使用 App Store Connect API Key（2024 最佳實踐）
+    if ENV["IOS_API_KEY_PATH"]
+      # 1. 解析絕對路徑並讀取檔案內容
+      api_key_path = File.expand_path(ENV["IOS_API_KEY_PATH"], File.dirname(__FILE__))
+      api_key_content = File.read(api_key_path)
+
+      # 2. 設定 API Key（存入 Lane Context）
+      app_store_connect_api_key(
+        key_id: ENV["APP_STORE_CONNECT_API_KEY_ID"],
+        issuer_id: ENV["APP_STORE_CONNECT_API_ISSUER_ID"],
+        key_content: api_key_content,      # 使用內容而非路徑
+        is_key_content_base64: false,      # 明確指定不是 base64
+        duration: 1200,
+        in_house: false
+      )
+
+      upload_to_app_store(
+        ipa: "./build/app-release.ipa",
+        submit_for_review: true,  # 自動提交審核
+        automatic_release: true,  # 審核通過後自動發佈
+        skip_metadata: true,      # 不更新 metadata
+        skip_screenshots: true,   # 不更新截圖
+        precheck_include_in_app_purchases: false
+      )
+    else
+      # 使用 Apple ID 登入（舊方法，不建議）
+      upload_to_app_store(
+        username: ENV["APPLE_ID"],
+        ipa: "./build/app-release.ipa",
+        submit_for_review: true,
+        automatic_release: true,
+        skip_metadata: true,
+        skip_screenshots: true,
+        precheck_include_in_app_purchases: false
+      )
+    end
+
+    UI.success("✅ App Store Production 部署完成！")
+    UI.important("⏳ 等待 Apple 審核（通常 24-48 小時）")
+    UI.message("📱 審核通過後將自動發佈給所有用戶")
+  end
+
+  # === 進階 Lane ===
+
+  # 新增測試人員到 TestFlight
+  desc "新增測試人員到 TestFlight"
+  lane :add_testflight_testers do |options|
+    emails = options[:emails] || UI.input("請輸入 email（逗號分隔）：")
+
+    if ENV["APP_STORE_CONNECT_API_KEY_PATH"]
+      api_key_path = File.expand_path(ENV["APP_STORE_CONNECT_API_KEY_PATH"], Dir.pwd)
+
+      # 使用 Spaceship 或 Fastlane Boarding 新增測試人員
+      # 這需要額外設定，詳見文件
+      UI.message("請在 App Store Connect 手動新增測試人員：#{emails}")
+    else
+      UI.message("請在 App Store Connect 手動新增測試人員：#{emails}")
+    end
+  end
+
+  # 下載 dSYM 檔案（用於 Crash 分析）
+  desc "下載最新的 dSYM 檔案"
+  lane :download_dsyms do
+    if ENV["APP_STORE_CONNECT_API_KEY_PATH"]
+      api_key_path = File.expand_path(ENV["APP_STORE_CONNECT_API_KEY_PATH"], Dir.pwd)
+
+      download_dsyms(
+        api_key_path: api_key_path,
+        app_identifier: "ai.botrun.botrunapp",
+        output_directory: "./dsyms"
+      )
+
+      UI.success("✅ dSYM 檔案已下載到 ./dsyms/")
+    else
+      download_dsyms(
+        username: ENV["APPLE_ID"],
+        app_identifier: "ai.botrun.botrunapp",
+        output_directory: "./dsyms"
+      )
+    end
+  end
+
+  # 建置本地測試版本（不上傳）
+  desc "建置本地測試 IPA（不上傳任何平台）"
+  lane :build_local do
+    UI.header("🔨 開始建置本地測試版本")
+
+    # 1. 建置 Web
+    build_web
+
+    # 2. 同步 Capacitor
+    sync_capacitor
+
+    # 3. 建置 Debug IPA
+    ios_project = File.expand_path(ENV["IOS_PROJECT_PATH"], Dir.pwd)
+
+    build_app(
+      workspace: File.join(ios_project, "App.xcworkspace"),
+      scheme: ENV["IOS_SCHEME"],
+      configuration: "Debug",
+      export_method: "development",
+      output_directory: "./build",
+      output_name: "app-local.ipa",
+      clean: true
+    )
+
+    UI.success("✅ 本地測試版本建置完成！")
+    UI.message("📱 IPA 位置：./build/app-local.ipa")
+    UI.message("📱 可使用 Xcode 或 Apple Configurator 安裝到實體裝置")
+  end
+
+  # === 錯誤處理 ===
+
+  after_all do |lane|
+    # 成功後的清理工作
+    UI.success("🎉 Lane '#{lane}' 執行成功！")
+  end
+
+  error do |lane, exception|
+    # 失敗後的處理
+    UI.error("❌ Lane '#{lane}' 執行失敗")
+    UI.error("錯誤訊息：#{exception.message}")
+
+    # 可以在這裡加入通知（Slack, Discord 等）
+  end
+end

package/botrun-c/mobile-ios/fastlane/README.md

@@ -0,0 +1,88 @@
+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 build_web
+
+```sh
+[bundle exec] fastlane ios build_web
+```
+
+
+
+### ios sync_capacitor
+
+```sh
+[bundle exec] fastlane ios sync_capacitor
+```
+
+
+
+### ios internal_firebase
+
+```sh
+[bundle exec] fastlane ios internal_firebase
+```
+
+部署到 Firebase App Distribution（內部快速測試）
+
+### ios internal_testflight
+
+```sh
+[bundle exec] fastlane ios internal_testflight
+```
+
+部署到 TestFlight（Apple 官方內部測試）
+
+### ios production
+
+```sh
+[bundle exec] fastlane ios production
+```
+
+部署到 App Store Production（正式發佈）
+
+### ios add_testflight_testers
+
+```sh
+[bundle exec] fastlane ios add_testflight_testers
+```
+
+新增測試人員到 TestFlight
+
+### ios download_dsyms
+
+```sh
+[bundle exec] fastlane ios download_dsyms
+```
+
+下載最新的 dSYM 檔案
+
+### ios build_local
+
+```sh
+[bundle exec] fastlane ios build_local
+```
+
+建置本地測試 IPA（不上傳任何平台）
+
+----
+
+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).

package/botrun-c/mobile-ios/ios/App/App/App.entitlements

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>com.apple.developer.applesignin</key>
+	<array>
+		<string>Default</string>
+	</array>
+</dict>
+</plist>

package/botrun-c/mobile-ios/ios/App/App/AppDelegate.swift

@@ -0,0 +1,49 @@
+import UIKit
+import Capacitor
+
+@UIApplicationMain
+class AppDelegate: UIResponder, UIApplicationDelegate {
+
+    var window: UIWindow?
+
+    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+        // Override point for customization after application launch.
+        return true
+    }
+
+    func applicationWillResignActive(_ application: UIApplication) {
+        // Sent when the application is about to move from active to inactive state. This can occur for certain types of temporary interruptions (such as an incoming phone call or SMS message) or when the user quits the application and it begins the transition to the background state.
+        // Use this method to pause ongoing tasks, disable timers, and invalidate graphics rendering callbacks. Games should use this method to pause the game.
+    }
+
+    func applicationDidEnterBackground(_ application: UIApplication) {
+        // Use this method to release shared resources, save user data, invalidate timers, and store enough application state information to restore your application to its current state in case it is terminated later.
+        // If your application supports background execution, this method is called instead of applicationWillTerminate: when the user quits.
+    }
+
+    func applicationWillEnterForeground(_ application: UIApplication) {
+        // Called as part of the transition from the background to the active state; here you can undo many of the changes made on entering the background.
+    }
+
+    func applicationDidBecomeActive(_ application: UIApplication) {
+        // Restart any tasks that were paused (or not yet started) while the application was inactive. If the application was previously in the background, optionally refresh the user interface.
+    }
+
+    func applicationWillTerminate(_ application: UIApplication) {
+        // Called when the application is about to terminate. Save data if appropriate. See also applicationDidEnterBackground:.
+    }
+
+    func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
+        // Called when the app was launched with a url. Feel free to add additional processing here,
+        // but if you want the App API to support tracking app url opens, make sure to keep this call
+        return ApplicationDelegateProxy.shared.application(app, open: url, options: options)
+    }
+
+    func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
+        // Called when the app was launched with an activity, including Universal Links.
+        // Feel free to add additional processing here, but if you want the App API to support
+        // tracking app url opens, make sure to keep this call
+        return ApplicationDelegateProxy.shared.application(application, continue: userActivity, restorationHandler: restorationHandler)
+    }
+
+}

package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/AppIcon.appiconset/Contents.json

@@ -0,0 +1,14 @@
+{
+  "images": [
+    {
+      "idiom": "universal",
+      "size": "1024x1024",
+      "filename": "AppIcon-512@2x.png",
+      "platform": "ios"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}

package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Contents.json

@@ -0,0 +1,6 @@
+{
+  "info" : {
+    "version" : 1,
+    "author" : "xcode"
+  }
+}

package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Splash.imageset/Contents.json

@@ -0,0 +1,56 @@
+{
+  "images": [
+    {
+      "idiom": "universal",
+      "filename": "Default@1x~universal~anyany.png",
+      "scale": "1x"
+    },
+    {
+      "idiom": "universal",
+      "filename": "Default@2x~universal~anyany.png",
+      "scale": "2x"
+    },
+    {
+      "idiom": "universal",
+      "filename": "Default@3x~universal~anyany.png",
+      "scale": "3x"
+    },
+    {
+      "appearances": [
+        {
+          "appearance": "luminosity",
+          "value": "dark"
+        }
+      ],
+      "idiom": "universal",
+      "scale": "1x",
+      "filename": "Default@1x~universal~anyany-dark.png"
+    },
+    {
+      "appearances": [
+        {
+          "appearance": "luminosity",
+          "value": "dark"
+        }
+      ],
+      "idiom": "universal",
+      "scale": "2x",
+      "filename": "Default@2x~universal~anyany-dark.png"
+    },
+    {
+      "appearances": [
+        {
+          "appearance": "luminosity",
+          "value": "dark"
+        }
+      ],
+      "idiom": "universal",
+      "scale": "3x",
+      "filename": "Default@3x~universal~anyany-dark.png"
+    }
+  ],
+  "info": {
+    "version": 1,
+    "author": "xcode"
+  }
+}

package/botrun-c/mobile-ios/ios/App/App/Base.lproj/LaunchScreen.storyboard

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="17132" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="01J-lp-oVM">
+    <device id="retina4_7" orientation="portrait" appearance="light"/>
+    <dependencies>
+        <deployment identifier="iOS"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="17105"/>
+        <capability name="System colors in document resources" minToolsVersion="11.0"/>
+        <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
+    </dependencies>
+    <scenes>
+        <!--View Controller-->
+        <scene sceneID="EHf-IW-A2E">
+            <objects>
+                <viewController id="01J-lp-oVM" sceneMemberID="viewController">
+                    <imageView key="view" userInteractionEnabled="NO" contentMode="scaleAspectFill" horizontalHuggingPriority="251" verticalHuggingPriority="251" image="Splash" id="snD-IY-ifK">
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
+                        <autoresizingMask key="autoresizingMask"/>
+                        <color key="backgroundColor" systemColor="systemBackgroundColor"/>
+                    </imageView>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="iYj-Kq-Ea1" userLabel="First Responder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="53" y="375"/>
+        </scene>
+    </scenes>
+    <resources>
+        <image name="Splash" width="1366" height="1366"/>
+        <systemColor name="systemBackgroundColor">
+            <color white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+        </systemColor>
+    </resources>
+</document>

package/botrun-c/mobile-ios/ios/App/App/Base.lproj/Main.storyboard

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="14111" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" colorMatched="YES" initialViewController="BYZ-38-t0r">
+    <device id="retina4_7" orientation="portrait">
+        <adaptation id="fullscreen"/>
+    </device>
+    <dependencies>
+        <deployment identifier="iOS"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="14088"/>
+    </dependencies>
+    <scenes>
+        <!--Bridge View Controller-->
+        <scene sceneID="tne-QT-ifu">
+            <objects>
+                <viewController id="BYZ-38-t0r" customClass="CAPBridgeViewController" customModule="Capacitor" sceneMemberID="viewController"/>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="dkx-z0-nzr" sceneMemberID="firstResponder"/>
+            </objects>
+        </scene>
+    </scenes>
+</document>