23

我是 swift 和 xcode 世界的新手,所以我在尝试将包集成到我的项目时遇到问题。

我想使用以下命令添加 Alamofire 依赖项:

在我的根项目文件夹中:

swift init

这将创建 Package.swift 文件,我在其中添加依赖项,然后运行:

swift build

一切似乎都很好,但是当我尝试导入我的库时,我的项目是:

import Alamofire

我收到一个错误,它说模块无法识别。所以我的问题是,在不使所有内容崩溃的情况下,集成包管理器和对现有项目的依赖项的正确步骤是什么。

更新:

swift build

输出:

Resolved version: 4.3.0
Compile Swift Module 'Alamofire' (17 sources)
Compile Swift Module 'Sample' (1 sources)

我的 Package.swift 是:

import PackageDescription

let package = Package(
    name: "Sample",
    dependencies: [
        .Package(url: "https://github.com/Alamofire/Alamofire.git", majorVersion: 4)
    ]
)
4

3 回答 3

13

Swift Package Manager是一个独立的工具,它允许在没有 Xcode 的情况下管理依赖项和构建项目。它可以为你生成 Xcode 项目swift package generate-xcodeproj

但是,目前,Swift Package Manager 仅支持为 macOS 和 Linux 平台构建项目。为 iOS、tvOS 和 watchOS 构建项目的唯一方法是使用 Xcode,其中包括这些平台所需的 SDK。

有很多方法可以使用 Swift Packages Manager 来管理 iOS/tvOS/watchOS 的依赖项,但这并不容易,需要手动操作。如果您有兴趣,请查看https://github.com/j-channings/swift-package-manager-ios

除此之外,我建议使用CarthageCocoaPods

Xcode 11 更新

Swift Package Manager 现在已集成到 Xcode 11 中。您可以通过转到“File”然后“Swift Packages”然后“Add Package Dependency...”来添加您的包,将存储库的 URL 粘贴到上面的字段中,然后单击“next”。Xcode 将引导您完成其余步骤。您可以在此 WWDC 演讲中了解更多信息。

于 2018-08-10T17:24:14.283 回答
12

如果您使用的是 Xcode 项目,则不需要(也不应该使用) a Package.swift,只需在 Xcode 中单击 Swift Packages 中的加号图标,并添加 Swift Package 的 GitHub URL,该库也将是自动添加到您的目标(按照下面的 GIF,或单击在此处添加图像中的图标):

额外信息

  • 不一致问题:您不能同时为相同的目标维护 Xcode 项目和 Swift.package。它们不同步,并且会变得不一致,因此根据工具的不同,您会得到不同的构建:令人困惑。您曾经能够基于Package.swiftusing创建 xcodeproj swift package generate-xcodeproj,但这已被弃用。您对此 Xcodeproj 所做的更改并未反映在原始文件中Package.swift)。
  • xcodebuildvs .:方便的话,如果和你的同目录swift build下没有,会自动生成scheme供你使用,所以你不必使用. 例如,运行以查看从您的文件生成的方案列表,然后使用这些方案之一。不方便的是,没有一种方式/配置可以使用.xcodeprojPackage.swiftxcodebuildswift buildxcodebuild -listPackage.swiftxcodebuildPackage.swift
于 2021-05-29T12:52:04.740 回答
0

Swift 包管理器(SPM)

[iOS 依赖管理器]

使用: [ SPM管理依赖项]

生产:如果您正在开发库/模块(模块化),您应该注意支持它

Package.swift- 清单文件。

  • 这是一个硬编码的名称。
  • 应放在同一级别或更高级别,在其他情况下:
target '<target_name>' in package '<package_name>' is outside the package root

Package.swift 示例

// swift-tools-version:5.3
// The swift-tools-version declares the minimum version of Swift required to build this package.

import PackageDescription
 
