mirror of
https://gitea.com/gitea/docs.git
synced 2026-06-11 04:31:26 +00:00
69e92d33ec
Conan v1 reached end-of-life. https://blog.conan.io/2024/09/30/Conan-Center-will-stop-receiving-updates-for-Conan-1.html The command for conan v2 login has changed to `conan remote login`. https://docs.conan.io/2/reference/commands/remote.html#conan-remote-login I briefly looked at Gitea codebase. Gitea supports conan v2 cli (given functions like `DeleteRecipeV2` and `SearchPackagesV2`) --------- Co-authored-by: Chongyi Zheng <git@zcy.dev> Reviewed-on: https://gitea.com/gitea/docs/pulls/426 Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com> Co-authored-by: harryzcy <37645+harryzcy@noreply.gitea.com> Co-committed-by: harryzcy <37645+harryzcy@noreply.gitea.com>
92 lines
2.2 KiB
Markdown
92 lines
2.2 KiB
Markdown
---
|
|
date: "2021-07-20T00:00:00+00:00"
|
|
slug: "conan"
|
|
sidebar_position: 20
|
|
---
|
|
|
|
# Conan Package Registry
|
|
|
|
Publish [Conan](https://conan.io/) packages for your user or organization.
|
|
|
|
## Requirements
|
|
|
|
To work with the Conan package registry, you need to use the [conan](https://conan.io/downloads.html) command line tool to consume and publish packages.
|
|
|
|
## Configuring the package registry
|
|
|
|
To register the package registry you need to configure a new Conan remote:
|
|
|
|
```shell
|
|
conan remote add {remote} https://gitea.example.com/api/packages/{owner}/conan
|
|
conan remote login {remote} {username} --password {password}
|
|
```
|
|
|
|
| Parameter | Description |
|
|
| -----------| ----------- |
|
|
| `remote` | The remote name. |
|
|
| `username` | Your Gitea username. |
|
|
| `password` | Your Gitea password. If you are using 2FA or OAuth use a [personal access token](development/api-usage.md#authentication) instead of the password. |
|
|
| `owner` | The owner of the package. |
|
|
|
|
For example:
|
|
|
|
```shell
|
|
conan remote add gitea https://gitea.example.com/api/packages/testuser/conan
|
|
conan remote login gitea testuser --password password123
|
|
```
|
|
|
|
## Publish a package
|
|
|
|
Publish a Conan package by running the following command:
|
|
|
|
```shell
|
|
conan upload --remote={remote} {recipe}
|
|
```
|
|
|
|
| Parameter | Description |
|
|
| ----------| ----------- |
|
|
| `remote` | The remote name. |
|
|
| `recipe` | The recipe to upload. |
|
|
|
|
For example:
|
|
|
|
```shell
|
|
conan upload --remote=gitea ConanPackage/1.2@gitea/final
|
|
```
|
|
|
|
You cannot publish a file with the same name twice to a package. You must delete the existing package or file first.
|
|
|
|
The Gitea Conan package registry has full [revision](https://docs.conan.io/en/latest/versioning/revisions.html) support.
|
|
|
|
## Install a package
|
|
|
|
To install a Conan package from the package registry, execute the following command:
|
|
|
|
```shell
|
|
conan install --remote={remote} {recipe}
|
|
```
|
|
|
|
| Parameter | Description |
|
|
| ----------| ----------- |
|
|
| `remote` | The remote name. |
|
|
| `recipe` | The recipe to download. |
|
|
|
|
For example:
|
|
|
|
```shell
|
|
conan install --remote=gitea ConanPackage/1.2@gitea/final
|
|
```
|
|
|
|
## Supported commands
|
|
|
|
```
|
|
conan install
|
|
conan get
|
|
conan info
|
|
conan search
|
|
conan upload
|
|
conan user
|
|
conan download
|
|
conan remove
|
|
```
|