跳到主要內容

建置說明 (Windows)

請依照以下指南在 Windows 上建置 Electron 本身，以建立自訂 Electron 二進位檔。如需將您的應用程式程式碼與預先建置的 Electron 二進位檔捆綁和發布，請參閱應用程式發布指南。

先決條件​

  • Windows 10 / Server 2012 R2 或更高版本
  • Visual Studio 2019 (>=16.0.0) 用於建置，但建議使用 Visual Studio 2022 (>=17.0.0) - 免費下載 VS 2022 Community Edition
    • 請參閱Chromium 建置文件，以了解有關所需 Visual Studio 组件的更多詳細資訊。
    • 如果您的 Visual Studio 安裝在預設目錄以外的目錄中，則需要設定一些環境變數，以將工具鏈指向您的安裝路徑。
      • vs2022_install = DRIVE:\path\to\Microsoft Visual Studio\2022\Community，將 2022 和 Community 替換為您安裝的版本，並將 DRIVE: 替換為 Visual Studio 所在的磁碟機。通常，這會是 C:。
      • WINDOWSSDKDIR = DRIVE:\path\to\Windows Kits\10，將 DRIVE: 替換為 Windows Kits 所在的磁碟機。通常，這會是 C:。
  • Node.js
  • Git
  • 如果您計畫建立完整發行版本，則需要 Windows SDK 10.0.15063.468 的 Windows 偵錯工具，因為 symstore.exe 用於從 .pdb 檔案建立符號儲存區。
    • 可以並排安裝不同版本的 SDK。若要安裝 SDK，請開啟 Visual Studio Installer，選取 修改 → 個別元件，向下捲動並選取要安裝的適當 Windows SDK。另一個選項是查看 Windows SDK 和模擬器封存，並分別下載 SDK 的獨立版本。
    • 也必須安裝 SDK 偵錯工具。如果 Windows 10 SDK 是透過 Visual Studio 安裝程式安裝的，則可以透過以下步驟安裝：控制台 → 程式 → 程式和功能 → 選取「Windows Software Development Kit」→ 變更 → 變更 → 勾選「Windows 偵錯工具」→ 變更。或者，您可以下載獨立的 SDK 安裝程式，並使用它來安裝偵錯工具。

如果您目前沒有 Windows 安裝，developer.microsoft.com 提供有時限版本的 Windows，您可以使用它們來建置 Electron。

建置 Electron 完全是透過命令列腳本完成的，無法使用 Visual Studio 完成。您可以使用任何編輯器開發 Electron，但在未來將支援使用 Visual Studio 進行建置。

注意： 即使 Visual Studio 未用於建置，但它仍然是必要的，因為我們需要它提供的建置工具鏈。

從 Windows 安全中心排除原始碼樹狀結構​

Windows 安全中心不喜歡 Chromium 原始碼中的其中一個檔案（請參閱 https://crbug.com/441184），因此它會不斷刪除它，導致 gclient sync 問題。您可以依照這些指示，從 Windows 安全中心監控中排除原始碼樹狀結構。

建置​

請參閱建置說明：GN

32 位元建置​

若要建置 32 位元目標，您需要將 target_cpu = "x86" 作為 GN 引數傳遞。您可以透過為 GN 使用不同的輸出目錄 (例如 out/Release-x86) 和不同的引數，來並排建置 32 位元目標和 64 位元目標。

$ gn gen out/Release-x86 --args="import(\"//electron/build/args/release.gn\") target_cpu=\"x86\""

其他建置步驟完全相同。

Visual Studio 專案​

若要產生 Visual Studio 專案，您可以將 --ide=vs2017 參數傳遞給 gn gen

$ gn gen out/Testing --ide=vs2017

疑難排解​

找不到命令 xxxx​

如果您遇到類似 找不到命令 xxxx 的錯誤，您可以嘗試使用 VS2015 命令提示字元 主控台來執行建置腳本。

嚴重內部編譯器錯誤：C1001​

請確保您已安裝最新的 Visual Studio 更新。

LNK1181：無法開啟輸入檔 'kernel32.lib'​

請嘗試重新安裝 32 位元 Node.js。

錯誤：ENOENT，stat 'C:\Users\USERNAME\AppData\Roaming\npm'​

建立該目錄應可修正此問題

$ mkdir ~\AppData\Roaming\npm

node-gyp 未被識別為內部或外部命令​

如果您使用 Git Bash 進行建置，則可能會收到此錯誤，您應該改用 PowerShell 或 VS2015 命令提示字元。

無法在 '...' 建立目錄：檔名過長​

node.js 有一些極長的路徑名稱，而且預設情況下，Windows 上的 git 無法正確處理長路徑名稱（即使 Windows 支援它們）。這應該可以修正它

$ git config --system core.longpaths true

錯誤：使用未宣告的識別符 'DefaultDelegateCheckMode'​

這可能會在建置期間發生，當 Windows 驅動程式套件安裝了 Windows 偵錯工具時。解除安裝 Windows 驅動程式套件，並依照上述步驟安裝偵錯工具。

建置腳本停滯直到按下按鍵​

此錯誤是 Windows 命令提示字元的「功能」。當啟用 快速編輯 並在提示視窗內按一下時，就會發生這種情況，目的是為了方便選取和複製輸出文字。由於每次意外按一下都會暫停建置程序，您可能需要在命令提示字元屬性中停用此功能。