02. asar 아카이브 — 패키징 포맷과 그 한계

┌──────────────────────────────────────────┐
│  Pickle Header                           │
│  (4 bytes size + 4 bytes header size)    │
├──────────────────────────────────────────┤
│  JSON Header                             │
│  {                                       │
│    "files": {                            │
│      "package.json": {                   │
│        "size": 384, "offset": "0"        │
│      },                                  │
│      "dist": {                           │
│        "files": {                        │
│          "main.js": {                    │
│            "size": 102400,               │
│            "offset": "384"               │
│          }                               │
│        }                                 │
│      }                                   │
│    }                                     │
│  }                                       │
├──────────────────────────────────────────┤
│  File Contents (concatenated, raw)       │
│  package.json bytes ...                  │
│  main.js bytes ...                       │
│  ...                                     │
└──────────────────────────────────────────┘

// 사용자 코드
const fs = require('fs');
fs.readFileSync('/Applications/MyApp.app/Contents/Resources/app.asar/dist/main.js');
// → Electron이 asar 내부 offset으로 변환 → 한 번의 read

asar: true
asarUnpack:
  - "**/*.node"           # 모든 네이티브 바인딩
  - "node_modules/sharp/**/*"   # libvips 의존 — .node + .so/.dll
  - "node_modules/sqlite3/build/Release/*.node"
  - "ffmpeg/**/*"          # 사이드카 binary
  - "resources/templates/**/*"  # 사용자가 직접 fs로 열어야 하는 템플릿

MyApp.app/Contents/Resources/
├── app.asar                    # 코드 대부분
└── app.asar.unpacked/          # unpack된 파일
    ├── node_modules/sharp/...
    └── ffmpeg/ffmpeg

import { app } from 'electron';
import path from 'path';
 
// 개발 모드에서는 그냥 절대 경로
// 패키징 후에는 asar.unpacked 경로
const ffmpegPath = app.isPackaged
  ? path.join(process.resourcesPath, 'app.asar.unpacked', 'ffmpeg', 'ffmpeg')
  : path.join(__dirname, '..', 'ffmpeg', 'ffmpeg');
 
import { spawn } from 'child_process';
spawn(ffmpegPath, ['-i', input, output]);

# 풀기 — 한 줄
npx @electron/asar extract app.asar ./extracted
 
# 또는 단일 파일 확인
npx @electron/asar list app.asar
 
# 또는 핫패치
npx @electron/asar extract-file app.asar dist/main.js
# (수정 후)
npx @electron/asar pack ./extracted app.asar

# electron-builder
asarIntegrity: true   # 기본값