档案管理系统适配统信UOS桌面端全流程实操指南

一、前置准备

1. 必备工具安装

在统信终端执行以下命令安装所有依赖工具：

• sudo apt update && sudo apt install nodejs=18. npm=8. -y
• sudo apt install deepin-dev-tools deepin-application-devel -y
• npm install -g @electron/packager

2. 适配模板获取

直接下载官方Electron适配模板：统信开发者社区模板页，选择「Electron App Template」解压至本地，重命名为archive-app。

二、核心适配配置

1. 主进程文件修改（main.js）

打开archive-app/main.js，替换全部内容为以下代码：

``` const { app, BrowserWindow, dialog } = require('electron'); const path = require('path'); let mainWindow; function createWindow() { mainWindow = new BrowserWindow({ width: 1280, height: 800, webPreferences: { nodeIntegration: true, contextIsolation: false, enableRemoteModule: true }, titleBarStyle: 'default', backgroundColor: 'ffffff' }); // 替换为你的实际档案系统地址 mainWindow.loadURL('https://你的档案系统域名/路径'); mainWindow.on('closed', () => mainWindow = null); } app.whenReady().then(createWindow); app.on('window-all-closed', () => { if (process.platform !== 'darwin') app.quit(); }); app.on('activate', () => { if (mainWindow === null) createWindow(); }); // 统信适配必备多实例回调 app.on('second-instance', (event, commandLine, workingDirectory) => { if (mainWindow) { if (mainWindow.isMinimized()) mainWindow.restore(); mainWindow.focus(); } }); ```

必须替换代码中`https://你的档案系统域名/路径`为实际地址，否则无法加载内容。

2. 应用标识配置（package.json）

打开archive-app/package.json，仅修改以下字段：

``` { "name": "archive-system", "version": "1.0.0", "description": "企业档案管理系统", "main": "main.js", "scripts": { "start": "electron .", "pack": "electron-packager . archive-system --platform=linux --arch=x64 --out=dist --overwrite" }, "build": { "appId": "com.uniontech.archive.system", "linux": { "target": ["deb", "AppImage"], "category": "Utility;Office" } }, "devDependencies": { "electron": "^28.0.0", "@electron/packager": "^18.1.0" } } ```

将`build.appId`改为全局唯一标识，`linux.category`固定为`Utility;Office`，确保统信分类正确。

3. 统信桌面快捷方式配置

在archive-app根目录新建`archive-system.desktop`，内容复制：

``` [Desktop Entry] Type=Application Name=档案管理系统 Comment=企业档案查询与管理工具 Exec=/opt/archive-system/archive-system %U Icon=/opt/archive-system/icon.png Terminal=false Categories=Utility;Office; MimeType=application/pdf;application/msword;application/vnd.openxmlformats-officedocument.wordprocessingml.document; Keywords=档案;文档;管理; ```

必须创建该文件，否则统信无法识别为标准应用。

三、打包与本地测试

1. 生成适配安装包

进入archive-app目录，执行打包命令：

• npm run pack

执行后`dist`文件夹内的`archive-system-linux-x64.deb`即为统信适用安装包。

2. 本地安装验证

执行安装命令：

• sudo dpkg -i dist/archive-system-linux-x64.deb

若出现依赖错误，执行修复命令：

• sudo apt install -f -y

安装后在统信启动器搜索「档案管理系统」，验证能否正常加载档案内容。

四、统信应用商店上架补充

登录统信开发者平台（https://developer.uniontech.com），提交：

• deb安装包
• 128x128 PNG图标（测试地址：https://cdn.example.com/archive-icon.png）
• archive-system.desktop文件
• 2张1920x1080运行截图

提交后1-3个工作日内完成上架。