pindo 5.4.0 → 5.5.0

data/lib/pindo/command/utils/clearcert.rb

@@ -12,8 +12,24 @@ module Pindo
                 self.summary = '清理并且删除本机中所安装的所有iOS证书'
   
                 self.description = <<-DESC
-                    清理并且删除本机中所安装的所有iOS证书
-                DESC
+清理并且删除本机中所安装的所有iOS证书。
+
+支持功能：
+- 扫描系统中的所有代码签名证书
+- 删除Apple Development证书
+- 删除Apple Distribution证书
+- 清理Provisioning Profiles文件夹
+- 自动清理所有相关证书文件
+
+使用示例：
+  # 清理所有iOS证书
+  pindo utils clearcert
+
+注意事项：
+- 该操作不可逆，请谨慎操作
+- 建议在清理前备份重要证书
+- 清理后需要重新下载或安装证书
+DESC
         
 
                 self.arguments = [

data/lib/pindo/command/utils/device.rb

@@ -12,8 +12,25 @@ module Pindo
                 self.summary = '同步开发者账号中测试设备udid'
   
                 self.description = <<-DESC
-                    同步开发者账号中测试设备udid
-                DESC
+同步开发者账号中测试设备udid管理工具。
+
+支持功能：
+- 从开发者账号获取所有设备信息
+- 支持iOS和Mac设备管理
+- 读取本地CSV文件的设备数据
+- 生成多种格式的设备列表
+- 兼容蒲公英平台的设备格式
+- 设备信息统一管理和对比
+
+使用示例：
+  # 同步并生成设备列表
+  pindo utils device
+
+生成文件：
+- new_devices_list.txt - App Store格式的设备列表
+- new_user_devices_list.csv - 用户设备列表
+- new_pgyer_devices_list.csv - 蒲公英格式设备列表
+DESC
 
                 class DeviceItem
                     

data/lib/pindo/command/utils/icon.rb

@@ -18,8 +18,26 @@ module Pindo
                 self.summary = '根据1024*1024icon生成Xcode标准icon文件'
   
                 self.description = <<-DESC
-                  根据1024*1024icon生成Xcode标准icon文件，用法：pindo utils icon path/to/demo.png 
-                DESC
+根据1024*1024像素的原图icon生成Xcode标准icon文件集。
+
+支持功能：
+- 从单个1024x1024像素图片生成全套iOS icon
+- 自动生成各种尺寸的icon文件
+- 支持直接安装到Xcode工程中
+- 使用sips工具进行高质量缩放
+- 自动创建时间戳命名的输出文件夹
+
+使用示例：
+  # 生成icon文件夹
+  pindo utils icon path/to/demo.png
+
+  # 生成并直接安装到Xcode工程
+  pindo utils icon path/to/demo.png --install
+
+注意事项：
+- 输入图片必须为1024x1024像素
+- 支持PNG、JPG等常见图片格式
+DESC
         
 
                 self.arguments = [

data/lib/pindo/command/utils/renewcert.rb

@@ -14,9 +14,34 @@ module Pindo
             self.summary = '更新当前账号下所有的Provisioning Profile文件'
     
             self.description = <<-DESC
-                如果不存在证书,会自动生成新证书，重新生成当前账号下所有的Provisioning Profile文件. 添加新设备或者证书过期时使用, 一般情况请勿操作！！！
-                用法：pindo dev renewcert 
-            DESC
+更新当前账号下所有的Provisioning Profile文件管理工具。
+
+支持功能：
+- 自动检测和生成缺失的证书
+- 重新生成所有Provisioning Profile文件
+- 支持开发、测试、发布等多种证书类型
+- 支持快速模式，只更新必要的证书
+- 自动处理bundle id功能性更新
+- 支持生成上传测试平台的证书
+
+使用示例：
+  # 全量更新所有证书
+  pindo utils renewcert
+
+  # 快速模式，只更新必要的证书
+  pindo utils renewcert --fast
+
+  # 重新生成证书并修复bundle id功能
+  pindo utils renewcert --renew --fixedid
+
+  # 生成上传测试平台的证书
+  pindo utils renewcert --upload
+
+注意事项：
+- 该操作会影响所有相关证书，请谨慎使用
+- 确保已登录Apple Developer账号
+- 建议在添加新设备或证书过期时使用
+DESC
 
             self.arguments = [
 

data/lib/pindo/command/utils/renewproj.rb

@@ -16,8 +16,31 @@ module Pindo
                 self.summary = '重新创建Xcode工程'
         
                 self.description = <<-DESC
-                    重新创建Xcode工程
-                DESC
+重新创建Xcode工程的高级工具。
+
+支持功能：
+- 从现有Xcode工程创建全新的工程
+- 保持原有的文件结构和配置
+- 自动复制源代码和资源文件
+- 重新配置目标和构建设置
+- 支持自定义工程名称
+- 自动处理CocoaPods集成
+
+使用示例：
+  # 使用配置文件中的项目名
+  pindo utils renewproj config.json
+
+  # 指定新的项目名
+  pindo utils renewproj config.json --n="NewProjectName"
+
+  # 仅更新现有工程，不创建新工程
+  pindo utils renewproj config.json --nocreate
+
+注意事项：
+- 操作前请备份原有工程
+- 新工程将会创建在上级目录中
+- 操作完成后需要重新执行pod install
+DESC
     
                 self.arguments = [
                     CLAide::Argument.new('path/to/config.json', true),

data/lib/pindo/command/utils/tgate.rb

@@ -16,9 +16,34 @@ module Pindo
                 self.summary = 'tGate的命令行终端工具'
   
                 self.description = <<-DESC
-                  tGate的命令行终端工具. 用法：查看状态 pindo utils tgate --env=dev --type=device --deviceid=XXX-XX
-                  修改tgate状态，例如设置dev环境当前ip为超白: pindo utils tgate --env=dev --type=ip --status=super_white
-                DESC
+tGate门控系统的命令行管理工具。
+
+支持功能：
+- 查看当前设备在tGate系统中的状态
+- 修改IP地址的白名单/黑名单状态
+- 修改设备的白名单/黑名单状态
+- 支持dev和prod环境切换
+- 支持多种设备标识符（deviceid, idfa, sbsid等）
+- 实时查看门控状态变化
+
+使用示例：
+  # 查看当前设备状态
+  pindo utils tgate --env=dev --type=device --deviceid=XXX-XX
+
+  # 设置IP为超级白名单
+  pindo utils tgate --env=dev --type=ip --status=super_white
+
+  # 设置设备为黑名单
+  pindo utils tgate --env=prod --type=device --status=black --deviceid=ABC-123
+
+  # 恢复正常状态
+  pindo utils tgate --env=dev --type=ip --status=normal
+
+参数说明：
+- env: dev/prod (环境)
+- type: ip/device (类型)
+- status: normal/black/super_white (状态)
+DESC
         
                 self.arguments = [
 

data/lib/pindo/command/utils/xcassets.rb

@@ -10,8 +10,26 @@ module Pindo
                 self.summary = '获取Assets.xcassets中所有图片，并检查是否有缺失图片'
   
                 self.description = <<-DESC
-                    获取Assets.xcassets中所有图片，并检查是否有缺失图片
-                DESC
+获取Assets.xcassets中所有图片资源，并检查是否有缺失图片的工具。
+
+支持功能：
+- 扫描当前目录下Assets.xcassets文件
+- 检查所有图片资源的完整性
+- 识别缺失的@2x、@3x等分辨率图片
+- 检查AppIcon和LaunchImage的完整性
+- 生成详细的检查报告
+- 列出所有图片资源的使用情况
+
+使用示例：
+  # 检查当前工程的图片资源
+  pindo utils xcassets
+
+输出内容：
+- 所有图片资源列表
+- 缺失的图片文件提示
+- 图片资源使用统计
+- 建议的优化方案
+DESC
         
 
                 self.arguments = [

data/lib/pindo/command/web/autobuild.rb

@@ -147,10 +147,25 @@ module Pindo
                         description = nil
                         result_data = PgyerHelper.share_instace.start_upload(app_info_obj:app_info_obj, ipa_file_upload:html_file_upload, description:description)
                         if !result_data.nil? && !result_data["data"].nil? && !result_data["data"]["id"].nil?
-                            msg_data = PgyerHelper.share_instace.make_msg_data(app_info_obj:app_info_obj, app_version_info_obj:result_data["data"])
-                            PgyerHelper.share_instace.print_app_version_info(msg_data:msg_data)
+                            PgyerHelper.share_instace.print_app_version_info(
+                                app_info_obj: app_info_obj,
+                                app_version_info_obj: result_data["data"]
+                            )
                             if @args_send_flag
-                                PgyerHelper.share_instace.send_apptest_wechat_msg(msg_data:msg_data)    
+                                # 始终发送给自己
+                                PgyerHelper.share_instace.send_apptest_msg(
+                                    app_info_obj: app_info_obj,
+                                    app_version_info_obj: result_data["data"],
+                                    receiveType: "self"
+                                )
+
+                                # 额外发送到测试群
+                                PgyerHelper.share_instace.send_apptest_msg(
+                                    app_info_obj: app_info_obj,
+                                    app_version_info_obj: result_data["data"],
+                                    chatEnv: "DevTest",
+                                    receiveType: "chat"
+                                )
                             end
                         end
                     end

data/lib/pindo/command.rb

@@ -42,7 +42,7 @@ module Pindo
         require 'pindo/command/env'
         require 'pindo/command/lib'
         require 'pindo/command/utils'
-        require 'pindo/command/pgyer'
+        require 'pindo/command/jps'
         require 'pindo/command/setup'
         require 'pindo/command/repo'
         require 'pindo/command/ipa'
@@ -74,6 +74,7 @@ module Pindo
 
         DEFAULT_OPTIONS = [
           ['--help',    '查看命令行用法'],
+          ['--verbose', '显示详细的调试信息'],
         ]
 
 
@@ -105,6 +106,10 @@ module Pindo
         def initialize(argv)
             super
             @args_help_flag = argv.flag?('help', false)
+            @args_verbose_flag = argv.flag?('verbose', false)
+
+            # 设置全局 verbose 标志
+            ENV['PINDO_VERBOSE'] = '1' if @args_verbose_flag
 
             # 在非抽象命令初始化时设置上下文
             if !self.class.abstract_command? && !@args_help_flag
@@ -126,7 +131,8 @@ module Pindo
                     # 配置选项
                     cache_enabled_value = self.class.respond_to?(:use_cache?) ? self.class.use_cache? : false
                     options = {
-                        cache_enabled: cache_enabled_value
+                        cache_enabled: cache_enabled_value,
+                        verbose: @args_verbose_flag
                     }
 
                     # 获取项目根目录（Git仓库根目录或当前目录）