本地包配方索引仓库¶
“local_recipes_index”仓库是一种 **实验性** 的特殊类型仓库，您无法向其上传包或存储二进制文件。此远程仓库的目的是
使贡献者能够与社区共享包配方，特别是对于可能不适合 ConanCenter 的库。
简化从私有的 conan-center-index 分支构建二进制文件的过程，从而可以完全控制配方、自定义并维护稳定的仓库快照。这确保了在 ConanCenter 上进行上游更改时具有鲁棒性。有关详细的设置和使用说明，请参阅 Conan DevOps 指南中的专门章节 本地包配方索引仓库。
设置¶
要设置本地包配方索引仓库以共享您自己的配方，您需要以模仿 conan-center-index 的文件夹结构来组织您的配方。要开始，您可以使用 conan new 命令的 local_recipes_index 模板。为了演示，让我们为假设的 hello 库创建一个 local-recipes-index 仓库，该库的许可证与 Conan Center 不兼容，并为 conan new 命令使用 local_recipes_index 模板。
$ mkdir repo && cd repo
$ conan new local_recipes_index -d name=hello -d version=0.1 \
-d url=https://github.com/conan-io/libhello/archive/refs/tags/0.0.1.zip \
-d sha256=1dfb66cfd1e2fb7640c88cc4798fe25853a51b628ed9372ffc0ca285fe5be16b
$ cd ..
“conan new local_recipes_index” 命令会创建一个模板，该模板假定 CMake 作为构建系统，并进行其他一些重要的假设。在实践中，这需要进一步的自定义，但对于此演示，它可以按原样使用。它将创建一个与 conan-center-index GitHub 仓库相同的文件夹布局。
.
└── repo
└── recipes
└── hello
├── all
│ ├── conandata.yml
│ ├── conanfile.py
│ └── test_package
│ ├── CMakeLists.txt
│ ├── conanfile.py
│ └── src
│ └── example.cpp
└── config.yml
设置好仓库后，我们将其添加为 Conan 的本地远程仓库。
$ conan remote add mylocalrepo ./repo --allowed-packages="hello/*"
请特别注意 --allowed-packages 参数。此参数确保 Conan 丢弃 hello 以外的所有包。这可以用来最小化潜在供应链攻击的攻击面。
现在您可以从此新仓库列出和安装包了。
$ conan list "*" -r=mylocalrepo
$ conan install --requires=hello/0.1 -r=mylocalrepo --build=missing
此时，您可以将此仓库推送到您的 GitHub 帐户并与社区共享。用户只需克隆 GitHub 仓库，然后将克隆的文件夹本身添加为本地仓库即可。
注意
请注意，正如我们之前提到的，此功能专门针对某些库不适合 ConanCenter 的场景。请记住，“local-recipes-index”仓库存在局限性：它不完全可重现，因为它只模拟版本而不模拟修订，并且不提供二进制文件。因此，在这些情况之外，建议使用远程包服务器，例如 Artifactory。