有关package()和add_version()的书写规范

[levihuayuzhang]

为#7021 (comment) 的 继续讨论：

所以还是建议 add_versions("branch-version", "commit") ，然后你项目中 add_require("xxx", "branch-
version") 。或者直接写 commit 似乎也可以 add_require("xxx", "commit")

不是很理解，根据https://xmake.io/zh/guide/project-configuration/add-packages.html#%E7%AE%80%E4%BB%8B ，add_require("xxx", "branch-version") 应该是add_require("xxx branch-version")吧？

add_versions("branch-version", "commit") 前一个应该不能指定branch，后面commit的位置才能指定branch吧？如果是这样，后面的commit该如何与branch组合呢？（需要指定checkout到某个branch的某个commit）

其他问题：

1. @default这个目录是如何产生的，为何指定mainbranch不是和前者同一个目录呢？
2. 觉得有个显示指定HEAD commit的方案会比较灵活，对于本地打包的话。

add_requires("main")
add_requires("commit")

请问是指:

add_requires("stdexec main") -- main branch
add_requires("stdexec xxxxxxxxxxxxxxxxxxxxx") -- default branch xxxxxxxxxxxxxxxxxxxxx commit

这样吗？

也就是说，本地自己打包的话，只要有add_urls("https://github.com/NVIDIA/stdexec.git")就行了，不一定要在package()中指定add_versions()吗？

但是还有一种情况，我可能没有表达清楚：

默认branch为main，checkout commit xxxxx1，是可以直接用add_requires("stdexec xxxxx1")
那么在branch feature-xxx，checout commit xxxxx-feature，请问该怎么写，似乎没有在文档中写（branch和commit的组合）？

[star-hengxing]

branch 没有固定版本，所以一般是用户端使用。如果当时 ci 测的 dev 分支能过，然后用户测的 dev 分支已经不是同一个 commit 了，那 ci 测试就没用了，所以 add_versions 一般是 commit hash/tag。

另外 add_requires("xxx 1.0.0") -> add_requires("xxx", {version = "1.0.0"}) 也是可以的。

[levihuayuzhang]

branch 没有固定版本，所以一般是用户端使用。如果当时 ci 测的 dev 分支能过，然后用户测的 dev 分支已经不是同一个 commit 了，那 ci 测试就没用了，所以 add_versions 一般是 commit hash/tag。

另外 add_requires("xxx 1.0.0") -> add_requires("xxx", {version = "1.0.0"}) 也是可以的。

感谢解惑～👍