Class: Pindo::Unity::NugetHelper

Inherits:
Object
  • Object
show all
Extended by:
Githelper
Defined in:
lib/pindo/module/unity/nugethelper.rb

Class Method Summary collapse

Methods included from Githelper

add_branch, add_tag, add_tag_with_check, clone_clang_repo, clone_devclang_repo, clone_pindo_common_config_repo, clone_pindo_env_config_repo, clong_buildconfig_repo, get_repo_base_name, getcode_to_dir, git_addpush_repo, git_latest_commit_id, git_root_directory, is_git_directory?, local_branch_exists?, local_tag_exists?, prepare_gitenv, process_need_add_files, remote_branch_exists?, remote_tag_exists?, remove_branch, remove_tag

Methods included from Executable

capture_command, #executable, execute_command, which, which!

Class Method Details

.check_conflicts(package_info, nuspec_info) ⇒ Object

检查冲突（忽略 ID 大小写差异）



229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 229

def self.check_conflicts(package_info, nuspec_info)
  conflicts = []

  # ID 对比（都转为小写比较）
  if to_lowercase_id(package_info['name']) != to_lowercase_id(nuspec_info['id'])
    conflicts << "ID不一致: package.json(#{package_info['name']}) vs .nuspec(#{nuspec_info['id']})"
  end

  # 版本对比
  if package_info['version'] != nuspec_info['version']
    conflicts << "版本不一致: package.json(#{package_info['version']}) vs .nuspec(#{nuspec_info['version']})"
  end

  # displayName/title 对比（title 是可选字段）
  if nuspec_info['title'] && package_info['displayName'] != nuspec_info['title']
    conflicts << "标题不一致: package.json displayName(#{package_info['displayName']}) vs .nuspec title(#{nuspec_info['title']})"
  end

  # releaseNotes 对比
  pkg_notes = package_info['releaseNotes'] || package_info['changelogUrl'] || ""
  nuspec_notes = nuspec_info['releaseNotes'] || ""
  if !pkg_notes.empty? && !nuspec_notes.empty? && pkg_notes != nuspec_notes
    conflicts << "发布说明不一致"
  end

  conflicts
end

.check_nuget_tool ⇒ Object

检测 NuGet 工具（Unity Package 只使用 nuget 命令）

Raises:



438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 438

def self.check_nuget_tool
  if system("nuget help > /dev/null 2>&1")
    return true
  end

  raise Informative, <<~ERROR
    未找到 nuget 命令，请安装 NuGet CLI：

    macOS:
      brew install nuget

    Linux:
      sudo apt install nuget  # Ubuntu/Debian
      sudo yum install nuget  # CentOS/RHEL

    Windows:
      choco install nuget.commandline
      或下载 nuget.exe: https://www.nuget.org/downloads
  ERROR
end

.detect_files(package_dir) ⇒ Object

检测文件存在情况



54
55
56
57
58
59
60
61
62
63
64
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 54

def self.detect_files(package_dir)
  has_package_json = File.exist?(File.join(package_dir, "package.json"))
  nuspec_file = find_nuspec_file(package_dir)
  has_nuspec = !nuspec_file.nil?

  {
    has_package_json: has_package_json,
    has_nuspec: has_nuspec,
    nuspec_file: nuspec_file
  }
end

.extract_author_name(author_field) ⇒ Object

从 package.json 的 author 字段提取作者名称支持两种格式：

  1. 字符串: “Wade”

  2. 对象: “Wade”, “email”: “[email protected]”



171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 171

def self.extract_author_name(author_field)
  return 'Unity Package' if author_field.nil?

  if author_field.is_a?(Hash)
    # 如果是对象，提取 name 字段
    author_name = author_field['name'] || author_field[:name] || 'Unity Package'
  elsif author_field.is_a?(String)
    # 如果是字符串，直接使用
    author_name = author_field
  else
    author_name = 'Unity Package'
  end

  # 确保是简单的文本，去除换行和多余空格
  author_name.to_s.strip.gsub(/[\r\n]+/, ' ')
end

.find_nupkg_file(package_dir) ⇒ Object

查找 .nupkg 文件



501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 501

