oshi

OSHI 是一个免费的基于 JNA（本机）的 Java 操作系统和硬件信息库。它不需要安装任何额外的本机库，旨在提供跨平台实现来检索系统信息，例如操作系统版本、进程、内存和 CPU 使用情况、磁盘和分区、设备、传感器等。

• 支持的平台
• 下载和依赖管理
• 文档
• 用法
• 支持的功能
• 支持
• OSHI 企业版
• 安全联系信息
• 持续集成测试状态
• 我能提供什么帮助吗？
• 为 OSHI 做出贡献
• 致谢
• 执照

支持的平台

• 视窗
• macOS
• Linux（安卓）
• UNIX（AIX、FreeBSD、OpenBSD、Solaris）

文档

• API（java文档）
• 常问问题
• 变更日志
• 性能考虑因素
• 主要版本重大变更
• 样本输出
• 使用 OSHI 的应用程序和项目

下载和依赖管理

稳定发布版本

• JDK8: oshi-core-6.6.5
• JPMS：oshi-core-java11-6.6.5
• JDK6: oshi-core-3.14.0

当前开发（快照）下载

• JDK8: oshi-core-6.6.6-SNAPSHOT
• JPMS：oshi-core-java11-6.6.6-SNAPSHOT

用法

1. 将 OSHI 及其依赖项包含在您的类路径中。
   • 我们强烈建议您将oshi-core添加为项目依赖项管理器（例如 Maven 或 Gradle）的依赖项。
   • 对于 Android，您需要为 JNA 添加 AAR 工件并排除 OSHI 的传递 (JAR) 依赖项。
   • 如果遇到NoClassDefFoundError或NoSuchMethodError问题，请参阅常见问题解答。
2. 创建SystemInfo的新实例
3. 使用SystemInfo中的 getter 来访问硬件或操作系统组件，例如：

 SystemInfo si = new SystemInfo ();
HardwareAbstractionLayer hal = si . getHardware ();
CentralProcessor cpu = hal . getProcessor ();

有关示例，请参阅 SystemInfoTest.java。要查看您的机器的示例输出：

git clone https://github.com/oshi/oshi.git && cd oshi

./mvnw test-compile -pl oshi-core exec:java 
  -Dexec.mainClass= " oshi.SystemInfoTest " 
  -Dexec.classpathScope= " test "

某些设置可以在oshi.properties文件中配置，也可以使用GlobalConfig类进行操作。这应该在启动时完成，因为配置不是线程安全的，并且 OSHI 不保证在操作期间重新读取配置。

oshi-demo工件包含几个使用 OSHI 获取信息的概念验证示例，其中包括基本的 Swing GUI。

支持的功能

• 计算机系统和固件、基板
• 操作系统和版本/构建
• 物理（核心）和逻辑（超线程）CPU、处理器组、NUMA 节点
• 系统和每个处理器负载、使用滴答计数器、中断、正常运行时间
• 进程正常运行时间、CPU、内存使用情况、用户/组、命令行参数、线程详细信息
• 使用/可用的物理和虚拟内存
• 已安装的文件系统（类型、可用空间和总空间、选项、读取和写入）
• 磁盘驱动器（型号、序列号、大小、读取和写入）和分区
• 网络接口（IP、带宽输入/输出）、网络参数、TCP/UDP 统计信息
• 电池状态（容量百分比、剩余时间、电量使用统计数据）
• USB设备
• 连接的显示器（带有 EDID 信息）、显卡和音频卡
• 某些硬件上的传感器（温度、风扇速度、电压）

支持

• 对于错误报告、功能请求或有关 OSHI 长期计划的一般问题，请创建问题。
• 如需帮助将 OSHI 集成到您自己的项目中或维护者对 PR 进行代码审查，请在项目站点上的问题或拉取请求中标记@dbwiddis 。
• 对于有关使用 API 的“如何”问题，请查阅oshi-demo项目中的示例，创建问题，或使用oshi标签在 Stack Overflow 上搜索，如果之前没有得到解答，则提出新问题。
• 要向 OSHI 的主要维护者表示感谢，您可以赞助他或请他喝杯咖啡。

OSHI 企业版

作为 Tidelift 订阅的一部分提供

OSHI 和数千个其他软件包的维护者正在与 Tidelift 合作，为您用于构建应用程序的开源依赖项提供商业支持和维护。节省时间、降低风险并改善代码运行状况，同时向您使用的确切依赖项的维护者付费。了解更多。

安全联系信息

要报告安全漏洞，请使用 Tidelift 安全联系人。 Tidelift 将协调修复和披露。

持续集成测试状态

我能提供什么帮助吗？

OSHI 最初是一个独立于平台的库，不需要额外的软件，并且具有与开源和商业产品兼容的许可证。我们在主要操作系统上开发了强大的核心功能，但我们希望您能够通过以下方式提供帮助：

• 测试！我们的 CI 测试仅限于少数平台。在各种操作系统/版本和硬件上下载并测试该程序，并帮助找出我们有限的开发和测试可能遗漏的差距。具体的高优先级测试需求包括：
  • 具有超过 64 个逻辑处理器的 Windows 系统
  • 树莓派
  • 不太常见的 Linux 发行版
• 贡献代码。看到一些不正常或可以更好地工作的东西吗？帮助我们修复它！欢迎新的贡献者。
• 记录实施情况。我们的 Wiki 很稀疏， oshi-demo工件是承载概念验证想法的地方。想要帮助新用户追随您的脚步吗？
• 建议新功能。您是否需要 OSHI 做一些它目前不做的事情？让我们知道。

为 OSHI 做出贡献

• 如何贡献
• 如何释放

致谢

非常感谢以下公司为包括 OSHI 在内的开源项目提供免费支持：

• SonarCloud 适用于一系列代码质量工具
• 用于持续集成测试的 GitHub Actions、AppVeyor 和 Cirrus CI
• jProfile Java Profiler 用于消除 CPU 瓶颈

执照

该项目已获得 MIT 许可证的许可。