loong64-electron 31.7.7

package/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) Electron contributors
+Copyright (c) 2013-2020 GitHub Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+### 📝 **`npm pkg set overrides.electron="loong64-electron@31.7.7"` 使用说明**
+
+---
+
+#### ✅ **命令目的**
+此命令用于在当前项目的 `package.json` 文件中，**设置一个依赖覆盖规则**，将所有对 `electron` 包的依赖，替换为安装 `loong64-electron@31.7.7`。
+
+> 它是实现“用龙芯版 Electron 替代官方 Electron”这一目标的核心配置步骤。
+
+---
+
+#### 🔧 **为什么要运行这个命令？**
+
+1.  **解决依赖冲突**  
+    某些项目或工具链（如 `electron-builder`）会直接依赖 `electron`。如果系统中没有 `electron`，它们会自动从官方 CDN 下载。  
+    这会导致：
+    *   下载失败（因为官方无龙芯架构支持）。
+    *   安装后无法运行（架构不匹配）。
+
+2.  **实现无缝替代**  
+    通过 `overrides`，你可以让开发者在代码中写 `require('electron')`，但实际加载的是你提供的 `loong64-electron` 版本。  
+    这样，**无需修改任何源码**，就能让应用在龙芯机器上正常运行。
+
+3.  **避免手动编辑 `package.json`**  
+    此命令是 `npm` 官方推荐的、安全的自动化方式，可以完全避免手动打开文本编辑器修改文件。
+
+---
+
+#### 📌 **运行前的准备**
+
+确保以下条件已满足：
+- 你的项目根目录已有 `package.json`。
+- `loong64-electron@31.7.7` 已发布到 npm（或私有仓库）。
+- 你已在本地使用 `npm config set overrides '...'` 或其他方式设置了全局配置（可选，但建议）。
+
+---
+
+#### 🚀 **运行命令**
+
+```bash
+npm pkg set overrides.electron="loong64-electron@31.7.7"
+```
+
+> ✅ 命令执行成功后，不会有任何输出，但 `package.json` 会被自动更新。
+
+---
+
+#### 📂 **运行后的结果**
+
+1.  **`package.json` 被修改**  
+    添加或更新了 `overrides` 部分：
+    ```json
+    {
+      "name": "my-project",
+      "version": "1.0.0",
+      "dependencies": {
+        "some-package": "^1.0.0"
+      },
+      "overrides": {
+        "electron": "loong64-electron@31.7.7"
+      }
+    }
+    ```
+
+2.  **`node_modules/electron` 的内容被替换**  
+    当你下次运行 `npm install` 时：
+    *   npm 会读取 `overrides` 规则。
+    *   它会去下载 `loong64-electron@31.7.7`。
+    *   最终，`node_modules/electron` 目录中存放的，是 `loong64-electron@31.7.7` 的完整二进制和源码。
+
+3.  **开发者体验不变**  
+    代码中仍可使用：
+    ```js
+    const { app } = require('electron'); // 依然有效！
+    ```
+    只是底层加载的是龙芯版本。
+
+---
+
+#### ✅ **验证方法**
+
+```bash
+# 1. 查看 node_modules/electron/package.json
+cat node_modules/electron/package.json
+
+# 2. 输出应包含：
+{
+  "name": "loong64-electron",
+  "version": "31.7.7"
+}
+```
+
+> ✅ 证明替换成功！
+
+---
+
+#### ⚠️ **注意事项**
+
+- 如果 `overrides` 已存在，请使用 `npm pkg set overrides.electron="..."` 来局部更新，而不是覆盖整个对象。
+- 确保 `loong64-electron@31.7.7` 的功能与官方 `electron@31.7.7` 兼容，否则可能导致应用崩溃。
+- 此操作仅影响本次 `npm install`，若需永久生效，请提交 `package.json` 到 Git。
+
+---
+
+### ✅ **总结**
+
+| 项目 | 内容 |
+| :--- | :--- |
+| **命令** | `npm pkg set overrides.electron="loong64-electron@31.7.7"` |
+| **目的** | 让 `electron` 依赖指向 `loong64-electron` |
+| **结果** | `node_modules/electron` 存放龙芯版 Electron |
+| **优点** | 无需改代码，无需手动编辑文件，部署简单 |
+
+> 🎯 **一句话总结**：  
+> 这条命令是实现“龙芯兼容性”的关键一步——它让所有依赖 `electron` 的工具，都自动使用你提供的专用版本，而无需任何感知。

package/checksums.json

@@ -0,0 +1,12 @@
+{
+  "electron-v31.7.7-linux-loong64.zip": "e0c756ca8a66dde3bece6ad902f152f539365ce7442d6353871d7c54d1c0f47b",
+  "chromedriver-v31.7.7-linux-loong64.zip": "9f5f5d334c12fd51578dbb08de19a796e33074dfd34b27ef503d2cfc8f9801c1",
+  "ffmpeg-v31.7.7-linux-loong64.zip": "28cde274e3eb41eaebba13f1b7bce6207eb0ff704aea57a0b5cdd5f05cc0934c",
+  "mksnapshot-v31.7.7-linux-loong64.zip": "fc29cf9577ca51f2a9b9dc1e4a050d032a97651cf57f33f97afab2bccc0f3fd55",
+  "libcxx-objects-v31.7.7-linux-loong64.zip": "3be44075d9e1c51d3f8d57fa11ec3309d794a18c6d85cfccb41b921d9b34b319",
+  "hunspell_dictionaries.zip": "0304fb074f92103daa0d848feb2ee00e670ec92fb81015dcded43a4ec34172c9",
+  "libcxx_headers.zip": "b8c47e655009190c90e38f604fd2fa4bbb54c34c4937ae74ab52e77184ab53e2",
+  "libcxxabi_headers.zip": "f13c9e65d066d4162cf28ef75bf72a6f5af321d890dab771afab2bccc0f3fd55",
+  "electron-api.json": "87f9256d33e469a4fe0a211c5cc3165478c115ae1729581f1364bff4a2175bc6",
+  "electron.d.ts": "8c97aff04f7fb10b5e204eac0d8e18ab77d0ecdf19a0f2b0c0957e12e9772dbd"
+}

package/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+const proc = require('child_process');
+
+const electron = require('./');
+
+const child = proc.spawn(electron, process.argv.slice(2), { stdio: 'inherit', windowsHide: false });
+child.on('close', function (code, signal) {
+  if (code === null) {
+    console.error(electron, 'exited with signal', signal);
+    process.exit(1);
+  }
+  process.exit(code);
+});
+
+const handleTerminationSignal = function (signal) {
+  process.on(signal, function signalHandler () {
+    if (!child.killed) {
+      child.kill(signal);
+    }
+  });
+};
+
+handleTerminationSignal('SIGINT');
+handleTerminationSignal('SIGTERM');