def self.find_nupkg_file(package_dir)
  # 优先在 build 目录查找
  build_dir = File.join(package_dir, "build")
  if File.directory?(build_dir)
    nupkg_files = Dir.glob(File.join(build_dir, "*.nupkg"))
    unless nupkg_files.empty?
      return nupkg_files.max_by { |f| File.mtime(f) }
    end
  end

  # 如果 build 目录没有，在当前目录查找
  nupkg_files = Dir.glob(File.join(package_dir, "*.nupkg"))

  if nupkg_files.empty?
    return nil
  end

  nupkg_files.max_by { |f| File.mtime(f) }
end

.find_nuspec_file(package_dir) ⇒ Object

查找 .nuspec 文件



39
40
41
42
43
44
45
46
47
48
49
50
51
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 39

def self.find_nuspec_file(package_dir)
  # 优先根据 package.json 的 displayName 查找
  if File.exist?(File.join(package_dir, "package.json"))
    package_info = parse_package_json(package_dir)
    display_name = package_info['displayName']
    expected_nuspec = File.join(package_dir, "#{display_name}.nuspec")
    return expected_nuspec if File.exist?(expected_nuspec)
  end

  # 查找任意 .nuspec 文件
  nuspec_files = Dir.glob(File.join(package_dir, "*.nuspec"))
  nuspec_files.first
end

.generate_nuspec_from_package_json(package_info, nuspec_path, nuspec_id) ⇒ Object

生成 .nuspec（从 package.json）



301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 301

def self.generate_nuspec_from_package_json(package_info, nuspec_path, nuspec_id)
  # 提取 projectUrl
  project_url = ''
  if package_info['repository'].is_a?(Hash)
    project_url = package_info['repository']['url'] || ''
  elsif package_info['repository'].is_a?(String)
    project_url = package_info['repository']
  end
  project_url = package_info['homepage'] if project_url.empty? && package_info['homepage']

  # 确保必需字段有值
  description = package_info['description'] || package_info['displayName'] || 'Unity Package'
  release_notes = package_info['releaseNotes'] || package_info['changelogUrl'] || 'No release notes'

  # 提取 author 名称（支持字符串和对象格式）
  author_name = extract_author_name(package_info['author'])

  # 验证 author 格式
  unless validate_authors_format(author_name)
    raise Informative, <<~ERROR
      package.json 中的 author 字段格式无法转换为有效的 <authors> 格式！

      当前 author 值: #{package_info['author'].inspect}
      提取的作者名称: #{author_name}

      请确保 author 字段为以下格式之一:
        1. 字符串: "author": "Wade"
        2. 对象: "author": {"name": "Wade", "email": "[email protected]"}
    ERROR
  end

  # 构建基础的 metadata 内容
  metadata_content = []
  metadata_content << "      <id>#{nuspec_id}</id>"
  metadata_content << "      <version>#{package_info['version']}</version>"
  # title 是可选字段，只有 displayName 存在时才添加
  if package_info['displayName'] && !package_info['displayName'].empty?
    metadata_content << "      <title>#{package_info['displayName']}</title>"
  end
  metadata_content << "      <authors>#{author_name}</authors>"
  metadata_content << "      <requireLicenseAcceptance>false</requireLicenseAcceptance>"
  metadata_content << "      <license type=\"expression\">MIT</license>"
  metadata_content << "      <projectUrl>#{project_url}</projectUrl>"
  metadata_content << "      <description>#{description}</description>"
  metadata_content << "      <releaseNotes>#{release_notes}</releaseNotes>"

  # README.md 是必需的，总是添加 readme 标签
  metadata_content << "      <readme>README.md</readme>"

  # 检查 README.md 是否存在，用于 files 部分的处理
  readme_path = File.join(File.dirname(nuspec_path), "README.md")

  # 构建 files 部分，如果有 README.md 需要特殊处理
  files_content = []
  if File.exist?(readme_path)
    files_content << '    <file src="README.md" target="" />'
    files_content << '    <file src="**" exclude="build/**;.git/**;*.nuspec;*.nupkg;README.md" target="content" />'
  else
    files_content << '    <file src="**" exclude="build/**;.git/**;*.nuspec;*.nupkg" target="content" />'
  end

  nuspec_content = <<~XML
    <?xml version="1.0" encoding="utf-8"?>
    <package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
      <metadata>
    #{metadata_content.join("\n")}
      </metadata>
      <files>
    #{files_content.join("\n")}
      </files>
    </package>
  XML

  File.write(nuspec_path, nuspec_content)
end

.generate_package_json_from_nuspec(nuspec_info, package_json_path, package_json_name) ⇒ Object

生成 package.json（从 .nuspec）



