yy-tauri-macos-dmg 0.1.0

package/README.md

@@ -0,0 +1,38 @@
+# yy-tauri-macos-dmg
+
+在 **macOS** 上为 **Tauri 2** 项目生成带「隔离属性修复」`.command` 的 DMG（依赖本机已安装 [create-dmg](https://github.com/create-dmg/create-dmg)）。
+
+## 安装
+
+```bash
+npm install -D yy-tauri-macos-dmg
+# 或
+pnpm add -D yy-tauri-macos-dmg
+```
+
+## 使用
+
+在 Tauri 项目根目录（含 `src-tauri/tauri.conf.json`）执行：
+
+```bash
+npx yy-tauri-macos-dmg
+# 或指定目录
+npx yy-tauri-macos-dmg /path/to/your-tauri-app
+```
+
+本机需已安装：`brew install create-dmg`，以及 `release.config.json` 里配置的构建命令所需工具（默认 `pnpm tauri build`）。
+
+## 程序化读取发布配置
+
+本包导出与 Tauri 项目根目录 `release.config.json` / `tauri.conf.json` 合并后的配置：
+
+```js
+import { loadReleaseConfig } from 'yy-tauri-macos-dmg/release-config'
+
+const c = loadReleaseConfig('/path/to/project')
+console.log(c.productName, c.version)
+```
+
+## 许可
+
+MIT

package/bin/cli.mjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * 在任意 Tauri 项目根目录执行 macOS DMG 打包（含隔离修复 .command）
+ */
+
+import { spawnSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+const args = process.argv.slice(2)
+if (args[0] === '-h' || args[0] === '--help') {
+  console.log(`用法: yy-tauri-macos-dmg [项目根目录]
+
+  未指定目录时使用当前工作目录。
+
+  依赖（本机）:
+ - macOS
+    - brew install create-dmg
+    - Node.js、pnpm 或 npm（与目标项目的 tauriBuildCommand 一致）
+
+  目标项目需包含 src-tauri/tauri.conf.json，且 bundle 已启用。`)
+  process.exit(0)
+}
+
+const project = resolve(args[0] || process.cwd())
+const tauriConf = join(project, 'src-tauri', 'tauri.conf.json')
+if (!existsSync(tauriConf)) {
+  console.error(`错误：未找到 Tauri 配置：${tauriConf}`)
+  process.exit(1)
+}
+
+const script = join(__dirname, '..', 'scripts', 'build-macos-dmg.sh')
+if (!existsSync(script)) {
+  console.error(`错误：未找到打包脚本：${script}`)
+  process.exit(1)
+}
+
+const r = spawnSync('bash', [script], {
+  env: { ...process.env, TAURI_PROJECT_ROOT: project },
+  stdio: 'inherit',
+  cwd: project,
+})
+
+process.exit(r.status ?? 1)

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "yy-tauri-macos-dmg",
+  "version": "0.1.0",
+  "description": "CLI：为 Tauri 2 项目生成带「隔离属性修复」脚本的 macOS DMG（create-dmg）",
+  "license": "MIT",
+  "type": "module",
+  "bin": "bin/cli.mjs",
+  "files": [
+    "bin",
+    "scripts",
+    "templates"
+  ],
+  "exports": {
+    "./release-config": "./scripts/lib/release-config.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "tauri",
+    "tauri2",
+    "dmg",
+    "macos",
+    "create-dmg",
+    "quarantine"
+  ]
+}

package/scripts/build-macos-dmg.sh

@@ -0,0 +1,167 @@
+#!/bin/bash
+# ============================================
+# macOS 通用 DMG 打包（Tauri）
+# 依赖目标项目根目录 release.config.json（可选）与 tauri.conf.json
+# 流程：tauri build → 从 DMG 或 .app 取包 → 注入隔离修复脚本 → create-dmg
+#
+# 项目根目录：优先环境变量 TAURI_PROJECT_ROOT；否则自动探测（旧 scripts/ 布局或本 monorepo）
+# ============================================
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+if [ -n "${TAURI_PROJECT_ROOT:-}" ]; then
+    PROJECT_DIR="$(cd "$TAURI_PROJECT_ROOT" && pwd)"
+else
+    _parent="$(dirname "$SCRIPT_DIR")"
+    if [ -f "$_parent/src-tauri/tauri.conf.json" ]; then
+        PROJECT_DIR="$(cd "$_parent" && pwd)"
+    elif [ -f "$(cd "$SCRIPT_DIR/../../.." && pwd)/src-tauri/tauri.conf.json" ]; then
+        PROJECT_DIR="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+    else
+        echo "错误：无法确定 Tauri 项目根目录。"
+        echo "请设置 TAURI_PROJECT_ROOT=/path/to/project后重试（目录下需有 src-tauri/tauri.conf.json）。"
+        exit 1
+    fi
+fi
+
+# 使用临时文件 source，避免 `source <(node …)` 在 sh / 部分环境下失效导致变量为空
+DMG_ENV_FILE=$(mktemp)
+trap 'rm -f "$DMG_ENV_FILE"' EXIT
+node "$SCRIPT_DIR/emit-dmg-env.mjs" "$PROJECT_DIR" >"$DMG_ENV_FILE"
+set -a
+# shellcheck disable=SC1090
+source "$DMG_ENV_FILE"
+set +a
+if [ -z "$APP_DISPLAY_NAME" ] || [ -z "$APP_VERSION" ]; then
+    echo "错误：未能从 Tauri / release 配置读取 APP_DISPLAY_NAME 或 APP_VERSION（请用 bash 执行本脚本）。"
+    exit 1
+fi
+
+ARCH=$(uname -m)
+BUNDLE_ROOT="$PROJECT_DIR/src-tauri/target/release/bundle"
+DMG_DIR="$BUNDLE_ROOT/dmg"
+FINAL_DMG="$DMG_DIR/${APP_DISPLAY_NAME}_${APP_VERSION}_${ARCH}.dmg"
+QUARANTINE_TEMPLATE="$SCRIPT_DIR/../templates/macos-quarantine-fix.command.in"
+
+echo ""
+echo "========================================="
+echo "  ${APP_DISPLAY_NAME} macOS 打包"
+echo "========================================="
+echo ""
+
+if ! command -v create-dmg &>/dev/null; then
+    echo "错误：未安装 create-dmg，请先执行：brew install create-dmg"
+    exit 1
+fi
+
+if ! command -v node &>/dev/null; then
+    echo "错误：需要 Node.js 以读取 release 配置"
+    exit 1
+fi
+
+echo "步骤 1/4：执行构建 ..."
+cd "$PROJECT_DIR"
+eval "$TAURI_BUILD_CMD"
+
+if [ ! -d "$BUNDLE_ROOT" ]; then
+    echo "错误：未找到打包目录："
+    echo "  $BUNDLE_ROOT"
+    echo "请确认 tauri build 已成功完成（含 bundle 阶段）。"
+    exit 1
+fi
+
+TAURI_DMG=$(find "$BUNDLE_ROOT" -name "*.dmg" -type f 2>/dev/null | head -n 1)
+APP_FROM_BUNDLE=$(find "$BUNDLE_ROOT" -maxdepth 4 -name "*.app" -type d 2>/dev/null | head -n 1)
+
+if [ -n "$TAURI_DMG" ]; then
+    echo "找到 Tauri DMG：$TAURI_DMG"
+elif [ -n "$APP_FROM_BUNDLE" ]; then
+    echo "未找到 DMG，将使用 .app 继续打包：$APP_FROM_BUNDLE"
+else
+    echo "错误：在 $BUNDLE_ROOT 下未找到 .dmg 或 .app。"
+    echo "目录内容："
+    ls -laR "$BUNDLE_ROOT" || true
+    exit 1
+fi
+
+if [ ! -f "$QUARANTINE_TEMPLATE" ]; then
+    echo "错误：未找到隔离修复模板：$QUARANTINE_TEMPLATE"
+    exit 1
+fi
+
+echo ""
+echo "步骤 2/4：准备 .app 与卷图标 ..."
+TEMP_DIR=$(mktemp -d)
+STAGING_DIR="$TEMP_DIR/staging"
+MOUNT_POINT="$TEMP_DIR/mount"
+mkdir -p "$STAGING_DIR" "$MOUNT_POINT"
+
+APP_BUNDLE_NAME=""
+QUARANTINE_APP_STEM=""
+VOL_ICON=""
+
+if [ -n "$TAURI_DMG" ]; then
+    hdiutil attach "$TAURI_DMG" -mountpoint "$MOUNT_POINT" -quiet -nobrowse
+    APP_IN_DMG=$(find "$MOUNT_POINT" -maxdepth 1 -name "*.app" -type d | head -n 1)
+    if [ -z "$APP_IN_DMG" ] || [ ! -d "$APP_IN_DMG" ]; then
+        echo "错误：挂载的 DMG 内未找到 .app。"
+        ls -la "$MOUNT_POINT" || true
+        hdiutil detach "$MOUNT_POINT" -quiet || true
+        exit 1
+    fi
+    APP_BUNDLE_NAME=$(basename "$APP_IN_DMG")
+    cp -R "$APP_IN_DMG" "$STAGING_DIR/"
+    if [ -f "$MOUNT_POINT/.VolumeIcon.icns" ]; then
+        cp "$MOUNT_POINT/.VolumeIcon.icns" "$TEMP_DIR/VolumeIcon.icns"
+        VOL_ICON="$TEMP_DIR/VolumeIcon.icns"
+    fi
+    hdiutil detach "$MOUNT_POINT" -quiet
+else
+    APP_BUNDLE_NAME=$(basename "$APP_FROM_BUNDLE")
+    cp -R "$APP_FROM_BUNDLE" "$STAGING_DIR/"
+fi
+
+QUARANTINE_APP_STEM="${APP_BUNDLE_NAME%.app}"
+
+echo "步骤 3/4：生成隔离修复脚本并构建 DMG ..."
+GEN_FIX="$STAGING_DIR/$DMG_QUARANTINE_SCRIPT_NAME"
+node "$SCRIPT_DIR/render-quarantine-script.mjs" "$QUARANTINE_TEMPLATE" "$GEN_FIX" "$QUARANTINE_APP_STEM"
+chmod +x "$GEN_FIX"
+
+CREATE_DMG_ARGS=(
+    --volname "$APP_DISPLAY_NAME"
+    --window-pos 200 120
+    --window-size 700 340
+    --icon-size 80
+    --text-size 13
+    --icon "$APP_BUNDLE_NAME" 120 150
+    --icon "Applications" 350 150
+    --icon "$DMG_QUARANTINE_SCRIPT_NAME" 570 150
+    --app-drop-link 350 150
+    --no-internet-enable
+)
+
+if [ -n "$VOL_ICON" ]; then
+    CREATE_DMG_ARGS+=(--volicon "$VOL_ICON")
+fi
+
+rm -f "$TEMP_DIR/output.dmg"
+create-dmg "${CREATE_DMG_ARGS[@]}" "$TEMP_DIR/output.dmg" "$STAGING_DIR"
+
+echo ""
+echo "步骤 4/4：写入最终 DMG ..."
+mkdir -p "$DMG_DIR"
+mv "$TEMP_DIR/output.dmg" "$FINAL_DMG"
+rm -rf "$TEMP_DIR"
+
+echo ""
+echo "========================================="
+echo "打包成功"
+echo ""
+echo "DMG 路径："
+echo "  $FINAL_DMG"
+echo ""
+echo "内容：$APP_BUNDLE_NAME | Applications | $DMG_QUARANTINE_SCRIPT_NAME"
+echo "========================================="
+echo ""

package/scripts/emit-dmg-env.mjs

@@ -0,0 +1,22 @@
+/**
+ * 向 stdout 输出可被 bash `source` 的变量赋值（用于 build-macos-dmg.sh）
+ */
+
+import { loadReleaseConfig, shellSingleQuote } from './lib/release-config.mjs'
+
+/**
+ * @returns {void}
+ */
+function main() {
+  const projectRoot = process.argv[2] || process.cwd()
+  const c = loadReleaseConfig(projectRoot)
+  const esc = shellSingleQuote
+  const folder = c.macos.applicationsAppFolderName
+  console.log(`APP_DISPLAY_NAME=${esc(c.productName)}`)
+  console.log(`APP_VERSION=${esc(c.version)}`)
+  console.log(`QUARANTINE_APP_FOLDER=${esc(folder)}`)
+  console.log(`TAURI_BUILD_CMD=${esc(c.tauriBuildCommand)}`)
+  console.log(`DMG_QUARANTINE_SCRIPT_NAME=${esc(c.macos.quarantineScriptDisplayName)}`)
+}
+
+main()

package/scripts/lib/release-config.mjs

@@ -0,0 +1,92 @@
+/**
+ * 跨项目复用的发布/打包配置加载器。
+ * 默认约定 Tauri 2 工程结构；可通过仓库根目录 release.config.json 覆盖路径与命令。
+ */
+
+import { existsSync, readFileSync } from 'fs'
+import { resolve } from 'path'
+
+const DEFAULTS = {
+  tauriConfigPath: 'src-tauri/tauri.conf.json',
+  changelogOutPath: 'src/data/changelog.ts',
+  cargoTomlPath: 'src-tauri/Cargo.toml',
+  /** @type {string[]} */
+  bumpExtraJsonVersionPaths: [],
+  tauriBuildCommand: 'pnpm tauri build',
+  genChangelogScript: 'scripts/gen-changelog.mjs',
+  macos: {
+    /** DMG 内「移除隔离属性」脚本在访达中显示的文件名 */
+    quarantineScriptDisplayName: '文件损坏修复.command',
+  },
+}
+
+/**
+ * 读取并合并发布配置（defaults + release.config.json + tauri.conf.json 中的 productName/version）
+ *
+ * @param {string} projectRoot 仓库根目录（绝对或相对 cwd）
+ * @returns {object} 合并后的配置（含 productName、version、路径与 macOS 选项）
+ */
+export function loadReleaseConfig(projectRoot) {
+  const root = resolve(projectRoot)
+  const configPath = resolve(root, 'release.config.json')
+  /** @type {Record<string, unknown>} */
+  let fileCfg = {}
+  if (existsSync(configPath)) {
+    fileCfg = JSON.parse(readFileSync(configPath, 'utf-8'))
+  }
+
+  const tauriRel =
+    typeof fileCfg.tauriConfigPath === 'string' ? fileCfg.tauriConfigPath : DEFAULTS.tauriConfigPath
+  const tauriPath = resolve(root, tauriRel)
+  if (!existsSync(tauriPath)) {
+    throw new Error(`[release-config] 未找到 Tauri 配置：${tauriPath}`)
+  }
+
+  const tauri = JSON.parse(readFileSync(tauriPath, 'utf-8'))
+  const productName = tauri.productName
+  const version = tauri.version
+  if (!productName || !version) {
+    throw new Error(`[release-config] ${tauriRel} 缺少 productName 或 version`)
+  }
+
+  const macosFile = /** @type {Record<string, unknown>} */ (
+    fileCfg.macos && typeof fileCfg.macos === 'object' ? fileCfg.macos : {}
+  )
+
+  const applicationsAppFolderName =
+    typeof macosFile.applicationsAppFolderName === 'string' ? macosFile.applicationsAppFolderName : productName
+
+  return {
+    projectRoot: root,
+    tauriConfigPath: tauriRel,
+    changelogOutPath:
+      typeof fileCfg.changelogOutPath === 'string' ? fileCfg.changelogOutPath : DEFAULTS.changelogOutPath,
+    cargoTomlPath: typeof fileCfg.cargoTomlPath === 'string' ? fileCfg.cargoTomlPath : DEFAULTS.cargoTomlPath,
+    bumpExtraJsonVersionPaths: Array.isArray(fileCfg.bumpExtraJsonVersionPaths)
+      ? fileCfg.bumpExtraJsonVersionPaths.filter((p) => typeof p === 'string')
+      : DEFAULTS.bumpExtraJsonVersionPaths,
+    tauriBuildCommand:
+      typeof fileCfg.tauriBuildCommand === 'string' ? fileCfg.tauriBuildCommand : DEFAULTS.tauriBuildCommand,
+    genChangelogScript:
+      typeof fileCfg.genChangelogScript === 'string' ? fileCfg.genChangelogScript : DEFAULTS.genChangelogScript,
+    productName,
+    version,
+    macos: {
+      quarantineScriptDisplayName:
+        typeof macosFile.quarantineScriptDisplayName === 'string'
+          ? macosFile.quarantineScriptDisplayName
+          : DEFAULTS.macos.quarantineScriptDisplayName,
+      applicationsAppFolderName,
+    },
+  }
+}
+
+/**
+ * 将字符串转为可安全嵌入单引号 shell 赋值语句的字面量
+ *
+ * @param {string} s
+ * @returns {string}
+ */
+export function shellSingleQuote(s) {
+  return `'${String(s).replace(/'/g, `'\\''`)}'`
+}

package/scripts/render-quarantine-script.mjs

@@ -0,0 +1,24 @@
+/**
+ * 将模板中的占位符替换为实际「应用程序」目录名（不含 .app），写入 DMG 内 .command 文件
+ *
+ * @param {string} templatePath 模板路径
+ * @param {string} outputPath 输出路径
+ * @param {string} appFolderName Applications 下的 .app 目录名（不含后缀）
+ */
+import { readFileSync, writeFileSync } from 'fs'
+
+/**
+ * @returns {void}
+ */
+function main() {
+  const [, , templatePath, outputPath, appFolderName] = process.argv
+  if (!templatePath || !outputPath || appFolderName === undefined) {
+    console.error('用法: node render-quarantine-script.mjs <模板> <输出> <App目录名>')
+    process.exit(1)
+  }
+  let text = readFileSync(templatePath, 'utf8')
+  text = text.replace(/__QUARANTINE_APP_FOLDER__/g, appFolderName)
+  writeFileSync(outputPath, text, 'utf8')
+}
+
+main()

package/templates/macos-quarantine-fix.command.in

@@ -0,0 +1,44 @@
+#!/bin/bash
+# 由 build-macos-dmg.sh 从模板生成；占位符 __QUARANTINE_APP_FOLDER__ 为「应用程序」内 .app 主名
+
+APP_FOLDER="__QUARANTINE_APP_FOLDER__"
+APP_PATH="/Applications/${APP_FOLDER}.app"
+
+echo ""
+echo "========================================="
+echo "  移除隔离属性：${APP_FOLDER}"
+echo "========================================="
+echo ""
+
+if [ ! -d "$APP_PATH" ]; then
+    echo "错误：未在 /Applications 目录找到 ${APP_FOLDER}.app"
+    echo ""
+    echo "请确认应用已拖入「应用程序」文件夹，或手动输入路径："
+    read -r -p "应用路径（直接回车跳过）: " CUSTOM_PATH
+    if [ -n "$CUSTOM_PATH" ]; then
+        APP_PATH="$CUSTOM_PATH"
+    else
+        echo ""
+        echo "已取消操作。"
+        echo ""
+        read -n 1 -s -r -p "按任意键关闭窗口..."
+        exit 1
+    fi
+fi
+
+echo "正在修复：$APP_PATH"
+echo "（需要输入开机密码，输入时不会显示字符）"
+echo ""
+
+sudo xattr -rd com.apple.quarantine "$APP_PATH"
+
+if [ $? -eq 0 ]; then
+    echo ""
+    echo "完成：已移除隔离属性，可尝试重新打开 ${APP_FOLDER}。"
+else
+    echo ""
+    echo "失败：请检查密码是否正确或路径是否存在。"
+fi
+
+echo ""
+read -n 1 -s -r -p "按任意键关闭窗口..."