pindo 5.18.13 → 5.18.20

data/lib/pindo/module/task/model/git/git_tag_task.rb

@@ -51,93 +51,108 @@ module Pindo
 
         root_dir = @git_root_path
         git_repo_helper = Pindo::GitRepoHelper.share_instance
-        stash_saved = false
         stash_name = "pindo_stash_#{Time.now.strftime('%Y%m%d%H%M%S')}_#{rand(1000)}"
         coding_branch = Pindo::GitHandler.git!(%W(-C #{root_dir} rev-parse --abbrev-ref HEAD)).strip
+        git_commit_data = get_data_param_by_key(:git_commit)
+        stash_saved = false
 
         begin
-          # 1. 检查工作目录，不干净则 stash
-          status = Pindo::GitHandler.git!(%W(-C #{root_dir} status --porcelain)).strip
-          unless status.empty?
-            Funlog.instance.fancyinfo_update("工作目录有未提交更改，暂存到 stash: #{stash_name}")
-            Pindo::GitHandler.git!(%W(-C #{root_dir} stash push -u -m #{stash_name}))
-            stash_saved = true
-          end
-
-          # 2. 从 GitCommitTask 获取参数（必须在合并之前，确保 release_branch 等参数正确）
-          git_commit_data = get_data_param_by_key(:git_commit)
-          if git_commit_data && git_commit_data[:task_param]
-            param = git_commit_data[:task_param]
-            @release_branch = param[:release_branch] if param[:release_branch]
-            @tag_pre = param[:tag_pre] if param[:tag_pre]
-            @tag_type = param[:tag_type] if param[:tag_type]
-            @ver_inc = param[:ver_inc] if param[:ver_inc]
-          end
-
-          # 3. 合并到发布分支（使用已回填的 @release_branch）
-          if coding_branch != @release_branch
-            Pindo::GitHandler.merge_branches(
-              project_dir: root_dir,
-              source_branch: coding_branch,
-              target_branch: @release_branch,
-              sync_branches: true  # 双向合并，确保两分支完全同步
-            )
-          end
-
-          # 4. 获取版本信息
-          if git_commit_data && git_commit_data[:task_param] &&
-             git_commit_data[:task_param][:build_version] && git_commit_data[:task_param][:build_number]
-            @build_version = git_commit_data[:task_param][:build_version]
-            @build_number = git_commit_data[:task_param][:build_number]
-            Funlog.instance.fancyinfo_success("使用 GitCommitTask 的版本号: #{@build_version}, Build: #{@build_number}, Tag前缀: #{@tag_pre}, Tag类型: #{@tag_type}")
-
-          # 降级：自己计算（向后兼容或 GitCommitTask 无有效数据）
-          else
-            @build_number, @commit_hash = git_repo_helper.get_build_number_from_commit(project_dir: root_dir)
-            @build_version = git_repo_helper.calculate_build_version(
-              project_dir: root_dir,
-              tag_prefix: @tag_pre,
-              create_tag_type: @tag_type,
-              version_increase_type: @ver_inc
-            )
-            commit_short = @commit_hash ? @commit_hash[0..7] : "unknown"
-            Funlog.instance.fancyinfo_warning("未找到 GitCommitTask 依赖，降级为自己计算版本号: #{@build_version}, Build: #{@build_number}, Commit: #{commit_short}")
-          end
-
-          # 4. 创建并推送 Tag
+          # 1. 工作目录不干净则暂存
+          stash_saved = stash_if_dirty(root_dir, stash_name)
+
+          # 2. 从 GitCommitTask 回填参数（须在合并之前，确保 release_branch 等正确）
+          backfill_params_from_commit_task(git_commit_data)
+
+          # 3. 合并到发布分支
+          merge_to_release_branch(root_dir, coding_branch)
+
+          # 4. 解析版本号
+          resolve_build_version(root_dir, git_commit_data, git_repo_helper)
+
+          # 5. 创建并推送 Tag
           tag_name = "#{@tag_pre}#{@build_version}"
           git_repo_helper.create_and_push_tag(
             project_dir: root_dir,
             tag_name: tag_name,
             tag_type: @tag_type
           )
-
         ensure
-          # 5. 还原 stash
-
-          if stash_saved
-            begin
-              # 查找指定名字的 stash
-              stash_list = Pindo::GitHandler.git!(%W(-C #{root_dir} stash list)).strip
-              matched_line = stash_list.lines.find { |l| l.include?(stash_name) }
-
-              if matched_line && (stash_id = matched_line.match(/(stash@\{\d+\})/)&.[](1))
-                # 先应用 stash（不删除）
-                Pindo::GitHandler.git!(%W(-C #{root_dir} stash apply #{stash_id}))
-                # 应用成功后再删除 stash
-                Pindo::GitHandler.git!(%W(-C #{root_dir} stash drop #{stash_id}))
-                Funlog.instance.fancyinfo_success("已还原 stash: #{stash_name} (#{stash_id})")
-              else
-                Funlog.instance.fancyinfo_warning("未找到名为 #{stash_name} 的 stash，请手动检查")
-              end
-            rescue => e
-              # 如果应用失败（通常是有冲突），stash 仍然保留，用户可以手动处理
-              Funlog.instance.fancyinfo_warning("stash 还原时发生冲突: #{e.message}")
-              Funlog.instance.fancyinfo_warning("stash 已保留，请手动执行 'git stash pop' 处理冲突")
-              # 不抛出异常，任务仍然标记为成功（因为 tag 已经创建成功）
-            end
-          end
+          # 6. 还原 stash
+          restore_stash(root_dir, stash_name) if stash_saved
+        end
+      end
+
+      private
+
+      # 工作目录有未提交更改则暂存，返回是否已暂存
+      def stash_if_dirty(root_dir, stash_name)
+        status = Pindo::GitHandler.git!(%W(-C #{root_dir} status --porcelain)).strip
+        return false if status.empty?
+
+        Funlog.instance.fancyinfo_update("工作目录有未提交更改，暂存到 stash: #{stash_name}")
+        Pindo::GitHandler.git!(%W(-C #{root_dir} stash push -u -m #{stash_name}))
+        true
+      end
+
+      # 从 GitCommitTask 回填 release_branch / tag_pre / tag_type / ver_inc
+      def backfill_params_from_commit_task(git_commit_data)
+        return unless git_commit_data && git_commit_data[:task_param]
+
+        param = git_commit_data[:task_param]
+        @release_branch = param[:release_branch] if param[:release_branch]
+        @tag_pre = param[:tag_pre] if param[:tag_pre]
+        @tag_type = param[:tag_type] if param[:tag_type]
+        @ver_inc = param[:ver_inc] if param[:ver_inc]
+      end
+
+      # 将编码分支双向合并到发布分支，确保两分支同步到同一节点
+      def merge_to_release_branch(root_dir, coding_branch)
+        return if coding_branch == @release_branch
+
+        Pindo::GitHandler.merge_branches(
+          project_dir: root_dir,
+          source_branch: coding_branch,
+          target_branch: @release_branch,
+          sync_branches: true  # 双向合并，确保两分支完全同步
+        )
+      end
+
+      # 解析构建版本号：优先用 GitCommitTask 的，否则自己计算（向后兼容）
+      def resolve_build_version(root_dir, git_commit_data, git_repo_helper)
+        if git_commit_data && git_commit_data[:task_param] &&
+           git_commit_data[:task_param][:build_version] && git_commit_data[:task_param][:build_number]
+          @build_version = git_commit_data[:task_param][:build_version]
+          @build_number = git_commit_data[:task_param][:build_number]
+          Funlog.instance.fancyinfo_success("使用 GitCommitTask 的版本号: #{@build_version}, Build: #{@build_number}, Tag前缀: #{@tag_pre}, Tag类型: #{@tag_type}")
+        else
+          @build_number, @commit_hash = git_repo_helper.get_build_number_from_commit(project_dir: root_dir)
+          @build_version = git_repo_helper.calculate_build_version(
+            project_dir: root_dir,
+            tag_prefix: @tag_pre,
+            create_tag_type: @tag_type,
+            version_increase_type: @ver_inc
+          )
+          commit_short = @commit_hash ? @commit_hash[0..7] : "unknown"
+          Funlog.instance.fancyinfo_warning("未找到 GitCommitTask 依赖，降级为自己计算版本号: #{@build_version}, Build: #{@build_number}, Commit: #{commit_short}")
+        end
+      end
+
+      # 还原之前暂存的 stash；冲突时保留 stash 并告警，不抛异常（tag 已创建成功）
+      def restore_stash(root_dir, stash_name)
+        stash_list = Pindo::GitHandler.git!(%W(-C #{root_dir} stash list)).strip
+        matched_line = stash_list.lines.find { |l| l.include?(stash_name) }
+
+        if matched_line && (stash_id = matched_line.match(/(stash@\{\d+\})/)&.[](1))
+          # 先应用 stash（不删除），成功后再删除
+          Pindo::GitHandler.git!(%W(-C #{root_dir} stash apply #{stash_id}))
+          Pindo::GitHandler.git!(%W(-C #{root_dir} stash drop #{stash_id}))
+          Funlog.instance.fancyinfo_success("已还原 stash: #{stash_name} (#{stash_id})")
+        else
+          Funlog.instance.fancyinfo_warning("未找到名为 #{stash_name} 的 stash，请手动检查")
         end
+      rescue => e
+        Funlog.instance.fancyinfo_warning("stash 还原时发生冲突: #{e.message}")
+        Funlog.instance.fancyinfo_warning("stash 已保留，请手动执行 'git stash pop' 处理冲突")
       end
 
     end

data/lib/pindo/module/task/model/unity/unity_export_task.rb

@@ -1,5 +1,6 @@
 require 'pindo/module/task/model/unity_task'
 require 'pindo/base/funlog'
+require 'json'
 
 module Pindo
   module TaskSystem
@@ -18,6 +19,7 @@ module Pindo
       #   - :project_path [String] Unity 项目路径（默认当前目录）
       #   - :export_path [String] 导出路径（nil 表示自动检测）
       #   - :deploy_mode [String] 部署模式 ('dev', 'adhoc', 'release')，默认 'dev'
+      #   - :app_config [Hash] 需写入工程 AppConfig 的键值（传入则在导出前先改写 AppConfig）
       #   - :context [Hash] 上下文信息（如 index_count）
       def initialize(platform, options = {})
         @platform = platform
@@ -26,6 +28,7 @@ module Pindo
         @index_count = options[:context] ? options[:context][:index_count] : nil
         @export_path = options[:export_path]  # 可由参数传入，nil 表示自动检测
         @deploy_mode = options[:deploy_mode] || 'dev'  # 部署模式：dev/adhoc/release，默认 dev
+        @app_config = options[:app_config]  # 需写入 AppConfig 的键值，nil/空表示跳过
 
         name = case platform
                when 'ios', 'ipa'
@@ -57,6 +60,9 @@ module Pindo
       protected
 
       def do_work
+        # 若传入了配置参数，先改写工程内的 AppConfig
+        update_app_config_file if @app_config && !@app_config.empty?
+
         # 获取 Unity 版本
         project_unity_version = get_unity_version
 
@@ -106,6 +112,44 @@ module Pindo
 
       private
 
+      # 使用传入的配置改写 Unity 工程内的 AppConfig（TextAsset JSON）
+      # 仅覆盖 @app_config 中提供的键，其余键保持原值
+      def update_app_config_file
+        app_config_file = File.join(@unity_root_path, "Assets", "Resources", "AppConfig", "AppConfig.json")
+        unless File.exist?(app_config_file)
+          Funlog.warning("未找到 AppConfig 文件，跳过 AppConfig 更新：#{app_config_file}")
+          return
+        end
+
+        puts "更新 AppConfig: #{app_config_file}"
+
+        begin
+          app_config_json = JSON.parse(File.read(app_config_file))
+        rescue JSON::ParserError => e
+          Funlog.warning("AppConfig 不是合法 JSON，跳过更新：#{e.message}")
+          return
+        end
+
+        changed = false
+        @app_config.each do |key, value|
+          next if value.nil? || value.to_s.strip.empty?
+          new_value = value.to_s.strip
+          old_value = app_config_json[key]
+          next if old_value.to_s == new_value
+
+          app_config_json[key] = new_value
+          puts "  ✓ #{key}: #{old_value} → #{new_value}"
+          changed = true
+        end
+
+        if changed
+          File.open(app_config_file, "w") { |f| f.write(JSON.pretty_generate(app_config_json)) }
+          puts "✅ AppConfig 更新完成\n"
+        else
+          puts "AppConfig 无需更新（值一致）\n"
+        end
+      end
+
       # 导出 iOS
       def export_ios
         platform = 'iOS'

data/lib/pindo/module/task/task_reporter.rb

@@ -41,12 +41,57 @@ module Pindo
           end
         end
 
+        # 按依赖拓扑排序展示真实执行顺序
+        ordered = topological_execution_order(@queue.pending_snapshot)
+        is_serial = strategy.respond_to?(:name) && strategy.name.include?("串行")
+        puts "\e[34m"
+        if is_serial
+          puts "\e[34m" + "  实际执行顺序:"
+        else
+          puts "\e[34m" + "  执行顺序预览（并发模式下实际顺序受运行时调度影响）:"
+        end
+        ordered.each_with_index do |task, index|
+          puts "\e[34m" + "    #{index + 1}. #{task.name}"
+        end
+
         puts "\e[34m"
         puts "\e[34m" + "  总计: #{@queue.pending_count} 个任务"
         puts "\e[34m" + "=" * 60 + "\e[0m"
         puts "\n"
       end
 
+      # 按依赖关系生成执行顺序（贪心拓扑排序，模拟串行调度：
+      # 每轮取「入队顺序中第一个依赖已满足」的任务），与串行实际执行顺序一致
+      # @param tasks [Array<PindoTask>] 待排序任务（入队顺序）
+      # @return [Array<PindoTask>] 按执行顺序排列的任务
+      def topological_execution_order(tasks)
+        all_ids = tasks.map(&:id)
+        remaining = tasks.dup
+        completed_ids = []
+        ordered = []
+
+        until remaining.empty?
+          index = remaining.index do |task|
+            task.dependencies.all? do |dep_id|
+              # 依赖已完成，或依赖不在本批任务中（视为已提前完成）
+              completed_ids.include?(dep_id) || !all_ids.include?(dep_id)
+            end
+          end
+
+          # 存在循环依赖或依赖缺失，剩余任务按原顺序追加并结束
+          if index.nil?
+            ordered.concat(remaining)
+            break
+          end
+
+          task = remaining.delete_at(index)
+          completed_ids << task.id
+          ordered << task
+        end
+
+        ordered
+      end
+
       # 输出任务执行标题
       # @param task [PindoTask] 任务对象
       def print_task_title(task)

data/lib/pindo/module/utils/git_repo_helper.rb

@@ -224,41 +224,29 @@ module Pindo
       end
     end
 
-    # 获取Build号（从commit hash转换而来）
+    # 获取Build号（基于 git 提交总数，单调递增）
+    # 对标 fastlane number_of_commits：versionCode = git rev-list --count HEAD
     # @param project_dir [String] 项目目录路径
-    # @return [Integer, String] 返回 build_number 和 commit_hash
-    #   - build_number: Build号（commit hash前6位16进制转10进制）
-    #   - commit_hash: 完整的commit hash（40位）
+    # @return [Array(Integer, String)] build_number 和完整 commit_hash
+    #   - build_number: 当前 HEAD 的 commit 总数（最小为 1）
+    #   - commit_hash: 完整的 commit hash（40位）
     def get_build_number_from_commit(project_dir: nil)
       raise ArgumentError, "项目目录不能为空" if project_dir.nil?
 
-      # 获取git根目录
       git_root = Pindo::GitHandler.git_root_directory(local_repo_dir: project_dir)
-      return 1, nil unless git_root
-
-      begin
-        # 获取当前HEAD的完整commit hash
-        full_commit_hash = Pindo::GitHandler.git!(%W(-C #{git_root} rev-parse HEAD)).strip
-
-        # 取前6位计算build_number
-        short_hash = full_commit_hash[0..5]
+      raise Pindo::Informative, "非 Git 仓库，无法计算 versionCode: #{project_dir}" unless git_root
 
-        # 将16进制转换为10进制
-        build_number = short_hash.to_i(16)
-
-        # 确保在Android versionCode安全范围内（最大值为2^31-1）
-        max_value = 2**31 - 1
-        build_number = build_number % max_value if build_number > max_value
+      # shallow clone 下 rev-list --count 结果不完整，必须先 unshallow
+      shallow = Pindo::GitHandler.git!(%W(-C #{git_root} rev-parse --is-shallow-repository)).strip
+      if shallow == "true"
+        raise Pindo::Informative, "shallow clone 无法计算 versionCode，请执行 git fetch --unshallow 后重试"
+      end
 
-        # 确保build_number不为0
-        build_number = 1 if build_number == 0
+      count = Pindo::GitHandler.git!(%W(-C #{git_root} rev-list --count HEAD)).strip.to_i
+      full_commit_hash = Pindo::GitHandler.git!(%W(-C #{git_root} rev-parse HEAD)).strip
 
-        return build_number, full_commit_hash
-      rescue StandardError => e
-        Funlog.instance.fancyinfo_error("获取commit hash失败: #{e.message}")
-        # 如果获取失败，返回基于时间戳的默认值
-        return Time.now.to_i % 1000000 + 1, nil
-      end
+      build_number = count < 1 ? 1 : count
+      [build_number, full_commit_hash]
     end
 
   
@@ -364,7 +352,7 @@ module Pindo
         if local_exists && Pindo::GitHandler.is_tag_at_head?(git_root_dir: project_dir, tag_name: tag_name)
           if !remote_exists
             # 本地存在且在 HEAD，但远程不存在，推送到远程
-            Pindo::GitHandler.git_remote!(project_dir, %W(-C #{project_dir} push origin #{tag_name}))
+            push_tag_with_verify(project_dir: project_dir, tag_name: tag_name)
             Funlog.instance.fancyinfo_success("推送 Tag 到远程: #{tag_name}")
           else
             Funlog.instance.fancyinfo_success("Tag 已存在且在 HEAD: #{tag_name}")
@@ -386,10 +374,48 @@ module Pindo
 
       # 创建并推送 tag
       Pindo::GitHandler.git!(%W(-C #{project_dir} tag #{tag_name}))
-      Pindo::GitHandler.git_remote!(project_dir, %W(-C #{project_dir} push origin #{tag_name}))
+      push_tag_with_verify(project_dir: project_dir, tag_name: tag_name)
       Funlog.instance.fancyinfo_success("创建并推送 Tag: #{tag_name}")
       tag_name
     end
 
+    # 推送 tag 到远程并校验是否真正推送成功，失败则重试
+    # 校验方式为「远程 tag 指向的 commit == 本地 tag commit」，
+    # 一次 ls-remote 同时覆盖「存在性」与「指向正确性」
+    # @param project_dir [String] 仓库目录
+    # @param tag_name [String] tag 名称
+    # @param max_retries [Integer] 最大重试次数（默认 3）
+    # @return [Boolean] 是否推送成功（失败到达上限会 raise）
+    def push_tag_with_verify(project_dir:, tag_name:, max_retries: 3)
+      local_commit = Pindo::GitHandler.git!(%W(-C #{project_dir} rev-parse #{tag_name}^{commit})).strip
+
+      attempt = 0
+      loop do
+        attempt += 1
+        begin
+          Pindo::GitHandler.git_remote!(project_dir, %W(-C #{project_dir} push origin #{tag_name}))
+        rescue => e
+          first_line = e.message.lines.first&.strip
+          Funlog.instance.fancyinfo_warning("推送 Tag 失败（第 #{attempt}/#{max_retries} 次）: #{first_line}")
+        end
+
+        # 校验远程 tag 指向的 commit 是否与本地一致，确认推送成功
+        remote_commit = Pindo::GitHandler.remote_tag_commit(local_repo_dir: project_dir, tag_name: tag_name)
+        if remote_commit && remote_commit == local_commit
+          Funlog.instance.fancyinfo_success("已确认 Tag 推送到远程: #{tag_name}")
+          return true
+        elsif remote_commit
+          Funlog.instance.fancyinfo_warning("远程 Tag 指向不同 commit（远程 #{remote_commit[0..7]} ≠ 本地 #{local_commit[0..7]}），疑似残留旧 Tag: #{tag_name}")
+        end
+
+        if attempt >= max_retries
+          raise Informative, "Tag 推送失败，已重试 #{max_retries} 次仍未在远程确认: #{tag_name}"
+        end
+
+        Funlog.instance.fancyinfo_update("远程未确认 Tag，#{attempt}s 后重试推送: #{tag_name}")
+        sleep(attempt)
+      end
+    end
+
   end
 end

data/lib/pindo/module/xcode/res/xcode_res_handler.rb

@@ -12,13 +12,13 @@ module Pindo
             @project_obj = Xcodeproj::Project.open(proj_fullname)
         end
 
-        def get_xcodeproj_icon_path()
-
+        # 查找工程的 AppIcon.appiconset 目录，找不到返回 nil（不抛异常）
+        def find_xcodeproj_icon_path()
             icon_path = nil
             select_target = @project_obj.targets.select { |target| target.respond_to?(:product_type) && target.product_type.include?(Xcodeproj::Constants::PRODUCT_TYPE_UTI[:application])  }.first
 
             project_dir = @project_obj.project_dir
-  
+
             if !select_target.nil?
                 file_refs = select_target.resources_build_phase.files_references.select { |file| file.display_name.include?("Assets.xcassets") } || []
                 file_refs.each do |file_ref|
@@ -40,12 +40,33 @@ module Pindo
             end
 
             if icon_path.nil? || icon_path.empty? || !File.exist?(icon_path)
-                raise Informative, "没有找到Xcode icon 目录"
+                return nil
             end
 
             return icon_path
         end
 
+        # 工程是否包含 AppIcon 目录（macOS 命令行工具等无 icon 工程返回 false）
+        def has_app_icon_dir?()
+            !find_xcodeproj_icon_path().nil?
+        end
+
+        # 工程是否为命令行工具（com.apple.product-type.tool）
+        def command_line_tool?()
+            tool_uti = Xcodeproj::Constants::PRODUCT_TYPE_UTI[:command_line_tool]
+            @project_obj.targets.any? do |target|
+                target.respond_to?(:product_type) && !target.product_type.nil? && target.product_type == tool_uti
+            end
+        end
+
+        def get_xcodeproj_icon_path()
+            icon_path = find_xcodeproj_icon_path()
+            if icon_path.nil?
+                raise Informative, "没有找到Xcode icon 目录"
+            end
+            return icon_path
+        end
+
         def install_icon_res(new_icon_dir:nil)
             icon_path = get_xcodeproj_icon_path()
             begin

data/lib/pindo/module/xcode/xcode_build_config.rb

@@ -356,7 +356,7 @@ module Pindo
                 project.save
 
                 if updated_targets.empty?
-                    Funlog.instance.fancyinfo_error("未找到需要更新的application target")
+                    Funlog.instance.fancyinfo_warning("未找到需要更新的application target（如命令行工具工程），跳过版本更新")
                     return false
                 else
                     Funlog.instance.fancyinfo_success("iOS版本更新完成!")
@@ -480,6 +480,12 @@ module Pindo
 
             puts "\n检测到项目 Icon URL: #{icon_url}"
 
+            # 命令行工具且无 AppIcon 目录时跳过 Icon 替换，视为成功
+            if XcodeResHelper.skip_icon_replacement?(proj_dir: project_dir)
+                Funlog.instance.fancyinfo_success("命令行工具工程无 AppIcon 目录，跳过 Icon 替换")
+                return true
+            end
+
             # 创建临时目录（所有 icon 处理都在此目录内完成）
             temp_icon_dir = File.join(project_dir, ".pindo_temp_ios_icon")
             icon_download_path = nil

data/lib/pindo/module/xcode/xcode_build_helper.rb

@@ -699,8 +699,15 @@ module Pindo
             project_build_platform = project_obj.root_object.build_configuration_list.get_setting("SDKROOT")["Release"]
             is_macos = !project_build_platform.nil? && project_build_platform.eql?("macosx")
 
-            # 根据平台查找输出文件
-            if is_macos
+            # 命令行工具（com.apple.product-type.tool）产物为裸可执行文件，而非 .app/.ipa
+            tool_uti = Xcodeproj::Constants::PRODUCT_TYPE_UTI[:command_line_tool]
+            tool_target = project_obj.targets.find { |t| t.respond_to?(:product_type) && t.product_type == tool_uti }
+
+            # 根据工程类型查找输出文件
+            if tool_target
+                output_file = find_command_line_tool_output(build_dir: build_dir, target: tool_target)
+                puts "命令行工具: 查找可执行文件" if output_file
+            elsif is_macos
                 # macOS 平台查找 .app 文件
                 build_path = File.join(build_dir, "*.app")
                 output_file = Dir.glob(build_path).select { |f| File.directory?(f) }.max_by { |f| File.mtime(f) }
@@ -715,6 +722,24 @@ module Pindo
             output_file
         end
 
+        # 查找命令行工具的输出可执行文件
+        # @param build_dir [String] 构建输出目录
+        # @param target [Xcodeproj::Project::Object::PBXNativeTarget] 命令行工具 target
+        # @return [String, nil] 可执行文件路径
+        def find_command_line_tool_output(build_dir:, target:)
+            product_name = target.build_configurations.first.build_settings['PRODUCT_NAME']
+            product_name = target.name if product_name.nil? || product_name.to_s.include?('$(')
+
+            # 优先取 gym 导出到 build 根目录的同名可执行文件
+            candidate = File.join(build_dir, product_name)
+            return candidate if File.file?(candidate)
+
+            # 回退：build 根目录下任意无扩展名的普通文件（排除 .dSYM 等目录）
+            Dir.glob(File.join(build_dir, "*")).find do |f|
+                File.file?(f) && File.extname(f).empty?
+            end
+        end
+
         # 获取 Gym 构建参数
         # @param project_fullname [String] 工程文件完整路径
         # @param icloud_id [String, nil] iCloud ID（可选）
@@ -735,8 +760,15 @@ module Pindo
             project_obj = Xcodeproj::Project.open(project_fullname)
 
             project_build_platform = project_obj.root_object.build_configuration_list.get_setting("SDKROOT")["Release"]
-            main_target = project_obj.targets.select { |target| target.respond_to?(:product_type) && target.product_type.include?(Xcodeproj::Constants::PRODUCT_TYPE_UTI[:application]) }.first
-            provisioning_profile_name = main_target.build_configurations.first.build_settings['PROVISIONING_PROFILE_SPECIFIER'].downcase
+            main_target = project_obj.targets.select { |target| target.respond_to?(:product_type) && !target.product_type.nil? && target.product_type.include?(Xcodeproj::Constants::PRODUCT_TYPE_UTI[:application]) }.first
+            # 命令行工具等无 application target 的工程，回退到第一个可用 native target
+            main_target ||= project_obj.targets.find { |target| target.respond_to?(:product_type) && !target.product_type.nil? }
+            if main_target.nil?
+                raise Informative, "未找到可编译的 target"
+            end
+            # 命令行工具通常无 provisioning profile，做 nil 保护
+            profile_specifier = main_target.build_configurations.first.build_settings['PROVISIONING_PROFILE_SPECIFIER']
+            provisioning_profile_name = profile_specifier.nil? ? "" : profile_specifier.downcase
 
             # 确定构建类型和 iCloud 环境
             build_type = "app-store"

data/lib/pindo/module/xcode/xcode_res_helper.rb

@@ -114,6 +114,14 @@ module Pindo
             end
         end
 
+        # 是否应跳过 Icon 替换：工程既无 AppIcon 目录、又是命令行工具时才跳过
+        def skip_icon_replacement?(proj_dir:nil)
+            xcodeproj_file_name = Dir.glob(File.join(proj_dir, "/*.xcodeproj")).max_by {|f| File.mtime(f)}
+            return false if xcodeproj_file_name.nil?
+            xcodereshandler = XcodeResHandler.new(proj_fullname: xcodeproj_file_name)
+            !xcodereshandler.has_app_icon_dir? && xcodereshandler.command_line_tool?
+        end
+
         def install_icon(proj_dir:nil, new_icon_dir:nil)
             xcodeproj_file_name = Dir.glob(File.join(proj_dir, "/*.xcodeproj")).max_by {|f| File.mtime(f)}
             xcodereshandler = XcodeResHandler.new(proj_fullname: xcodeproj_file_name)

data/lib/pindo/options/helpers/bundleid_selector.rb

@@ -95,17 +95,26 @@ module Pindo
       end
 
       # 加载 all_bundleid_group 映射表
-      # @return [Hash] group_name => bundle_id 的映射，如 {"fancyapptest" => "com.heroneverdie101.fancyapptest"}
+      # @return [Hash, nil] group_name => bundle_id 的映射，如 {"fancyapptest" => "com.heroneverdie101.fancyapptest"}；加载失败返回 nil
       def self.load_bundleid_group
         config_file = File.join(pindo_env_configdir, 'bundleid_config.json')
-        return {} unless File.exist?(config_file)
+        unless File.exist?(config_file)
+          puts "加载 bundleid_config.json 失败: 文件不存在 #{config_file}，请运行 pindo setup 更新配置"
+          return nil
+        end
 
         begin
           config = JSON.parse(File.read(config_file))
-          config['all_bundleid_group'] || {}
+          group = config['all_bundleid_group']
+          unless group.is_a?(Hash) && !group.empty?
+            puts "加载 bundleid_config.json 失败: all_bundleid_group 缺失或为空 #{config_file}，请运行 pindo setup 更新配置"
+            return nil
+          end
+
+          group
         rescue => e
-          puts "加载 bundleid_config.json 失败: #{e.message}"
-          {}
+          puts "加载 bundleid_config.json 失败: #{e.message}，请运行 pindo setup 更新配置"
+          nil
         end
       end
 
@@ -116,7 +125,15 @@ module Pindo
         return nil if group_name.nil? || group_name.empty?
 
         group = load_bundleid_group
-        group[group_name]
+        return nil unless group
+
+        bundle_id = group[group_name]
+        if bundle_id.nil? || bundle_id.empty?
+          puts "解析 Bundle ID 失败: all_bundleid_group 中未找到 #{group_name}，请运行 pindo setup 更新配置"
+          return nil
+        end
+
+        bundle_id
       end
 
       # 获取 pindo 环境配置目录

data/lib/pindo/version.rb

@@ -6,7 +6,7 @@ require 'time'
 
 module Pindo
 
-  VERSION = "5.18.13"
+  VERSION = "5.18.20"
 
   class VersionCheck
     RUBYGEMS_API = 'https://rubygems.org/api/v1/gems/pindo.json'