无Git仓库时如何使用本地Swift Package Manager包及解决依赖报错？

Great questions—this is a common gotcha when working with local packages in SwiftPM. Let's break this down clearly:

How to Use a Local SPM Package (No Git Required) #

You don’t need a Git repository to reference a local Swift package. The key mistake here is using the url parameter when you should be using the path parameter in your Package.swift declaration. SwiftPM treats url as a remote Git repo (hence the "cannot clone" error you’re seeing), while path is specifically designed for local directories.

Step-by-Step Setup #

1. Ensure your local library has a valid Package.swift:
   Your local library needs its own package manifest for SPM to recognize it. A simple example might look like this:

   // LocalLibrary/Package.swift
   // swift-tools-version: 5.9
   import PackageDescription
   
   let package = Package(
       name: "LocalLibrary",
       products: [
           .library(name: "LocalLibrary", targets: ["LocalLibrary"]),
       ],
       targets: [
           .target(name: "LocalLibrary", dependencies: []),
       ]
   )
   

2. Reference the local package in your executable’s Package.swift:
   Use the .package(path:) syntax to point to your local library’s directory. Paths can be relative (to your executable package’s root) or absolute—relative paths are preferred for portability.

   // MyExecutable/Package.swift
   // swift-tools-version: 5.9
   import PackageDescription
   
   let package = Package(
       name: "MyExecutable",
       dependencies: [
           // Adjust the path to match your directory structure
           .package(path: "../LocalLibrary"),
       ],
       targets: [
           .executableTarget(
               name: "MyExecutable",
               dependencies: [
                   // Link the library product to your executable
                   .product(name: "LocalLibrary", package: "LocalLibrary"),
               ]),
       ]
   )
   

3. Build and run your executable:
   From your executable package’s root directory, run:

   swift build
   swift run MyExecutable
   

   SwiftPM will automatically detect changes in the local library and rebuild as needed—no swift package update required (since there’s no remote repo to pull from).

Why You Got the "Cannot Clone Repository" Error #

When you use .package(url: "../LocalLibrary", from: "1.0.0"), SwiftPM assumes you’re pointing to a Git repository (even if it’s a local path). It tries to clone it like a remote repo, which fails because the local directory either isn’t a Git repo or SPM still treats it as a remote resource. Using path instead tells SwiftPM to treat it as a local directory, skipping all Git-related operations.

Additional Notes #

• Relative Paths: Double-check the relative path points from your executable’s root to the library’s root. For example, if your executable lives in ~/Projects/MyExecutable and the library is in ~/Projects/LocalLibrary, use "../LocalLibrary".
• Absolute Paths: You can use absolute paths like "/Users/YourName/Projects/LocalLibrary", but this makes your package less portable to other machines.
• Local Changes: Any updates you make to the local library will be picked up on your next swift build or swift run—no manual dependency updates needed.

内容的提问来源于stack exchange，提问作者Brandt