[PM-27049] Initial version of the Test Harness app (#2142)

Author: fedemkr

Bitwarden.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,19 @@
+CODE_SIGN_STYLE = Automatic
+DEVELOPMENT_TEAM = LTZ2PFU5D6
+ORGANIZATION_IDENTIFIER = com.bitwarden
+BASE_BUNDLE_ID = $(ORGANIZATION_IDENTIFIER).testharness
+SHARED_APP_GROUP_IDENTIFIER = group.${ORGANIZATION_IDENTIFIER}.testharness
+APPICON_NAME = AppIcon
+
+// The above code signing settings can be overriden by adding a Local-bwth.xcconfig
+// file in the Configs directory.
+//
+// As an example, add the file Local-bwth.xcconfig with the following contents:
+//
+//    DEVELOPMENT_TEAM = <Your team ID>
+//    ORGANIZATION_IDENTIFIER = <Your reversed domain name>
+//    PROVISIONING_PROFILE_SPECIFIER = <Optional provisioning profile specifier for the main app>
+//
+// This should allow Xcode to build the application based on these settings without
+// code signing errors or having to modify the project itself.
+//

Configs/Common-bwth.xcconfig

@@ -0,0 +1,8 @@
+#include "./Common-bwth.xcconfig"
+#include "./Base-Debug.xcconfig"
+#include? "./Local-bwth.xcconfig"
+
+ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon
+CODE_SIGN_ENTITLEMENTS = TestHarness/Application/Support/Entitlements/TestHarness.entitlements
+PRODUCT_BUNDLE_IDENTIFIER = $(BASE_BUNDLE_ID)
+SWIFT_ACTIVE_COMPILATION_CONDITIONS = $(inherited) PREVIEWS $(BITWARDEN_FLAGS)

Configs/TestHarness-Debug.xcconfig

@@ -0,0 +1,8 @@
+#include "./Common-bwth.xcconfig"
+#include "./Base-Release.xcconfig"
+#include? "./Local-bwth.xcconfig"
+
+ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon
+CODE_SIGN_ENTITLEMENTS = TestHarness/Application/Support/Entitlements/TestHarness.entitlements
+PRODUCT_BUNDLE_IDENTIFIER = $(BASE_BUNDLE_ID)
+SWIFT_ACTIVE_COMPILATION_CONDITIONS = $(inherited) $(BITWARDEN_FLAGS)

Configs/TestHarness-Release.xcconfig

@@ -0,0 +1,6 @@
+#include "./Common-bwth.xcconfig"
+#include "./Base-Debug.xcconfig"
+#include? "./Local-bwth.xcconfig"
+
+PRODUCT_BUNDLE_IDENTIFIER = $(BASE_BUNDLE_ID).testharness-shared
+SWIFT_ACTIVE_COMPILATION_CONDITIONS = $(inherited) $(BITWARDEN_FLAGS)

Configs/TestHarnessShared-Debug.xcconfig

@@ -0,0 +1,6 @@
+#include "./Common-bwth.xcconfig"
+#include "./Base-Release.xcconfig"
+#include? "./Local-bwth.xcconfig"
+
+PRODUCT_BUNDLE_IDENTIFIER = $(BASE_BUNDLE_ID).testharness-shared
+SWIFT_ACTIVE_COMPILATION_CONDITIONS = $(inherited) $(BITWARDEN_FLAGS)

Configs/TestHarnessShared-Release.xcconfig

@@ -0,0 +1,5 @@
+import Foundation
+
+/// Global test helpers for TestHarness tests.
+///
+/// This file provides shared testing utilities used across the TestHarness test suite.

GlobalTestHelpers-bwth/GlobalTestHelpers.swift

@@ -0,0 +1,40 @@
+# Test Harness
+
+A playground application for testing and demonstrating various Bitwarden iOS features and flows.
+
+## Overview
+
+The Test Harness app provides a simple interface to trigger and test different scenarios within the Bitwarden iOS ecosystem, including:
+
+- Password Autofill flows
+- Passkey Autofill flows (coming soon)
+- Passkey Creation flows (coming soon)
+
+## Purpose
+
+This app is designed for:
+- Manual testing of specific flows
+- Demonstrating feature functionality
+- Debugging and development
+- Integration testing scenarios
+
+## Structure
+
+The app follows the same architectural patterns as the main Bitwarden apps:
+- Coordinator-based navigation
+- Processor/State/Action/Effect pattern for views
+- Service container for dependency injection
+- Sourcery for mock generation
+
+## Building
+
+The Test Harness is part of the main iOS workspace. To build:
+
+1. Run `./Scripts/bootstrap.sh` to generate the Xcode project
+2. Open `Bitwarden.xcworkspace`
+3. Select the `TestHarness` scheme
+4. Build and run
+
+## Note
+
+This is a development/testing tool and is not intended for production use or App Store distribution.

README-bwth.md

@@ -13,6 +13,7 @@ repo_root=$(dirname "$script_dir")
 mint run xcodegen --spec "$repo_root/project-bwk.yml"
 mint run xcodegen --spec "$repo_root/project-pm.yml"
 mint run xcodegen --spec "$repo_root/project-bwa.yml"
+mint run xcodegen --spec "$repo_root/project-bwth.yml"
 echo "✅ Bootstrapped!"
 
 # Check Xcode version matches .xcode-version

Scripts/bootstrap.sh

@@ -0,0 +1,41 @@
+import BitwardenKit
+import TestHarnessShared
+import UIKit
+
+/// A protocol for an `AppDelegate` that can be used by the `SceneDelegate` to look up the
+/// `AppDelegate` when the app is running (`AppDelegate`) or testing (`TestingAppDelegate`).
+protocol AppDelegateType: AnyObject {
+    /// The processor that manages application level logic.
+    var appProcessor: AppProcessor? { get }
+
+    /// Whether the app is running for unit tests.
+    var isTesting: Bool { get }
+}
+
+/// The app's `UIApplicationDelegate` which serves as the entry point into the app.
+class AppDelegate: UIResponder, UIApplicationDelegate, AppDelegateType {
+    // MARK: Properties
+
+    /// The processor that manages application level logic.
+    var appProcessor: AppProcessor?
+
+    /// Whether the app is running for unit tests.
+    var isTesting: Bool {
+        ProcessInfo.processInfo.arguments.contains("-testing")
+    }
+
+    // MARK: Methods
+
+    func application(
+        _: UIApplication,
+        didFinishLaunchingWithOptions _: [UIApplication.LaunchOptionsKey: Any]? = nil,
+    ) -> Bool {
+        // Exit early if testing to avoid running any app functionality.
+        guard !isTesting else { return true }
+
+        let services = ServiceContainer()
+        let appModule = DefaultAppModule(services: services)
+        appProcessor = AppProcessor(appModule: appModule, services: services)
+        return true
+    }
+}