Swift Package 信息

CLI 工具，提供给定 Swift Package 产品的信息，例如 其二进制大小影响的度量。它基于 Swift Argument Parser 构建。

用法

OVERVIEW: A tool for analyzing Swift Packages

Provides valuable information about a given Swift Package,
that can be used in your favor when deciding whether to
adopt or not a Swift Package as a dependency on your app.

USAGE: swift-package-info <subcommand>

OPTIONS:
  --version               Show the version.
  -h, --help              Show help information.

SUBCOMMANDS:
  binary-size             Estimated binary size of a Swift Package product.
  platforms               Shows platforms supported b a Package product.
  dependencies            List dependencies of a Package product.
  full-analyzes (default) All available information about a Swift Package product.

  See 'swift-package-info help <subcommand>' for detailed help.

示例

运行完整分析

swift-package-info --for https://github.com/ReactiveX/RxSwift -v 6.0.0 --product RxSwift

检查支持的平台（子命令）

swift-package-info platforms --for https://github.com/krzyzanowskim/CryptoSwift -v 1.3.8 --product CryptoSwift

查看本地 Package 的二进制大小（例如，开发中的框架）

swift-package-info binary-size --path ../project/my-framework

报告

swift-package-info --for https://github.com/ReactiveX/RxSwift -v 6.0.0 --product RxSwift

+------------------------------------------------+
|               Swift Package Info               |
|                                                |
|                 RxSwift, 6.0.0                 |
+--------------+---------------------------------+
| Provider     | Results                         |
+--------------+---------------------------------+
| Binary Size  | Binary size increases by 963 KB |
| Platforms    | System default                  |
| Dependencies | No third-party dependencies :)  |
+--------------+---------------------------------+
> Total of 3 providers used.

可以通过 report 参数传递自定义报告策略（查看 --help 获取支持的值）

swift-package-info --for https://github.com/ReactiveX/RxSwift -v 6.0.0 --product RxSwift --report jsonDump

{
  "binarySize" : {
    "amount" : 962560,
    "formatted" : "963 KB"
  },
  "dependencies" : [

  ],
  "platforms" : {

  }
}

安装

安装 mint。
可选地 运行 export MINT_LINK_PATH="/usr/local/bin" 以创建符号链接
运行：mint install marinofelipe/swift-package-info

运行它

mint run swift-package-info
或者，如果已创建符号链接，则直接使用 swift-package-info

构建

从 Swift Package Manager 构建

在顶层目录中执行 swift build
构建的实用工具可以在 .build/debug/swift-package-info 中找到
使用 swift run 运行

运行测试

从 Xcode 运行

将项目目录添加到 swift-package-info scheme 的 customWorkingDirectory
运行测试

从命令行运行

swift test --build-path PROJECT_DIR

依赖项

二进制大小报告

其方法论受到 cocoapods-size 的启发，因此通过比较没有 bitcode 和 ARM64 架构的归档文件来工作。这种策略已被证明与通过 TestFlight 下载和安装的 iOS 应用所增加的大小一致。

感谢

特别感谢 @unnamedd 分享他在 swift-tools-support-core 方面的经验，以及如何构建一个漂亮的 👌 报告。

贡献

Swift Package Info 是完全开放的，非常欢迎您的贡献。