跳到主要内容

Platform API

平台检测辅助能力位于 ptool.platform 和 p.platform 下。

ptool.platform.os​

v0.1.0 - 引入。

ptool.platform.os() 返回当前机器的操作系统。

  • 返回：linux | macos | windows。
print(ptool.platform.os()) -- macos

行为说明：

  • 这里报告的是运行 ptool run 的本机环境。
  • ptool 当前会暴露 linux、macos 和 windows。

ptool.platform.arch​

v0.1.0 - 引入。

ptool.platform.arch() 返回当前机器的 CPU 架构。

  • 返回：amd64 | arm64 | x86 | arm | riscv64。
print(ptool.platform.arch()) -- arm64

行为说明：

  • x86_64 会暴露为 amd64。
  • aarch64 会暴露为 arm64。
  • x86、i686 等 32 位 x86 变体会统一暴露为 x86。
  • armv7l 等 32 位 ARM 变体会统一暴露为 arm。
  • riscv64 会暴露为 riscv64。

ptool.platform.target​

v0.1.0 - 引入。

ptool.platform.target() 返回当前机器的规范化平台目标字符串。

  • 返回：string。
local target = ptool.platform.target()
print(target) -- linux-riscv64

行为说明：

  • 结果始终等于 ptool.platform.os() .. "-" .. ptool.platform.arch()。
  • 这个值适合做基于平台的分支判断，例如选择下载产物。
  • 常见值包括 linux-amd64、linux-arm64、linux-x86、linux-arm、 linux-riscv64、macos-amd64、macos-arm64 和 windows-amd64。