Electron React App

Setup Environment

Windows

# Install chocolatey cli
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# Install dependencies for node-gyp
choco install python visualstudio2022-workload-vctools -y

# Install nodejs & pnpm
choco install nodejs --version='24.15.0'
corepack prepare pnpm --activate

Linux

# Install dependencies for node-gyp
sudo apt update
sudo apt install -y build-essential python3-minimal

# Install nodejs & pnpm by nodesource
sudo apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node -v
corepack prepare pnpm --activate

Build

Linux

Use docker to build deb for Linux

docker compose up --build

Note

Before development and packaging, generate SQL files for database migration using the following command:

Generating SQL depends on the contents of schema.ts. After modifying schema.ts, you need to regenerate the SQL files.

npx drizzle-kit generate

If you need react dev tools

npx react-devtools

Setup terminal encode to UTF8 in Powershell

# windows powershell
$OutputEncoding = [Console]::OutputEncoding = [Text.Encoding]::UTF8

Docker

docker build ./your_directory
docker build -t imageName:imageTag ./your_directory

# 直接用 docker run 执行命令
docker run --rm my-ubuntu-gcc11 gcc --version

# 进入容器交互式检查
docker run -it --rm my-ubuntu-gcc11 bash

# 如果容器已经在运行
docker ps
docker exec -it <container_id_or_name> bash

# 清理掉所有停止的容器、未使用的网络、悬空镜像（dangling images）以及构建缓存
docker system prune
# 默认的 prune 不会删掉“正在被某个容器使用”或者“有标签（Tag）”的镜像。如果你想连同未使用的镜像一起删掉，加上 -a
docker system prune -a --volumes
# 如果你只是想清空构建缓存，可以用
docker builder prune
# 如果要强制删除所有构建缓存（包括最近使用的）：
docker builder prune -a

Docker Compose

docker compose up
docker compose up --build
docker compose up --build -d
docker compose down

docker compose start
docker compose stop
docker compose restart

docker compose ps
docker compose stats

Diskpart

在WSL中使用Docker进行构建时会生成大量的缓存，这些缓存在使用docker builder prune -a后并不会将空间返回给宿主机器，需要使用diskpart对docker使用的虚拟磁盘进行压缩才能重新获取这些空间

diskpart
select vdisk file="C:\Users\zy\AppData\Local\Docker\wsl\disk\docker_data.vhdx"
compact vdisk
detach vdisk
exit

Else

• HMIS:从usprofile.ini文件读取InputSkip，确保自动填充不会引起闪退
• password: Joney