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 許可證的許可。