378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 378

def self.generate_package_json_from_nuspec(nuspec_info, package_json_path, package_json_name)
  package_content = {
    "name" => package_json_name,
    "version" => nuspec_info['version'],
    "displayName" => nuspec_info['title'] || package_json_name,  # 如果没有 title，使用 name 作为 displayName
    "description" => nuspec_info['description'],
    "unity" => "2020.3",
    "releaseNotes" => nuspec_info['releaseNotes']
  }

  # 添加 repository 字段（如果有 projectUrl）
  if nuspec_info['projectUrl'] && !nuspec_info['projectUrl'].empty?
    package_content["repository"] = {
      "type" => "git",
      "url" => nuspec_info['projectUrl']
    }
  end

  File.write(package_json_path, JSON.pretty_generate(package_content))
end

.generate_release_notes_from_git(package_dir) ⇒ Object

生成 Release Notes（从 Git 提交历史）



525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 525

def self.generate_release_notes_from_git(package_dir)
  # 获取 .nuspec 文件并解析版本（用于默认消息）
  nuspec_file = find_nuspec_file(package_dir)
  return nil if nuspec_file.nil?

  nuspec_info = parse_nuspec(nuspec_file)
  nuspec_version = nuspec_info['version']
  return nil if nuspec_version.nil? || nuspec_version.empty?

  # 默认消息（带 feat: 标签）
  default_message = "feat: 更新版本到 #{nuspec_version}"

  # 如果不是 Git 仓库，返回默认消息
  unless is_git_directory?(local_repo_dir: package_dir)
    return default_message
  end

  git_root = git_root_directory(local_repo_dir: package_dir)
  unless git_root
    return default_message
  end

  begin
    # 查找是否存在与 nuspec 版本匹配的 tag（支持 v1.1.3, V1.1.3, 1.1.3 等格式）
    matching_tag = nil
    temp_dir = Dir.pwd
    Dir.chdir(git_root)

    # 获取所有 tags
    all_tags = git!(%W(-C #{git_root} tag -l)).split("\n")

    # 查找匹配当前版本的 tag（不区分大小写，支持 v 前缀）
    matching_tag = all_tags.find do |tag|
      tag_version = tag.gsub(/^(v|V|release[\s_-]*)/i, '')
      tag_version.downcase == nuspec_version.downcase
    end

    Dir.chdir(temp_dir)

    # 确定获取哪个范围的 commits
    git_range = if matching_tag
      # 找到匹配的 tag，获取前一个 tag 到这个 tag 的 commits
      puts "📝 找到版本 tag: #{matching_tag}，生成该版本的 release notes..."

      temp_dir = Dir.pwd
      Dir.chdir(git_root)

      # 获取所有 tags 并按版本号排序
      all_tags = git!(%W(-C #{git_root} tag -l)).split("\n")
      sorted_tags = all_tags.sort_by do |tag|
        version_str = tag.gsub(/^(v|V|release[\s_-]*)/i, '')
        version_str.split('.').map(&:to_i)
      end

      # 找到当前 tag 的索引
      tag_index = sorted_tags.index(matching_tag)
      prev_tag = nil
      if tag_index && tag_index > 0
        prev_tag = sorted_tags[tag_index - 1]
      end

      Dir.chdir(temp_dir)

      if prev_tag
        "#{prev_tag}..#{matching_tag}"
      else
        # 如果是第一个 tag，获取所有历史
        matching_tag
      end
    else
      # 没有找到匹配的 tag，获取最新 tag 到 HEAD 的 commits
      puts "📝 未找到版本 #{nuspec_version} 的 tag，生成最新 tag 到 HEAD 的 release notes..."

      # 获取最新 tag
      latest_tag = nil
      ["v", "V", "release", ""].each do |prefix|
        latest_tag = get_latest_version_tag(project_dir: git_root, tag_prefix: prefix)
        break if latest_tag
      end

      if latest_tag
        "#{latest_tag}..HEAD"
      else
        "HEAD"
      end
    end

    # 获取 commit messages（包含完整的 body）
    temp_dir = Dir.pwd
    Dir.chdir(git_root)

    # 使用特殊分隔符来区分不同的 commits
    separator = "---COMMIT-SEPARATOR---"
    commits_raw = git!(%W(-C #{git_root} log #{git_range} --pretty=format:%B#{separator}))

    # 按分隔符拆分成单个 commits
    commits = commits_raw.split(separator).map(&:strip).reject(&:empty?)

    Dir.chdir(temp_dir)

    # 过滤只保留符合规范的 commits（feat:, fix:, docs:, perf:, refactor:, style:, test:, chore:, revert:）
    valid_prefixes = ['feat:', 'fix:', 'docs:', 'doc:', 'perf:', 'refactor:', 'style:', 'test:', 'chore:', 'revert:']
    filtered_commits = commits.select do |commit|
      valid_prefixes.any? { |prefix| commit.downcase.start_with?(prefix) }
    end

    # 如果没有符合规范的 commits，返回默认消息
    if filtered_commits.empty?
      return default_message
    end

    # 返回每条 commit，用换行分隔（不添加空行）
    filtered_commits.join("\n")

  rescue => e
    puts "⚠️  生成 release notes 失败: #{e.message}"
    # 返回默认消息
    default_message
  end
end

.handle_case_a(package_dir) ⇒ Object

情况A：只有 package.json，创建 .nuspec



71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 71

def self.handle_case_a(package_dir)
  package_info = parse_package_json(package_dir)
  validate_package_json(package_info)

  # 确保 package.json 的 name 是全小写
  package_info['name'] = to_lowercase_id(package_info['name'])
  update_package_json_name(package_dir, package_info['name'])

  # 检查 README.md 是否存在
  readme_path = File.join(package_dir, "README.md")
  unless File.exist?(readme_path)
    puts "⚠️  警告: 未找到 README.md 文件"
    puts "   README.md 是 NuGet 包的必需文件"
    puts "   请创建 README.md 文件后再运行此命令"
    puts
  end

  nuspec_path = File.join(package_dir, "#{package_info['displayName']}.nuspec")

  # 生成 .nuspec，ID 使用驼峰格式
  nuspec_id = to_camelcase_id(package_info['name'])
  generate_nuspec_from_package_json(package_info, nuspec_path, nuspec_id)

  puts "✅ 根据 package.json 创建了 #{package_info['displayName']}.nuspec"
  puts "   package.json name: #{package_info['name']} (全小写)"
  puts "   .nuspec id: #{nuspec_id} (驼峰)"

  unless File.exist?(readme_path)
    puts
    puts "⚠️  重要提示: 打包前请确保创建 README.md 文件！"
  end
end

.handle_case_b(package_dir, nuspec_file) ⇒ Object

情况B：只有 .nuspec，创建 package.json



105
106
107
108
109
110
111
112
113
114
115
116
117
118
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 105

def self.handle_case_b(package_dir, nuspec_file)
  nuspec_info = parse_nuspec(nuspec_file)
  validate_nuspec(nuspec_info)

  package_json_path = File.join(package_dir, "package.json")

  # package.json 的 name 使用全小写
  package_json_name = to_lowercase_id(nuspec_info['id'])
  generate_package_json_from_nuspec(nuspec_info, package_json_path, package_json_name)

  puts "✅ 根据 #{File.basename(nuspec_file)} 创建了 package.json"
  puts "   .nuspec id: #{nuspec_info['id']} (驼峰)"
  puts "   package.json name: #{package_json_name} (全小写)"
end

.handle_case_c(package_dir, nuspec_file) ⇒ Object

情况C：同时存在，以 .nuspec 为准同步到 package.json



121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 121

def self.handle_case_c(package_dir, nuspec_file)
  package_info = parse_package_json(package_dir)
  nuspec_info = parse_nuspec(nuspec_file)

  conflicts = check_conflicts(package_info, nuspec_info)

  if conflicts.empty?
    puts "✅ package.json 和 .nuspec 信息一致"

    # 即使一致，也要确保 ID 格式正确
    expected_package_name = to_lowercase_id(nuspec_info['id'])
    expected_nuspec_id = nuspec_info['id']  # 保持驼峰

    if package_info['name'] != expected_package_name
      puts "🔧 修正 package.json name 格式："
      puts "   #{package_info['name']} → #{expected_package_name}"
      update_package_json_name(package_dir, expected_package_name)
    end
  else
    puts "⚠️  检测到不一致，将以 .nuspec 为准同步到 package.json："
    conflicts.each { |msg| puts "   - #{msg}" }
    puts

    # 以 .nuspec 为准，更新 package.json
    update_package_json_from_nuspec(nuspec_info, package_dir)
    puts "✅ 已同步 package.json"
    puts "   .nuspec id: #{nuspec_info['id']} (驼峰)"
    puts "   package.json name: #{to_lowercase_id(nuspec_info['id'])} (全小写)"
  end
end

.handle_case_d(package_dir) ⇒ Object

情况D：都不存在，报错

Raises:



153
154
155
156
157
158
159
160
161
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 153

def self.handle_case_d(package_dir)
  raise Informative, <<~ERROR
    当前目录不是有效的 Unity Package：
    - 缺少 package.json 文件
    - 缺少 .nuspec 文件

    请确保至少存在其中一个文件。
  ERROR
end

.pack_nupkg(package_dir, output_dir = nil) ⇒ Object

执行打包（Unity Package 使用 nuget pack 命令）



460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 460

def self.pack_nupkg(package_dir, output_dir = nil)
  check_nuget_tool

  nuspec_file = find_nuspec_file(package_dir)
  if nuspec_file.nil?
    raise Informative, "未找到 .nuspec 文件，请先运行 pindo unity initpack"
  end

  output_dir ||= File.join(package_dir, "build")
  FileUtils.mkdir_p(output_dir)

  puts "📦 开始打包 Unity Package..."
  puts "   .nuspec: #{File.basename(nuspec_file)}"
  puts "   输出目录: #{output_dir}"
  puts "   使用工具: nuget pack"
  puts

  cmd = "cd \"#{package_dir}\" && nuget pack \"#{File.basename(nuspec_file)}\" -OutputDirectory \"#{output_dir}\""

  success = system(cmd)

  unless success
    raise Informative, "NuGet 打包失败，请检查 .nuspec 文件格式"
  end

  nupkg_files = Dir.glob(File.join(output_dir, "*.nupkg"))
  if nupkg_files.empty?
    raise Informative, "打包完成但未找到 .nupkg 文件"
  end

  nupkg_file = nupkg_files.max_by { |f| File.mtime(f) }
  puts "✅ 打包成功: #{File.basename(nupkg_file)}"
  puts "   路径: #{nupkg_file}"

  nupkg_file
end

.parse_nuspec(nuspec_file) ⇒ Object

解析 .nuspec

Raises:



208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 208

def self.parse_nuspec(nuspec_file)
  doc = Nokogiri::XML(File.read(nuspec_file))
  doc.remove_namespaces!
  metadata = doc.at_xpath('//metadata')

  raise Informative, ".nuspec 文件格式错误：未找到 metadata 节点" if metadata.nil?

  {
    'id' => metadata.at_xpath('id')&.text,
    'version' => metadata.at_xpath('version')&.text,
    'title' => metadata.at_xpath('title')&.text,
    'description' => metadata.at_xpath('description')&.text,
    'releaseNotes' => metadata.at_xpath('releaseNotes')&.text,
    'authors' => metadata.at_xpath('authors')&.text,
    'projectUrl' => metadata.at_xpath('projectUrl')&.text,
    'readme' => metadata.at_xpath('readme')&.text,
    'license' => metadata.at_xpath('license')&.text
  }
end

.parse_package_json(package_dir) ⇒ Object

解析 package.json



202
203
204
205
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 202

def self.parse_package_json(package_dir)
  file_path = File.join(package_dir, "package.json")
  JSON.parse(File.read(file_path))
end

.to_camelcase_id(id) ⇒ Object

保持驼峰（用于 .nuspec）



21
22
23
24
25
26
27
28
29
30
31
32
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 21

def self.to_camelcase_id(id)
  # 如果 id 已经是驼峰，保持原样
  # 如果是全小写，转为驼峰
  if id == id.downcase
    # 简单的转换：按点分割，每段首字母大写
    id.split('.').map do |part|
      part.split(/(?=[A-Z])/).map(&:capitalize).join
    end.join('.')
  else
    id  # 保持原有的驼峰格式
  end
end

.to_lowercase_id(id) ⇒ Object

驼峰转全小写（用于 package.json）



16
17
18
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 16

def self.to_lowercase_id(id)
  id.downcase
end

.update_nuspec_release_notes(nuspec_file, release_notes) ⇒ Object

更新 .nuspec 文件的 releaseNotes



647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 647

def self.update_nuspec_release_notes(nuspec_file, release_notes)
  return unless File.exist?(nuspec_file)
  return if release_notes.nil? || release_notes.empty?

  doc = Nokogiri::XML(File.read(nuspec_file))

  # 保存命名空间信息
  namespaces = doc.collect_namespaces

  # 移除命名空间以便查找
  doc.remove_namespaces!
  metadata = doc.at_xpath('//metadata')

  return unless metadata

  release_notes_node = metadata.at_xpath('releaseNotes')
  if release_notes_node
    release_notes_node.content = release_notes
  else
    # 如果不存在，创建节点
    new_node = Nokogiri::XML::Node.new('releaseNotes', doc)
    new_node.content = release_notes
    metadata.add_child(new_node)
  end

  # 使用 save_with 选项来保持 UTF-8 编码,不转义非 ASCII 字符
  File.write(nuspec_file, doc.to_xml(encoding: 'UTF-8', save_with: Nokogiri::XML::Node::SaveOptions::NO_DECLARATION | Nokogiri::XML::Node::SaveOptions::AS_XML))
end

.update_package_json_from_nuspec(nuspec_info, package_dir) ⇒ Object

更新 package.json（从 .nuspec）



400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 400

def self.update_package_json_from_nuspec(nuspec_info, package_dir)
  package_json_path = File.join(package_dir, "package.json")

  # 读取现有 package.json（保留其他字段）
  package_info = parse_package_json(package_dir)

  # 更新关键字段
  package_info['name'] = to_lowercase_id(nuspec_info['id'])
  package_info['version'] = nuspec_info['version']
  # 如果 nuspec 有 title 字段才更新，否则保留原有的 displayName
  package_info['displayName'] = nuspec_info['title'] if nuspec_info['title']
  package_info['description'] = nuspec_info['description']
  package_info['releaseNotes'] = nuspec_info['releaseNotes']

  # 更新 repository 字段（如果有 projectUrl）
  if nuspec_info['projectUrl'] && !nuspec_info['projectUrl'].empty?
    package_info['repository'] = {
      "type" => "git",
      "url" => nuspec_info['projectUrl']
    }
  end

  File.write(package_json_path, JSON.pretty_generate(package_info))
end

.update_package_json_name(package_dir, new_name) ⇒ Object

更新 package.json 的 name 字段



426
427
428
429
430
431
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 426

def self.update_package_json_name(package_dir, new_name)
  package_json_path = File.join(package_dir, "package.json")
  package_info = parse_package_json(package_dir)
  package_info['name'] = new_name
  File.write(package_json_path, JSON.pretty_generate(package_info))
end

.validate_authors_format(authors_text) ⇒ Object

验证 authors 字段格式（必须是简单文本，不能是 JSON）



189
190
191
192
193
194
195
196
197
198
199
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 189

def self.validate_authors_format(authors_text)
  return false if authors_text.nil? || authors_text.empty?

  # 检查是否包含 JSON 特征（{, }, :, "name", "email" 等）
  if authors_text.include?('{') || authors_text.include?('}') ||
     authors_text.include?('"name"') || authors_text.include?('"email"')
    return false
  end

  true
end

.validate_nuspec(nuspec_info) ⇒ Object

验证 .nuspec



268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 268

def self.validate_nuspec(nuspec_info)
  required_fields = ['id', 'version', 'description', 'releaseNotes', 'readme', 'projectUrl']
  missing = required_fields.select { |field| nuspec_info[field].nil? || nuspec_info[field].empty? }

  unless missing.empty?
    raise Informative, ".nuspec 缺少必需字段: #{missing.join(', ')}"
  end

  # 验证 authors 字段格式
  if nuspec_info['authors']
    unless validate_authors_format(nuspec_info['authors'])
      raise Informative, <<~ERROR
        .nuspec 文件中的 <authors> 字段格式错误！

        当前格式: #{nuspec_info['authors']}

        正确格式应该是简单的文本，例如:
          <authors>Wade</authors>

        错误格式示例:
          <authors>{"name": "wade","email": "[email protected]"}</authors>

        请修正 .nuspec 文件中的 authors 字段。
      ERROR
    end
  end
end

.validate_package_json(package_info) ⇒ Object

验证 package.json



258
259
260
261
262
263
264
265
 
# File 'lib/pindo/module/unity/nugethelper.rb', line 258

def self.validate_package_json(package_info)
  required_fields = ['name', 'version', 'displayName']
  missing = required_fields.select { |field| package_info[field].nil? || package_info[field].empty? }

  unless missing.empty?
    raise Informative, "package.json 缺少必需字段: #{missing.join(', ')}"
  end
end