UIP 解决方案列表

“uip solution list”的语法和选项，其中列出了 Studio Web 解决方案或在目录中扫描本地解决方案。

备注：

uip solution list 是预览版命令 — 在没有主要版本提升的情况下，该命令可能会发生变化。请参阅版本控制。

uip solution list 有两种模式。默认情况下，该方法会列出您拥有或与您共享的 Studio Web 解决方案 — 它返回的SolutionId是uip solution download和uip solution delete所用的解决方案。如果使用 --local，它会扫描目录树中的本地解决方案（.uipx 清单文件），并标记过时或模糊的解决方案。

大纲

uip solution list [-l <n>] [--offset <n>] [--name <pattern>] [--sort-by <column>] [--sort-order <Ascending|Descending>]
uip solution list --local [directory] [--check-cloud]

云模式（默认）

列出 Studio Web 解决方案。需要经过身份验证的会话，且已解析组织名称。

选项

短	长	值	默认	描述
-l	--limit	数字 (1–100)	50	要返回的解决方案数量上限。
—	--offset	数字	0	要跳过的解决方案数量。
—	--name	text	—	解决方案名称的服务器端关键字筛选器。
—	--sort-by	列	服务器默认值	要排序的列。
—	--sort-order	Ascending | Descending	—	排序方向
—	--login-validity	分钟	10	在令牌过期前触发刷新的最短分钟数。

如果与--local或--check-cloud一起传递上述“仅限云”选项，则系统会拒绝上述选项，并显示错误。

示例

uip solution list --limit 2

数据形状（--输出 json）

{
  "Code": "SolutionsList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "Name": "Examples",
      "LastModifiedTime": "2025-04-15T10:30:00Z",
      "PublishStatus": "draft",
      "Projects": []
    }
  ]
}

本地模式 (--local)

通过查找 .uipx 清单（而不是调用 Studio Web）来扫描目录树以获取本地解决方案。

选项

长	值	默认	描述
--local [directory]	路径	当前目录	扫描此目录树中的 .uipx 清单文件。“裸”--local 扫描当前目录。
--check-cloud	标记	关闭	同时针对SolutionId Studio Web 解析每个本地解决方案的OK / ，并报告NotFound 。隐含 --local，并且需要身份验证。

示例

uip solution list --local ./workspace

uip solution list --local ./workspace --check-cloud

数据形状（--输出 json）

{
  "Code": "LocalSolutionsList",
  "Data": [
    {
      "Path": "Examples",
      "Name": "Examples",
      "UipxFile": "Examples.uipx",
      "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
      "ProjectCount": 2,
      "Warnings": []
    }
  ]
}

使用 --check-cloud，每行都会添加一个 CloudStatus 字段（OK 或 NotFound）。如果扫描无法进入某个子树，则响应的 Instructions 字段名称会跳过哪些子树 — 在这种情况下，列表可能不完整。

退出代码

请参阅共享合同的退出代码。

相关命令

• uip solution download — 下载Id在此处发现的解决方案。

另请参阅

• 全局选项、退出代码和版本控制— 由每个动词共享的合同。