let package = Package(

    name: "PackageName1",

    //Supported platforms
    platforms: [
        .iOS(.v11)
    ],
    
    //Product list - executable binary
    products: [
        .library(
            name: "LibraryName1",
            targets: ["TargetName1"]),
    ],

    //Additional SPM dependencies declaration(packages) which are used in targets
    dependencies: [

        //Local package path
        .package(name: "PackageName2", path: "../Feature1")

        //Local package URL
        .package(name: "PackageName2", url: "file:///some_local_path", .branch("master"))

        //Remote package URL
        .package(name: "PackageName2", url: "https://github.com/user/repo", .branch("master")),
    ],

    targets: [
        //Source code location. implicitly `Sources/<target_name>`(Sources/TargetName1) or explicitly `path:`
        .target(
            name: "TargetName1",
            dependencies: [
                //using dependencies from package.targets and package.dependencies

                //package.targets
                "LibraryName2"

                //package.dependencies
                .product(name: "PM2LibraryName1", package: "PackageName2")
            ]),
            path: "Sources/TargetName1"
    ]
)

对 Swift 依赖的观察

import Module1
import Module2
  • Swift 库转换为单个.o format[About]文件和.swiftmodule[About]
  • Swift 库公开.modulemap umbrella.h[About]用于公开 Objective-C 消费者思想的模块@import SomeModule;
- You are able to work with `Package.swift` in Xcode if double click on it
.swiftpm/xcode with .xcworkspace will be generated 
- When you work with `Package.swift` you are able to check it, just save this file
- When you work with `Package.swift` you should specify schema and device(platform)
- When you build `Package.swift` 
  - library and .swiftmodule is located:
<path_to_derived_data>/DerivedData/<folder_name_where_Package.swift_located>-<randomizer>/Build/Products/<platform>
//e.g.
/Users/alex/Library/Developer/Xcode/DerivedData/someFolder-ccivqbbjujxuvdcxtuydyqfeepfx/Build/Products/Debug-iphonesimulator
  - .modulemap and umbrella.header is located:
<path_to_derived_data>/DerivedData/<folder_name_where_Package.swift_located>-<randomizer>/Build/Intermediates.noindex/<project_name>.build/<platform>/<target_name>.build/<.modulemap> and plus /Objects-normal/<arch>/<tarhet_name-Swift.h>

- When you build consumer with `Package.swift` results files will be located:
<path_to_derived_data>/DerivedData/<target_name>-<randomizer>/Build/Products/<platform>

- When you work with consumer of `Package.swift` SPM clones it into
<path_to_derived_data>/DerivedData/<target_name>-<randomizer>/SourcePackages/checkouts

package.products.library.targets

您可以指定多个目标。这意味着可以使用来自单个可执行二进制文件的多个模块(一种伞库)

producer:
package.products.library.targets: ["TargetName1", "TargetName2"]

consumer: 
1. adds single library
2. several imports

import TargetName1
import TargetName2

package.targets.target.dependencies

如果您的目标具有依赖性。您将获得相同的效果 - 伞库。

1.从同一个包中添加另一个目标

例如,使用Explicit Dependency[关于]。重要提示:使用相同的名称(模块和 SPM 目标)。如果你没有设置依赖,package.targets.target.dependencies你会得到下一个错误

Undefined symbol

2.从另一个包中添加产品。其他包中的所有目标都将被暴露

2.1 本地包路径

您不能在消费者方面使用。但它至少可以让你首次亮相

package <package_name_1> is required using a revision-based requirement and it depends on local package <package_name_2>, which is not supported

2.2 本地包地址

不要 在路径中使用空格(),否则你会得到

The URL file:///hello world/some_local_path is invalid

如果你不指定// swift-tools-version:<version>,你会得到:

package at '<some_path>' is using Swift tools version 3.1.0 which is no longer supported; consider using '// swift-tools-version:5.3' to specify the current tools version

*不要忘记在测试之前提交您的更改并更新[关于]

于 2021-04-01T19:06:44.100 回答