# uniAdmin_electron

**Repository Path**: somelin/uniadmin_electron

## Basic Information

- **Project Name**: uniAdmin_electron
- **Description**: 基于 uni-app，的 uniAdmin 管理项目模板，去掉了uniCloud 相关代码。可打包成electron
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2023-06-21
- **Last Updated**: 2026-04-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# uniCloud-admin

> 基于 uni-app，uniCloud 的 admin 管理项目模板。[文档](https://uniapp.dcloud.io/uniCloud/admin)
>> 删除了uniCloud功能, http请求使用自定义接口服务,
>> 其他都是官方原版功能, 要扩展http请求请看 /js_sdk/uni-admin/request.js


# 使用uniapp开发的h5打包electron桌面端应用

## 1、安装electron（主程序）
全局安装electron，这个步骤建议翻墙后使用，否则安装过程可能有些问题，尝试过cnpm安装也不行

npm install electron -g
## 2、安装electron-packager（打包用）
全局安装，同样是翻墙网络环境下安装

npm install electron-packager -g
## 3、uniapp的manifest.json修改
manifest.json-h5配置

运行的基础路径修改为：

./
去掉启用https协议//此操作不会影响后端请求https
## 4、h5打包
HbuilderX顶部菜单栏-发布-h5手机版发行-发行

发行的默认目录为：unpackage\dist\build\h5

## 5、新建package.json和main.js
### 你的项目目录/
├── static
└── index.html
### 新建后项目目录/
├── static
├── package.json
├── main.js
└── index.html
### 在 package.json 中添加如下内容
{
  "name"    : "app-name",
  "version" : "0.1.0",
  "main"    : "main.js"
}
### 在 main.js 中添加如下内容
const {app, BrowserWindow} = require('electron')
const path = require('path')
const url = require('url')
const electron = require('electron')
/*获取electron窗体的菜单栏*/
const Menu = electron.Menu
/*隐藏electron创听的菜单栏*/
Menu.setApplicationMenu(null)
// Keep a global reference of the window object, if you don't, the window will
// be closed automatically when the JavaScript object is garbage collected.
let win
function createWindow () {
  // Create the browser window.
  win = new BrowserWindow({width: 375, height: 667})
  // and load the index.html of the app.
  win.loadURL(url.format({
    pathname: path.join(__dirname, 'index.html'),
    protocol: 'file:',
    slashes: true
  }))
  // Open the DevTools.
  // win.webContents.openDevTools()
  // Emitted when the window is closed.
  win.on('closed', () => {
    // Dereference the window object, usually you would store windows
    // in an array if your app supports multi windows, this is the time
    // when you should delete the corresponding element.
    win = null
  })
}
// This method will be called when Electron has finished
// initialization and is ready to create browser windows.
// Some APIs can only be used after this event occurs.
app.on('ready', createWindow)
// Quit when all windows are closed.
app.on('window-all-closed', () => {
  // On macOS it is common for applications and their menu bar
  // to stay active until the user quits explicitly with Cmd + Q
  if (process.platform !== 'darwin') {
    app.quit()
  }
})
app.on('activate', () => {
  // On macOS it's common to re-create a window in the app when the
  // dock icon is clicked and there are no other windows open.
  if (win === null) {
    createWindow()
  }
})
// In this file you can include the rest of your app's specific main process
// code. You can also put them in separate files and require them here.
### 下次使用HbuilderX生成h5前记得备份package.json和main.js二者互为关联，缺一不可


# 打包您的应用程序

## 使用 Electron Forge
Electron 的核心模块中没有捆绑任何用于打包或分发文件的工具。 如果您在开发模式下完成了一个 Electron 应用，需要使用额外的工具来打包应用程序 (也称为可分发文件) 并分发给用户 。 可分发文件可以是安装程序 (例如 Windows 上的 MSI) 或者绿色软件 (例如 macOS 上的 .app 文件)。

Electron Forge 是一个处理 Electron 应用程序打包与分发的一体化工具。 在工具底层，它将许多现有的 Electron 工具 (例如 electron-packager、 @electron/osx-sign、electron-winstaller 等) 组合到一起，因此您不必费心处理不同系统的打包工作。

### 导入你的项目到 Forge
将 Electron Forge 的 CLI 工具包安装到项目的 devDependencies 依赖中，然后使用现成的转化脚本将项目导入至 Electron Forge。

npm
Yarn
pnpm
npm install --save-dev @electron-forge/cli
npx electron-forge import

转换脚本完成后，Forge 会将一些脚本添加到您的 package.json 文件中。

package.json
  //...
  "scripts": {
    "start": "electron-forge start",
    "package": "electron-forge package",
    "make": "electron-forge make"
  },
  //...

CLI 文档
有关 make 或其他 Forge API 的更多信息，请查看 Electron Forge CLI 文档。

您还应该注意到您的 package.json 现在安装了更多的包 在 devDependencies 下，以及一个导出配置的新 forge.config.js 文件 目的。 您应该在预填充的配置中看到多个makers（生成可分发应用程序包的包），每个目标平台一个。

### 创建一个可分发版本
要创建可分发文件，请使用项目中的 make 脚本，该脚本最终运行了 electron-forge make 命令。

npm
Yarn
pnpm
npm run make

该 make 命令包含两步：

它将首先运行 electron-forge package ，把您的应用程序 代码与 Electron 二进制包结合起来。 完成打包的代码将会被生成到一个特定的文件夹中。
然后它将使用这个文件夹为每个 maker 配置生成一个可分发文件。
在脚本运行后，您应该看到一个 out 文件夹，其中包括可分发文件与一个包含其源码的文件夹。

macOS output example
out/
├── out/make/zip/darwin/x64/my-electron-app-darwin-x64-1.0.0.zip
├── ...
└── out/my-electron-app-darwin-x64/my-electron-app.app/Contents/MacOS/my-electron-app

out/make 文件夹中的应用程序应该可以启动了！ 现在，您已经创建了你的第一个 Electron 程序。

可分发文件格式
Electron Forge 通过配置可以为不同的操作系统创建特定格式的可分发文件 (例如 DMG、deb、MSI 等)。 相关配置选项详情，请参阅 Forge 的 Makers 文档。

创建和添加应用程序图标
设置自定义的应用程序图标，需要添加一些额外的配置。 查看 Forge 的图标教程 了解更多信息。

不使用 ELECTRON FORGE 打包
如果您想手动打包代码，或者是想了解 Electron 的打包机制，可以查看完整的 应用程序打包 文档。

## 重要提示：对代码进行签名
In order to distribute desktop applications to end users, we highly recommend that you code sign your Electron app. 代码签名是交付桌面应用程序的重要组成部分，并且它对于应用程序的自动更新功能 (将会在教程最后部分讲解) 来说是必需的。

代码签名是一种可用于证明桌面应用程序是由已知来源创建的安全技术。 Windows 和 macOS 拥有其特定的代码签名系统，这将使用户难以下载或启动未签名的应用程序。

在 macOS 上，代码签名是在应用程序打包时完成的。 而在 Windows 中，则是对可分发文件进行签名操作。 如果您已经拥有适用于 Windows 和 macOS 的代码签名证书，可以在 Forge 配置中设置您的凭据。

INFO
欲了解更多代码签名的信息，请参阅Forge文档中的 签署 macOS 应用程序 指南。

macOS
Windows
forge.config.js
module.exports = {
  packagerConfig: {
    osxSign: {},
    // ...
    osxNotarize: {
      tool: 'notarytool',
      appleId: process.env.APPLE_ID,
      appleIdPassword: process.env.APPLE_PASSWORD,
      teamId: process.env.APPLE_TEAM_ID
    }
    // ...
  }
}

## 摘要
Electron 应用程序需要打包后分发给用户。 在本教程中，您将应用程序导入 Electron Forge 并对其进行配置以打包您的应用程序并生成安装程序。
为了让应用程序受到用户系统的信任，您需要以数字签名证明可分发文件的内容是真实的并且未被代码签名篡改。 只要在应用配置中添加签名证书信息，您就可以通过 Forge 对其进行签名。