增加说明文档
This commit is contained in:
parent
17d587b7ca
commit
a80e886c43
89
README.md
89
README.md
|
|
@ -1 +1,88 @@
|
||||||
# aspnet发布nuget插件
|
# Release-NuGet Action
|
||||||
|
|
||||||
|
一个用于自动发布 NuGet 包到指定源的 GitHub Action。
|
||||||
|
|
||||||
|
## 功能特性
|
||||||
|
|
||||||
|
- 支持发布多个项目到指定的 NuGet 源
|
||||||
|
- 可配置 .NET SDK 版本
|
||||||
|
- 支持自定义构建配置
|
||||||
|
- 提供预发布版本控制选项
|
||||||
|
- 包含详细的日志输出
|
||||||
|
- 自动跳过重复发布
|
||||||
|
- 错误处理和项目检查
|
||||||
|
|
||||||
|
## 输入参数
|
||||||
|
|
||||||
|
| 参数 | 必需 | 默认值 | 描述 |
|
||||||
|
|------|------|--------|------|
|
||||||
|
| `source` | 是 | - | NuGet 包发布地址 |
|
||||||
|
| `key` | 是 | - | NuGet 发布凭证密钥 |
|
||||||
|
| `projects` | 是 | - | 要发布的项目名称列表,使用逗号分隔 |
|
||||||
|
| `nuget_dir` | 否 | `nuget` | NuGet 包缓存目录,用于缓存依赖 |
|
||||||
|
| `dotnet_version` | 否 | `6.0` | .NET SDK 版本 |
|
||||||
|
|
||||||
|
## 使用示例
|
||||||
|
|
||||||
|
### 基本用法
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
name: 发布 NuGet 包
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
tags:
|
||||||
|
- 'v*.*.*'
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
publish:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: 发布到 NuGet.org
|
||||||
|
uses: actions/release-nuget@6.0
|
||||||
|
with:
|
||||||
|
source: https://api.nuget.org/v3/index.json
|
||||||
|
key: ${{ secrets.NUGET_API_KEY }}
|
||||||
|
projects: MyProject,MyLibrary
|
||||||
|
```
|
||||||
|
|
||||||
|
### 高级用法
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
name: 发布 NuGet 包
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
tags:
|
||||||
|
- 'v*.*.*'
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
publish:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v3
|
||||||
|
|
||||||
|
- name: 发布到私有 NuGet 源
|
||||||
|
uses: actions/release-nuget@6.0
|
||||||
|
with:
|
||||||
|
source: https://myget.org/F/my-feed/v3/index.json
|
||||||
|
key: ${{ secrets.MYGET_API_KEY }}
|
||||||
|
projects: MyProject
|
||||||
|
nuget_dir: .nuget
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. 请确保在 GitHub Secrets 中安全存储您的 NuGet API 密钥
|
||||||
|
2. 项目路径应该相对于工作区根目录
|
||||||
|
3. 对于预发布版本,请设置 `allow_prerelease: true`
|
||||||
|
4. 支持的 .NET SDK 版本取决于 Docker Hub 上可用的 `mcr.microsoft.com/dotnet/sdk` 镜像版本
|
||||||
|
|
||||||
|
## 故障排除
|
||||||
|
|
||||||
|
- 确保项目文件路径正确
|
||||||
|
- 检查 NuGet API 密钥是否有效
|
||||||
|
- 验证 NuGet 源地址是否可访问
|
||||||
|
- 查看日志输出以获取详细的错误信息
|
||||||
Loading…
Reference in New Issue