Add custom installation to sample

Samples/Common/Sources/LibraryBridge/InstallBridge.swift

@@ -28,6 +28,7 @@ import Foundation
 import Combine
 import SwiftUI
 import KSCrashRecording
+import KSCrashInstallations
 import Logging
 
 public enum BasePath: String, CaseIterable {
@@ -71,6 +72,7 @@ public class InstallBridge: ObservableObject {
     @Published public var error: InstallationError?
 
     @Published public var reportStore: CrashReportStore?
+    @Published public var installation: CrashInstallation?
 
     public init() {
         config = .init()
@@ -81,16 +83,9 @@ public class InstallBridge: ObservableObject {
             .store(in: &disposables)
     }
 
-    public func install() {
-        guard !installed else {
-            error = .alreadyInstalled
-            return
-        }
-
+    private func handleInstallation(_ block: () throws -> Void) {
         do {
-            try KSCrash.shared.install(with: config)
-            reportStore = KSCrash.shared.reportStore
-            installed = true
+            try block()
         } catch let error as KSCrashInstallError {
             let message = error.localizedDescription
             Self.logger.error("Failed to install KSCrash: \(message)")
@@ -102,6 +97,33 @@ public class InstallBridge: ObservableObject {
         }
     }
 
+    public func install() {
+        guard !installed else {
+            error = .alreadyInstalled
+            return
+        }
+
+        handleInstallation {
+            try KSCrash.shared.install(with: config)
+            reportStore = KSCrash.shared.reportStore
+            installed = true
+        }
+    }
+
+    public func useInstallation(_ installation: CrashInstallation) {
+        guard !installed else {
+            error = .alreadyInstalled
+            return
+        }
+
+        handleInstallation {
+            try installation.install(with: config)
+            reportStore = KSCrash.shared.reportStore
+            self.installation = installation
+            installed = true
+        }
+    }
+
     public func setupReportsOnly() {
         do {
             let config = CrashReportStoreConfiguration()

Samples/Common/Sources/LibraryBridge/SampleInstallation.swift

@@ -0,0 +1,52 @@
+//
+//  SampleInstallation.swift
+//
+//  Created by Nikolay Volosatov on 2024-10-27.
+//
+//  Copyright (c) 2012 Karl Stenerud. All rights reserved.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall remain in place
+// in this source code.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+//
+
+import KSCrashInstallations
+import KSCrashFilters
+import Logging
+
+public class SampleInstallation: CrashInstallation {
+    public enum InstallationError: String, Error {
+        case missingHeaderMessage
+    }
+    private static let logger = Logger(label: "SampleInstallation")
+
+    public var headerMessage: String? = "Hello!"
+
+    public override func validateSetup() throws {
+        if headerMessage == nil {
+            throw InstallationError.missingHeaderMessage
+        }
+    }
+
+    public override func sink() -> any CrashReportFilter {
+        Self.logger.info("Header message: \(headerMessage ?? "<undefined>")")
+        return CrashReportFilterPipeline(filters: [
+            SampleFilter(),
+            SampleSink(),
+        ])
+    }
+}

Samples/Common/Sources/SampleUI/Screens/InstallView.swift

@@ -81,6 +81,12 @@ struct InstallView: View {
                 }
             }
 
+            Section(header: Text("Installations")) {
+                Button("SampleInstallation") {
+                    bridge.useInstallation(SampleInstallation())
+                }
+            }
+
             Button("Only set up reports") {
                 bridge.setupReportsOnly()
             }

Samples/Common/Sources/SampleUI/Screens/MainView.swift

@@ -32,6 +32,9 @@ struct MainView: View {
 
     @ObservedObject var bridge: InstallBridge
 
+    @State var alertMessage: String?
+    @State var alertIsPresented: Bool = false
+
     var body: some View {
         List {
             Section {
@@ -53,6 +56,21 @@ struct MainView: View {
             } else {
                 Text("Reporting is not available")
             }
+            if let installation = bridge.installation {
+                Button("Send reports via installation") {
+                    installation.sendAllReports { _, error in
+                        alertMessage = error?.localizedDescription
+                        alertIsPresented = error != nil
+                    }
+                }
+            }
+        }
+        .alert(isPresented: $alertIsPresented) {
+            Alert(
+                title: Text("Error"),
+                message: Text(alertMessage ?? ""),
+                dismissButton: .default(Text("OK"))
+            )
         }
     }
 }