feat: add CloudSync package and build tool plugin

Author: Gioee

.gitignore

@@ -13,4 +13,5 @@ unittest
 .vscode
 **/node_modules/**
 .env
-package-lock.json
+package-lock.json
+.build

Makefile

@@ -31,7 +31,6 @@ MAKEFLAGS += -j$(CPUS)
 CC = gcc
 CFLAGS = -Wall -Wextra -Wno-unused-parameter -I$(SRC_DIR) -I$(SQLITE_DIR) -I$(CURL_DIR)/include
 T_CFLAGS = $(CFLAGS) -DSQLITE_CORE -DCLOUDSYNC_UNITTEST -DCLOUDSYNC_OMIT_NETWORK -DCLOUDSYNC_OMIT_PRINT_RESULT
-LDFLAGS = -L./$(CURL_DIR)/$(PLATFORM) -lcurl
 COVERAGE = false
 
 # Directories
@@ -136,6 +135,8 @@ ifdef NATIVE_NETWORK
 
 $(BUILD_RELEASE)/%_m.o: %.m
 	$(CC) $(CFLAGS) -fobjc-arc -O3 -fPIC -c $< -o $@
+else
+	LDFLAGS += -L./$(CURL_DIR)/$(PLATFORM) -lcurl
 endif
 
 # Windows .def file generation
@@ -154,7 +155,11 @@ extension: $(TARGET)
 all: $(TARGET) 
 
 # Loadable library
+ifdef NATIVE_NETWORK
+$(TARGET): $(RELEASE_OBJ) $(DEF_FILE)
+else
 $(TARGET): $(RELEASE_OBJ) $(DEF_FILE) $(CURL_LIB)
+endif
 	$(CC) $(RELEASE_OBJ) $(DEF_FILE) -o $@ $(LDFLAGS)
 ifeq ($(PLATFORM),windows)
 	# Generate import library for Windows

Package.swift

@@ -0,0 +1,33 @@
+// swift-tools-version: 6.1
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "CloudSync",
+    platforms: [.macOS(.v11), .iOS(.v11)],
+    products: [
+        // Products can be used to vend plugins, making them visible to other packages.
+        .plugin(
+            name: "CloudSyncPlugin",
+            targets: ["CloudSyncPlugin"]),
+        .library(
+            name: "CloudSync",
+            targets: ["CloudSync"])
+    ],
+    targets: [
+        // Build tool plugin that invokes the Makefile
+        .plugin(
+            name: "CloudSyncPlugin",
+            capability: .buildTool(),
+            path: "packages/swift/plugin"
+        ),
+        // CloudSync library target
+        .target(
+            name: "CloudSync",
+            dependencies: [],
+            path: "packages/swift/extension",
+            plugins: ["CloudSyncPlugin"]
+        ),
+    ]
+)

packages/swift/extension/CloudSync.swift

@@ -0,0 +1,19 @@
+// CloudSync.swift
+// This file serves as a placeholder for the CloudSync target.
+// The actual SQLite extension is built using the Makefile through the build plugin.
+
+import Foundation
+
+/// Placeholder structure for CloudSync
+public struct CloudSync {
+    /// Returns the path to the built CloudSync dylib inside the XCFramework
+    public static var path: String {
+        #if os(macOS)
+        return "CloudSync.xcframework/macos-arm64_x86_64/CloudSync.framework/CloudSync"
+        #elseif targetEnvironment(simulator)
+        return "CloudSync.xcframework/ios-arm64_x86_64-simulator/CloudSync.framework/CloudSync"
+        #else
+        return "CloudSync.xcframework/ios-arm64/CloudSync.framework/CloudSync"
+        #endif
+    }
+}

packages/swift/plugin/CloudSync.swift

@@ -0,0 +1,60 @@
+import PackagePlugin
+import Foundation
+
+@main
+struct CloudSync: BuildToolPlugin {
+    /// Entry point for creating build commands for targets in Swift packages.
+    func createBuildCommands(context: PluginContext, target: Target) async throws -> [Command] {
+        let packageDirectory = context.package.directoryURL
+        let outputDirectory = context.pluginWorkDirectoryURL
+        return createCloudSyncBuildCommands(packageDirectory: packageDirectory, outputDirectory: outputDirectory)
+    }
+}
+
+#if canImport(XcodeProjectPlugin)
+import XcodeProjectPlugin
+
+extension CloudSync: XcodeBuildToolPlugin {
+    // Entry point for creating build commands for targets in Xcode projects.
+    func createBuildCommands(context: XcodePluginContext, target: XcodeTarget) throws -> [Command] {
+        let outputDirectory = context.pluginWorkDirectoryURL
+        return createCloudSyncBuildCommands(packageDirectory: nil, outputDirectory: outputDirectory)
+    }
+}
+
+#endif
+
+/// Shared function to create CloudSync build commands
+func createCloudSyncBuildCommands(packageDirectory: URL?, outputDirectory: URL) -> [Command] {
+
+    // For Xcode projects, use current directory; for Swift packages, use provided packageDirectory
+    let workingDirectory = packageDirectory?.path ?? "$(pwd)"
+    let packageDirInfo = packageDirectory != nil ? "Package directory: \(packageDirectory!.path)" : "Working directory: $(pwd)"
+
+    return [
+        .prebuildCommand(
+            displayName: "Building CloudSync XCFramework",
+            executable: URL(fileURLWithPath: "/bin/bash"),
+            arguments: [
+                "-c",
+                """
+                set -e
+                echo "Starting CloudSync XCFramework prebuild..."
+                echo "\(packageDirInfo)"
+                
+                # Clean and create output directory
+                rm -rf "\(outputDirectory.path)"
+                mkdir -p "\(outputDirectory.path)"
+                
+                # Build directly from source directory with custom output paths
+                cd "\(workingDirectory)" && \
+                echo "Building XCFramework with native network..." && \
+                make xcframework NATIVE_NETWORK=ON DIST_DIR="\(outputDirectory.path)" BUILD_RELEASE="\(outputDirectory.path)/build/release" BUILD_TEST="\(outputDirectory.path)/build/test" && \
+                rm -rf "\(outputDirectory.path)/build" && \
+                echo "XCFramework build completed successfully!"
+                """
+            ],
+            outputFilesDirectory: outputDirectory
+        )
+    ]
+}