获取 winget 的软件清单
· 阅读需 4 分钟
winget 的所有软件清单都保存在 manifests 目录中。下一层的目录便是软件作者名称的首字母,比如 Google.Chrome 便是保存在 manifests/g 目录中 接下来使用 GitHub REST API 获取目录即可:
import fetch from "node-fetch"
import YAML from "yaml"
export namespace Winget {
export interface Package {
PackageIdentifier: string
PackageVersion: string
InstallerType: string
InstallModes: string[]
InstallerSwitches: InstallerSwitches
ExpectedReturnCodes: ExpectedReturnCode[]
UpgradeBehavior: string
Protocols: string[]
FileExtensions: string[]
AppsAndFeaturesEntries: AppsAndFeaturesEntry[]
Installers: Installer[]
ManifestType: string
ManifestVersion: string
}
export interface Installer {
Architecture: string
Scope: string
InstallerUrl: string
InstallerSha256: string
InstallerSwitches: InstallerSwitches2
ProductCode: string
}
export interface InstallerSwitches2 {
Custom: string
}
export interface AppsAndFeaturesEntry {
UpgradeCode: string
InstallerType: string
}
export interface ExpectedReturnCode {
InstallerReturnCode: number
ReturnResponse: string
}
export interface InstallerSwitches {
Log: string
}
}
export type WingetDownloadInfo = {
name: string
id: string
dir: string
architecture?: "x64" | "x86" | "all"
}
export interface GithubContent {
name: string
path: string
sha: string
size: number
url: string
html_url: string
git_url: string
download_url?: string | null
type: string
_links: Links
}
export interface Links {
self: string
git: string
html: string
}
export type WingetItem = {
filename: string
version: string
ext: string
architecture: string
}
export async function downloadFromWinget({ name, id, dir, architecture = "x64" }: WingetDownloadInfo) {
const firstLetter = id[0].toLowerCase()
const path = id.replace(/\./g, "/")
const response = await fetch(`https://api.github.com/repos/microsoft/winget-pkgs/contents/manifests/${firstLetter}/${path}`, { agent })
const data: GithubContent[] = (await response.json()) as any
const reg2 = /^\d+(\.\d+?)*$/
const stables = data.filter(item => reg2.test(item.name))
stables.sort((a, b) => {
const avs = a.name.split(".")
const bvs = b.name.split(".")
const max = Math.max(avs.length, bvs.length)
for (let i = 0; i < max; i++) {
const av = avs[i] ? parseInt(avs[i]) : 0
const bv = bvs[i] ? parseInt(bvs[i]) : 0
if (av < bv) return 1
if (av > bv) return -1
}
return 0
})
const response2 = await fetch(
`https://raw.githubusercontent.com/microsoft/winget-pkgs/master/manifests/${firstLetter}/${path}/${stables[0].name}/${id}.installer.yaml`,
{ agent },
)
const yaml = await response2.text()
const pkg: Winget.Package = YAML.parse(yaml)
const installers = pkg.Installers.filter((item, index) => {
if (item.Architecture !== "x64" && item.Architecture !== "x86") return false
if (architecture !== "all" && item.Architecture !== architecture) return false
if (!item.InstallerUrl.endsWith(".exe") && !item.InstallerUrl.endsWith(".msi")) return false
if (item.InstallerUrl.endsWith(".msi") && pkg.Installers.some(item2 => item2.Architecture === item.Architecture && item2.InstallerUrl.endsWith(".exe")))
return false
if (pkg.Installers.findIndex(item2 => item2.Architecture === item.Architecture) !== index) return false
return true
})
const result: WingetItem[] = []
for (const { InstallerUrl, Architecture } of installers) {
if (Architecture !== "x64" && Architecture !== "x86") continue
const filename = await download(InstallerUrl, dir)
result.push({
filename,
version: pkg.PackageVersion,
ext: InstallerUrl.endsWith(".exe") ? "exe" : "msi",
architecture: Architecture,
})
}
for (const { version, filename, architecture, ext } of result) {
await sleep(100)
await rename(join(dir, filename), join(dir, `${name}_${version}_${architecture}.${ext}`))
}
}
提示
- 使用 YAML 来将 YAML 文件格式化为 JSON
Installer的Scope字段有两个可能的值:user和machine- user:当
Scope被设置为user时,意味着安装操作仅针对当前用户进行。安装的程序或者应用将仅对当前用户可用,安装的结果(如程序文件和快捷方式)将被存储在用户的个人目录下(例如,在Windows系统中可能是C:\Users\[用户名]\下的某个目录),并且只有当前用户有权限运行或修改。这种安装方式不需要管理员权限,但安装的程序只能由安装它的用户使用。 - machine:当
Scope被设置为machine时,表明安装是针对整个系统进行的,安装的程序或应用将对所有用户可用。这通常意味着程序会被安装在系统级的目录下(例如,在Windows系统中可能是C:\Program Files\),并且安装、运行或修改程序可能需要管理员权限。这种安装方式确保了所有使用该机器的用户都可以访问到安装的程序。
- user:当
注意
- 由于国内的网络环境限制,可能需要为 fetch 配置代理
- 示例函数对于版本号使用了
^\d+(\.\d+?)*$正则表达式进行了过滤,也就是只接受数字.数字.数字...形式的版本 - 示例函数的返回结果并不一定严格符合
Winget.Package类型,只是以Google.Chrome为例