在 GitHub 上创建一个 Swift 管理包：其实一点也不简单

fkngn 9年前

来自： http://swift.gg/2016/02/22/creating-a-swift-package-on-github-not-as-easy-as-i-thought/

一谈到 git 的事情，我就没什么可说的了。对每一个人而言这应该再熟悉不过了。

Package.swift

我认为 建立一个 git 仓库 来使用包管理工具不需要学什么新东西。毕竟使用一个包仅仅是意味着贴一行代码到一个 app 包中，不是吗？

我创建了一个 Package.swift 文件，我想我只需要编译就能用。 

import PackageDescription  let package = Package (      name: "myutility",      dependencies: [   .Package(url: "https://github.com/erica/SwiftString.git",                   majorVersion: 1),      ]  )
</div>

然而我失败了。

Git 标签

当我硬着头皮去学习 git 标签后，才发现它并不会在创建后自动推送到 GitHub 上。事实上，直到我最终克隆了一个仓库并且运行了一下 git tag 命令，发现什么都没有输出时，我才发现了这个问题。 

% git tag  %
</div>

这就是为什么我一直尝试编译一个简单的测试 app，结局却总是 swift-build: The dependency graph could not be satisfied （早期的 Swift 编译是 satisfed）。

添加标签

你可以使用 git tag 添加标签，例如：

% git tag -a 1.0.0 -m "Version 1.0.0"
</div>

你可以使用不带参数的 git tag 查看所有标签：

% git tag  % 1.0.0
</div>

也可以显示标签名字（以及附加的信息）：

git tag -n  1.0.0 Version 1.0.0
</div>

这些标签不会被自动上传到 GitHub ，除非你推送它们：

% git push --tags  Counting objects: 1, done.  Writing objects: 100% (1/1), 176 bytes | 0 bytes/s, done.  Total 1 (delta 0), reused 0 (delta 0)  To https://github.com/erica/SwiftString.git   * [new tag] 1.0.0 -> 1.0.0
</div>

现在，那些依赖于 tag 版本的仓库终于能正常工作了！

Kevin B 补充到： git push --tags 将会推送你所有的标签。所以如果你只想推送一个，需要明确指定出来，例如， git push origin v1.0.0

阅读标签

进入你的包文件夹，就可以在终端中阅读标签。你可以看到，每一个文件结尾都包含标签数字。

% ls  % ./ ../ SwiftString-1.0.1/
</div>

如果你点进这个包的文件夹，你会看到完整的克隆仓库，包括全部的 .git 文件。你同样可以在这里查看标签和与其关联的信息：

% cd SwiftString-1.0.0/  % ls  ./  .git/  Makefile README.md  ../  .gitignore Package.swift Sources/  % git tag -n  1.0.0           Version 1.0.0  %
</div>

希望这篇文章对大家有帮助，解决这个问题浪费了我一天的时间。

本文由 SwiftGG 翻译组翻译，已经获得作者翻译授权，最新文章请访问http://swift.gg。

</div>

相关经验