hydrogen

文檔 |討論 |變更日誌

Hydrogen 是 Shopify 的無頭商務堆疊。它提供了一組用於建立動態和高效能商務應用程式的工具、實用程式和一流的範例。 Hydrogen 的設計目的是與 Shopify 的全端 Web 框架 Remix 相配合，但它還提供了一個可移植到其他支援框架的 React 程式庫。

氫遺產 v1

Hydrogen Legacy v1 已移至單獨的儲存庫，可在此處找到文件。

氫入門

要求：

• Node.js 版本 16.14.0 或更高版本
• npm （或您選擇的套件管理器，例如yarn或pnpm ）

1. 安裝最新版本的 Hydrogen：

   npm create @shopify/hydrogen@latest

2. 運行本地開發伺服器：

   npm install
   npm run dev

3. 開啟在 http://localhost:3000 運行的新 Hydrogen 應用程式。

請參閱完整的氫文檔。

此存儲庫中的包

Hydrogen 被組織為單一儲存庫，其中包括可以一起使用的多個套件。

包裹	最新版本	描述	自述文件
@shopify/hydrogen		使用 Remix 建立商務應用程式的成熟工具、實用程式和一流範例。	自述文件
@shopify/hydrogen-react		不受約束且高效能的 Shopify 特定商務元件、掛鉤和實用程式庫。	自述文件
@shopify/cli-hydrogen		Shopify CLI 的 Hydrogen 擴充。	自述文件
@shopify/create-hydrogen		從命令列產生一個新的 Hydrogen 專案。	自述文件
@shopify/hydrogen-codegen		自動產生 Storefront API 查詢的類型。	自述文件
@shopify/remix-oxygen		Remix 轉接器使 Hydrogen 能夠在 Oxygen 運作時上運作。	自述文件
@shopify/mini-oxygen		模擬氧氣生產環境的氫氣應用程式的本地運行時。	自述文件

版本控制

Hydrogen 和 Hydrogen-react 與特定版本的 Shopify Storefront API 相關，該 API 遵循 calver。

例如，如果您使用 Storefront API 版本2023-01 ，則 Hydrogen 和 Hydrogen-react 版本2022.1.x完全相容。

如果 Storefront API 版本更新包含重大更改，那麼 Hydrogen 和 Hydrogen-react 也可能包含重大更改。由於 API 版本每三個月更新一次，因此每三個月可能會發生重大變更。

詳細了解 Shopify 上的 API 發布計劃。

為氫做出貢獻

閱讀我們的貢獻指南

其他方便的連結

了解有關氫的更多資訊。