Hướng dẫn thực hành toàn diện về nw-builder: Giải pháp cuối cùng để xây dựng ứng dụng NW.js đa nền tảng

Địa chỉ dự án: https://gitcode.com/gh_mirrors/nwbu/nw-builder

Giới thiệu tổng quan

nw-builder là công cụ xây dựng phổ biến nhất trong hệ sinh thái NW.js, giải quyết ba vấn đề cốt lõi:

• Quản lý môi trường đa nền tảng
• Xử lý tương thích phụ thuộc
• Tối ưu hóa thứ tự tải tài nguyên

Bảng so sánh tính năng chính

Hướng dẫn nhanh

Chuẩn bị môi trường

# Kiểm tra phiên bản Node hiện tại
node -v

# Kiểm tra phiên bản Node tương thích với NW.js (ví dụ v0.102.1)
curl -s https://nwjs.io/versions.json | jq '.versions["v0.102.1"].modules'

Cài đặt

Ví dụ xây dựng tối giản

mkdir demo-nw && cd demo-nw
npm init -y
echo '<h1>Xin chào NW.js</h1>' > index.html

Cấu hình package.json

{
  "name": "demo-nw",
  "version": "1.0.0",
  "main": "index.html",
  "scripts": {
    "chay": "nwbuild --mode=run .",
    "xaydung": "nwbuild --mode=build --platform=linux,win,osx --outDir=ketqua ."
  },
  "devDependencies": {
    "nw-builder": "^4.15.0"
  }
}

Các chế độ hoạt động

Chế độ get

import xaydung from 'nw-builder';

await xaydung({
  mode: 'get',
  version: '0.102.1',
  flavor: 'sdk',
  platform: 'osx',
  arch: 'arm64',
  downloadUrl: 'https://npm.taobao.org/mirrors/nwjs',
  cacheDir: './nwjs-cache',
  ffmpeg: true
});

Chế độ run

# CLI ví dụ: chạy với tham số gỡ lỗi
nwbuild --mode=run --argv="--remote-debugging-port=9222" ./src

Chế độ build

xaydung({
  mode: 'build',
  srcDir: './app',
  outDir: './dist',
  version: '0.102.1',
  flavor: 'normal',
  platform: ['linux', 'win', 'osx'],
  arch: 'x64',
  glob: true,
  zip: 'tar',
  managedManifest: true,
  app: {
    linux: {
      name: 'AppCuaToi',
      icon: './icons/icon.png',
      categories: ['Tiện ích']
    },
    win: {
      icon: './icons/icon.ico',
      company: 'CongTyToi',
      fileDescription: 'Ứng dụng NW.js'
    },
    osx: {
      CFBundleIdentifier: 'com.congty.app',
      NSHumanReadableCopyright: 'Bản quyền © 2025'
    }
  }
});

Hướng dẫn xây dựng đa nền tảng

Bảng so sánh cấu hình nền tảng

Tính năng nâng cao

Tích hợp FFmpeg

xaydung({
  mode: 'build',
  ffmpeg: true,
});

Quản lý phụ thuộc

xaydung({
  mode: 'build',
  managedManifest: {
    name: 'app-toi',
    main: 'index.html',
    dependencies: {
      'lodash': '^4.17.0'
    }
  }
});

Chữ ký mã nguồn

Trên Windows

signtool sign /f mycert.pfx /p password /t http://timestamp.digicert.com ketqua/myapp.exe

Trên macOS

codesign --deep --force --sign "Developer ID Application: CongTyToi" ketqua/myapp.app

Tài nguyên hữu ích

• GitHub: https://gitcode.com/gh_mirrors/nwbu/nw-builder
• Phiên bản NW.js: https://nwjs.io/versions.json
• FFmpeg: https://github.com/nwjs-ffmpeg-prebuilt/nwjs-ffmpeg-prebuilt