Update Graph and DebugServer API (#1)

* Update Graph and DebugServer API

* Update DemoApp

* Add DebugClientApp

* DebugServer + graph/description complete

* Update DebugServerMode

* Update Package.swift

* Add output info area

* Update README

Author: Kyle-Ye

Package.resolved

@@ -17,15 +17,10 @@ let package = Package(
         .library(name: "AGDebugKit", targets: ["AGDebugKit"]),
     ],
     dependencies: [
-        .package(url: "https://github.com/OpenSwiftUIProject/OpenGraph.git", from:  "0.0.1"),
+        .package(url: "https://github.com/OpenSwiftUIProject/OpenGraph.git", from: "0.0.3"),
+        .package(url: "https://github.com/OpenSwiftUIProject/Socket.git", from: "0.3.3"),
     ],
     targets: [
-        .executableTarget(
-            name: "DemoApp",
-            dependencies: [
-                "AGDebugKit"
-            ]
-        ),
         .target(
             name: "AGDebugKit",
             dependencies: [
@@ -35,6 +30,21 @@ let package = Package(
                 .enableExperimentalFeature("AccessLevelOnImport"),
             ]
         ),
+        // A demo app showing how to use AGDebugKit
+        .executableTarget(
+            name: "DemoApp",
+            dependencies: [
+                "AGDebugKit",
+            ]
+        ),
+        // A client sending command to AGDebugServer
+        .executableTarget(
+            name: "DebugClient",
+            dependencies: [
+                "AGDebugKit",
+                .product(name: "Socket", package: "Socket"),
+            ]
+        ),
         .testTarget(
             name: "AGDebugKitTests",
             dependencies: ["AGDebugKit"]

Package.swift

@@ -2,20 +2,16 @@
 
 A package to get debug information from the private AttributeGraph framework behind SwiftUI.
 
-For visualization the JSON result, see [GraphConverter](https://github.com/OpenSwiftUIProject/GraphConverter)
+If you need JSON result visualization, you can refer to [GraphConverter](https://github.com/OpenSwiftUIProject/GraphConverter)
 
-For SwiftUI debug information, see [SwiftUIViewDebug](https://github.com/OpenSwiftUIProject/SwiftUIViewDebug)
+If you need SwiftUI debug information, you can refer to [SwiftUIViewDebug](https://github.com/OpenSwiftUIProject/SwiftUIViewDebug)
 
 ## Example
 
-![Demo App](Resources/demo_app.png)
+![Demo App Console](Resources/demo_app.png)
 
-![Demo JSON](Resources/demo_json.png)
+![Demo App Screenshot](Resources/demo_app_2.png)
 
-## TODO
+![Demo JSON](Resources/demo_json.png)
 
-- [ ] AGDescriptionFormat
-- [ ] AGGraphGetAttributeGraph
-- [ ] AGGraphDescription
-- [ ] AGGraphCreate
-- [ ] AGDebugServer
+![Debug Client Screenshot](Resources/debug_client.png)

README.md

@@ -0,0 +1,45 @@
+//
+//  DebugServer.swift
+//  
+//
+//  Created by Kyle on 2024/1/21.
+//
+
+private import AttributeGraph
+import Foundation
+
+public final class DebugServer {
+    private var server: UnsafeRawPointer?
+    
+    public static let shared = DebugServer()
+    
+    public func start(_ mode: Mode = .local) {
+        server = debugServerStart(mode.rawValue)
+    }
+    
+    public func stop() {
+        debugServerStop()
+        server = nil
+    }
+    
+    public func run(timeout: Int) {
+        guard let _ = server else { return }
+        debugServerRun(timeout)
+    }
+    
+    public var url: URL? {
+        guard let _ = server,
+              let url = debugServerCopyURL() as? URL
+        else { return nil }
+        return url
+    }
+    
+    /// A Bool value indicating whether the server has been started successfully
+    ///
+    /// To make AttributeGraph start debugServer successfully, we need to pass its internal diagnostics check.
+    /// In debug mode, add a symbolic breakpoint on `_ZN2AG11DebugServer5startEj`, run `start(_:)` and
+    /// executable `reg write w0 1` after `os_variant_has_internal_diagnostics` call.
+    public var startSuccess: Bool {
+        server != nil
+    }
+}

Resources/debug_client.png

@@ -0,0 +1,18 @@
+//
+//  DebugServerCommand.swift
+//
+//
+//  Created by Kyle on 2024/1/22.
+//
+
+extension DebugServer {
+    public enum Command: String, CaseIterable, Hashable, Identifiable {
+        case graphDescription = "graph/description"
+        case profilerStart = "profiler/start"
+        case profilerStop = "profiler/stop"
+        case profilerReset = "profiler/reset"
+        case profilerMark = "profiler/mark"
+        
+        public var id: String { rawValue }
+    }
+}

Resources/demo_app_2.png

@@ -0,0 +1,23 @@
+//
+//  DebugServerMessageHeader.swift
+//
+//
+//  Created by Kyle on 2024/1/22.
+//
+
+extension DebugServer {
+    public struct MessageHeader: Codable {
+        public var token: UInt32
+        public var reserved: UInt32
+        public var length: UInt32
+        public var reserved2: UInt32
+        public init(token: UInt32, length: UInt32) {
+            self.token = token
+            self.reserved = 0
+            self.length = length
+            self.reserved2 = 0
+        }
+        
+        public static var size: Int { MemoryLayout<Self>.size }
+    }
+}

Sources/AGDebugKit/AGDebugKit.swift

@@ -0,0 +1,24 @@
+//
+//  DebugServerMode.swift
+//
+//
+//  Created by Kyle on 2024/1/22.
+//
+
+extension DebugServer {
+    /// The run mode of DebugServer
+    ///
+    public struct Mode: RawRepresentable, Hashable {
+        public let rawValue: UInt
+        
+        public init(rawValue: UInt) {
+            self.rawValue = rawValue
+        }
+
+        /// Localhost mode: example host is `127.0.0.1`
+        public static let local = Mode(rawValue: 1)
+        
+        /// Network mode: example host is `192.168.8.230`
+        public static let network = Mode(rawValue: 3)
+    }
+}