cocoapods-mPaaS 1.0.0

data/lib/cocoapods-mPaaS/localization.rb

@@ -0,0 +1,238 @@
+require 'yaml'
+require 'pathname'
+require 'fileutils' # 用于创建目录
+
+module Pod
+  module MPAAS
+    module Localization
+      @translations = {}
+      @current_language = nil
+      @fallback_language = 'en' # 默认回退语言
+
+      # 用于控制内部调试日志的开关，通过环境变量 MPAAS_DEBUG_LOGS=true 开启
+      def self.internal_verbose?
+        ENV['MPAAS_DEBUG_LOGS'] == 'true'
+      end
+
+      # 定义配置文件的路径
+      def self.config_file_path
+        Pathname.new(Dir.home) + '.cocoapods' + 'mpaas_config.yml'
+      end
+
+      # 加载配置
+      def self.load_config
+        path = config_file_path
+        if path.exist?
+          begin
+            config_data = YAML.load_file(path.to_s) || {}
+            # 内部调试信息，使用 Ruby puts
+            puts "MPAAS (Internal): Loaded config from '#{path}'." if internal_verbose?
+            config_data
+          rescue Psych::SyntaxError => e
+            # 用户可见的警告信息，使用防御性写法
+            (defined?(Pod::UI) ? Pod::UI : Kernel).warn "MPAAS: Failed to parse config file '#{path}': #{e.message}. Using default settings."
+            {}
+          end
+        else
+          puts "MPAAS (Internal): Config file not found at '#{path}'." if internal_verbose?
+          {}
+        end
+      end
+
+      # 保存配置
+      def self.save_config(config_data)
+        path = config_file_path
+        FileUtils.mkdir_p(path.dirname) unless path.dirname.exist? # 确保目录存在
+        File.write(path.to_s, config_data.to_yaml)
+        puts "MPAAS (Internal): Saved config to '#{path}'." if internal_verbose?
+      rescue => e
+        (defined?(Pod::UI) ? Pod::UI : Kernel).warn "MPAAS: Failed to save config to '#{path}': #{e.message}"
+      end
+
+      # -------------------------------------------------------------
+      # 语言检测和映射
+      # -------------------------------------------------------------
+
+      # 尝试获取并规范化系统语言
+      def self.detect_system_language
+        # Use debug logs for tracing language detection
+        puts "find_language_detect: --- Entering detect_system_language method ---" if internal_verbose?
+
+        lang_env = ENV['LANG'] || ENV['LC_ALL'] || ENV['LANGUAGE']
+        puts "find_language_detect: Raw language environment variable: '#{lang_env}'" if internal_verbose?
+
+        if lang_env
+          base_lang = lang_env.split('.').first.split('_').first.downcase
+          puts "find_language_detect: Detected base language: '#{base_lang}'" if internal_verbose?
+
+          case base_lang
+          when 'zh'
+            lang_region = lang_env.split('.').first.split('_').last.downcase
+            puts "find_language_detect: Detected Chinese region: '#{lang_region}'" if internal_verbose?
+
+            # Explicitly choose Simplified Chinese
+            if ['cn', 'hans', 'tw', 'hk', 'hant'].include?(lang_region) # Treat all Chinese variants as Simplified Chinese for now
+              puts "find_language_detect: Normalized Chinese to 'zh-Hans'." if internal_verbose?
+              'zh-Hans'
+            else
+              puts "find_language_detect: Unrecognized Chinese region, defaulting to 'zh-Hans'." if internal_verbose?
+              'zh-Hans' # Default all other Chinese to Simplified Chinese
+            end
+          when 'en'
+            puts "find_language_detect: Detected English: 'en'." if internal_verbose?
+            'en'
+          else
+            # If the detected base language is neither 'zh' nor 'en', default to 'en'
+            puts "find_language_detect: Unsupported base language '#{base_lang}', defaulting to 'en'." if internal_verbose?
+            'en'
+          end
+        else
+          # If no language environment variable is found, default to 'en'
+          puts "find_language_detect: No language environment variable found, defaulting to 'en'." if internal_verbose?
+          'en'
+        end
+      ensure
+        puts "find_language_detect: --- Exiting detect_system_language method ---" if internal_verbose?
+      end
+
+      # -------------------------------------------------------------
+      # 以下是语言加载和设置逻辑
+      # -------------------------------------------------------------
+
+      def self.load_translations(language_code)
+        return if @translations[language_code]
+
+        locales_dir = Pathname.new(__FILE__).dirname + 'locales'
+        file_path = locales_dir + "#{language_code}.yml"
+
+        if file_path.exist?
+          begin
+            @translations[language_code] = YAML.load_file(file_path.to_s)
+            puts "MPAAS (Internal): Loaded translations for '#{language_code}'." if internal_verbose?
+          rescue Psych::SyntaxError => e
+            (defined?(Pod::UI) ? Pod::UI : Kernel).warn "MPAAS: Failed to parse locale file '#{file_path}': #{e.message}"
+            @translations[language_code] = {}
+          end
+        else
+          (defined?(Pod::UI) ? Pod::UI : Kernel).warn "MPAAS: No locale file found for '#{language_code}' at '#{file_path}'."
+          @translations[language_code] = {}
+        end
+      end
+
+      def self.set_language(language_code)
+        normalized_language = language_code.to_s
+
+        if @translations[normalized_language].nil?
+          load_translations(normalized_language)
+        end
+
+        if @translations[normalized_language].nil? || @translations[normalized_language][normalized_language].nil?
+          (defined?(Pod::UI) ? Pod::UI : Kernel).warn "MPAAS: Language '#{language_code}' not fully supported, falling back to '#{@fallback_language}'."
+          load_translations(@fallback_language) unless @translations[@fallback_language]
+          @current_language = @fallback_language
+        else
+          @current_language = normalized_language
+        end
+
+        config = load_config
+        config['language'] = @current_language
+        save_config(config)
+
+        # 这里的日志可以根据需要决定是否也使用 internal_verbose?
+        # 如果你希望用户在 --verbose 模式下也能看到这个确认信息，那就用 Pod::UI.puts
+        # 否则就用 puts internal_verbose?
+        # 这里我暂时保持为 internal_verbose?
+        puts "MPAAS (Internal): Current plugin language set to '#{@current_language}'." if internal_verbose?
+      end
+
+      def self.current_language
+        return @current_language if @current_language
+
+        config = load_config
+        saved_language = config['language']
+        return saved_language if saved_language && !saved_language.empty?
+
+        system_language = detect_system_language
+        return system_language if system_language
+
+        @fallback_language
+      end
+
+      # 查找本地化字符串的核心方法
+      def self.t(key, **options)
+        puts "find_language_path: --- 进入 t 方法 ---" if internal_verbose?
+        puts "find_language_path: 接收到的键 (key): '#{key}'" if internal_verbose?
+        puts "find_language_path: 接收到的选项 (options): #{options.inspect}" if internal_verbose?
+
+        path_elements = key.to_s.split('.')
+        puts "find_language_path: 从键中解析出的路径元素: #{path_elements.inspect}" if internal_verbose?
+
+        actual_current_lang = current_language
+        puts "find_language_path: 确定的实际当前语言: '#{actual_current_lang}'" if internal_verbose?
+
+        # 获取当前语言或回退语言的原始已加载翻译数据
+        loaded_translations_for_lang = @translations[actual_current_lang]
+        if loaded_translations_for_lang.nil? # 如果当前语言未加载，尝试回退语言
+          puts "find_language_path: '#{actual_current_lang}' 的翻译未直接加载。尝试回退语言。" if internal_verbose?
+          loaded_translations_for_lang = @translations[@fallback_language]
+        end
+
+        # --- 关键修复在这里 ---
+        # 'en:' 或 'zh-Hans:' 这样的键是加载的 YAML 文件的根。
+        # 我们需要进入这个键内部，才能获取实际用于查找的内容。
+        if loaded_translations_for_lang.is_a?(Hash) && loaded_translations_for_lang.key?(actual_current_lang)
+          current_hash = loaded_translations_for_lang[actual_current_lang]
+          puts "find_language_path: 初始查找哈希设置为 '#{actual_current_lang}' 键的内容: #{current_hash.inspect[0..100]}..." if internal_verbose?
+        elsif loaded_translations_for_lang.is_a?(Hash) && loaded_translations_for_lang.key?(@fallback_language) && actual_current_lang != @fallback_language # 如果使用了回退语言且它也有自己的根键
+          current_hash = loaded_translations_for_lang[@fallback_language]
+          puts "find_language_path: 初始查找哈希设置为回退语言 '#{@fallback_language}' 键的内容: #{current_hash.inspect[0..100]}..." if internal_verbose?
+        else # 如果无论如何都找不到有效的根语言键
+          puts "find_language_path: !!! 错误: 在加载的翻译中，找不到 '#{actual_current_lang}' 或回退语言的有效根语言键。" if internal_verbose?
+          (defined?(Pod::UI) ? Pod::UI : Kernel).warn "MPAAS: 在加载的翻译中，找不到 '#{key}' 的有效根语言键。"
+          return "MISSING_TRANSLATION_ROOT_#{key}" # 添加一个更明确的错误提示
+        end
+        # --- 关键修复结束 ---
+
+
+        path_elements.each_with_index do |elem, index|
+          puts "find_language_path: 级别 #{index + 1}: 查找元素 '#{elem}'" if internal_verbose?
+          if current_hash.is_a?(Hash) && current_hash.key?(elem)
+            current_hash = current_hash[elem]
+            puts "find_language_path: 找到元素 '#{elem}'。当前哈希/值: #{current_hash.inspect[0..100]}..." if internal_verbose?
+          else
+            # 调试输出：找不到键时的详细信息
+            puts "find_language_path: !!! 错误: 在此级别未找到键元素 '#{elem}'。" if internal_verbose?
+            puts "find_language_path: !!! 查找失败时的当前哈希: #{current_hash.inspect}" if internal_verbose?
+            puts "find_language_path: !!! 完整的键查找路径: '#{key}'" if internal_verbose?
+
+            (defined?(Pod::UI) ? Pod::UI : Kernel).warn "MPAAS: 语言 '#{actual_current_lang}' 缺少翻译键 '#{key}'。"
+            return "MISSING_TRANSLATION_#{key}"
+          end
+        end
+
+        # 调试输出：最终找到的值
+        puts "find_language_path: 为键 '#{key}' 找到的最终值: #{current_hash.inspect}" if internal_verbose?
+
+        if current_hash.is_a?(String)
+          begin
+            result = sprintf(current_hash, options)
+            puts "find_language_path: 成功插值字符串: '#{result}'" if internal_verbose?
+            result
+          rescue ArgumentError => e
+            # 调试输出：sprintf 错误
+            puts "find_language_path: !!! 错误: 键 '#{key}' 的 sprintf 插值失败。错误: #{e.message}" if internal_verbose?
+            (defined?(Pod::UI) ? Pod::UI : Kernel).warn "MPAAS: 翻译 '#{key}' 的插值失败。错误: #{e.message}"
+            current_hash # 返回原始字符串，作为备用
+          end
+        else
+          # 调试输出：翻译类型错误
+          puts "find_language_path: !!! 错误: 键 '#{key}' 的翻译不是字符串。类型: #{current_hash.class}" if internal_verbose?
+          (defined?(Pod::UI) ? Pod::UI : Kernel).warn "MPAAS: 翻译 '#{key}' 不是字符串。"
+          "INVALID_TRANSLATION_TYPE_#{key}"
+        end
+      ensure
+        puts "find_language_path: --- 退出 t 方法 ---" if internal_verbose?
+      end
+    end
+  end
+end

data/lib/cocoapods-mPaaS/logTools.rb

@@ -0,0 +1,67 @@
+module LogTools
+  class << self
+    include Pod::Config::Mixin
+
+    # 默认都输出
+    def p(message)
+      p_(message, "", "")
+    end
+
+    def p_green(message)
+      p_(message, "", "g")
+    end
+
+    def p_red(message)
+      p_(message, "", "r")
+    end
+
+    def p_yellow(message)
+      p_(message, "", "y")
+    end
+
+    # 只有verbose下才输出
+    def v(message)
+      p_(message, "v", "")
+    end
+
+    def v_green(message)
+      p_(message, "v", "g")
+    end
+
+    def v_red(message)
+      p_(message, "v", "r")
+    end
+
+    def v_yellow(message)
+      p_(message, "v", "y")
+    end
+
+    def verbose?
+      return config.verbose?
+    end
+
+    private
+
+    def p_(messages, mode, color)
+      if mode == "v"
+        if config.verbose?
+          p_color(messages, color)
+        end
+      else
+        p_color(messages, color)
+      end
+    end
+
+    def p_color(messages, color)
+      if color == "g"
+        Pod::UI.puts messages.green
+      elsif color == "r"
+        Pod::UI.puts messages.red
+      elsif color == "y"
+        Pod::UI.puts messages.yellow
+      else
+        Pod::UI.puts messages
+      end
+    end
+  end
+end

data/lib/cocoapods-mPaaS/mPaaSPodfile.rb

@@ -0,0 +1,117 @@
+require 'cocoapods-mPaaS/localization'
+class MPaaSPodfile
+  attr_accessor :mPaaSPodNames
+  attr_accessor :mPaaSBaseline
+  attr_accessor :mPaaSPodVersion
+  attr_accessor :mPaaSVersionCode
+  attr_accessor :localComponentJsonPath
+  attr_accessor :localContentJsonPath
+  attr_accessor :localContentJsonFallback
+  attr_accessor :mpaasRepoUrl
+
+  def initialize
+    self.mPaaSPodNames = []
+    self.mPaaSBaseline = nil
+    self.mPaaSPodVersion = nil
+    self.mPaaSVersionCode = nil
+    self.localComponentJsonPath = nil
+    self.localContentJsonPath = nil
+    self.localContentJsonFallback = false
+    self.mpaasRepoUrl = nil
+  end
+
+  def mPaaS_pod(name, version_str = nil)
+    self.mPaaSPodNames << name
+    self.mPaaSPodVersion ||= version_str if version_str
+  end
+
+  def mPaaS_baseline(baseline)
+    self.mPaaSBaseline = baseline
+  end
+
+  def mPaaS_version_code(version_code)
+    self.mPaaSVersionCode = version_code
+  end
+
+  def mPaaS_local_component_json(path)
+    self.localComponentJsonPath = path
+  end
+
+  def mPaaS_local_content_json(path, fallback = false)
+    self.localContentJsonPath = path
+    self.localContentJsonFallback = fallback
+  end
+
+  def mPaaS_repo_url(url)
+    self.mpaasRepoUrl = url
+  end
+
+  def run(path)
+    LogTools.v "MPaaSPodfile Parsing (Regex mode): #{path}"
+
+    proxy_evaluator = Object.new
+    proxy_evaluator.instance_variable_set(:@mpaas_parser_instance, self)
+
+    proxy_evaluator.define_singleton_method(:mPaaS_pod) do |name, *version|
+      @mpaas_parser_instance.mPaaS_pod(name, version.first)
+    end
+    proxy_evaluator.define_singleton_method(:mPaaS_baseline) do |baseline|
+      @mpaas_parser_instance.mPaaS_baseline(baseline)
+    end
+    proxy_evaluator.define_singleton_method(:mPaaS_version_code) do |version_code|
+      @mpaas_parser_instance.mPaaS_version_code(version_code)
+    end
+    proxy_evaluator.define_singleton_method(:mPaaS_local_component_json) do |path|
+      @mpaas_parser_instance.mPaaS_local_component_json(path)
+    end
+    proxy_evaluator.define_singleton_method(:mPaaS_local_content_json) do |path, fallback = false|
+      @mpaas_parser_instance.mPaaS_local_content_json(path, fallback)
+    end
+    proxy_evaluator.define_singleton_method(:mPaaS_repo_url) do |url|
+      @mpaas_parser_instance.mPaaS_repo_url(url)
+    end
+
+    mpaas_pod_regex = /^\s*mPaaS_pod\s+['"]([^'"]+)['"](?:\s*,\s*['"]([^'"]+)['"])?\s*(?:#.*)?\s*$/
+    mpaas_baseline_regex = /^\s*mPaaS_baseline\s+['"]([^'"]+)['"]\s*(?:#.*)?\s*$/
+    mpaas_version_code_regex = /^\s*mPaaS_version_code\s+(\d+)\s*(?:#.*)?\s*$/
+    mpaas_local_component_regex = /^\s*mPaaS_local_component_json\s+['"]([^'"]+)['"]\s*(?:#.*)?\s*$/
+    mpaas_local_content_regex   = /^\s*mPaaS_local_content_json\s+['"]([^'"]+)['"](?:\s*,\s*(true|false))?\s*(?:#.*)?\s*$/
+    mpaas_repo_url_regex        = /^\s*mPaaS_repo_url\s+['"]([^'"]+)['"]\s*(?:#.*)?\s*$/
+
+    File.foreach(path) do |line|
+      if (match = line.match(mpaas_pod_regex))
+        pod_name = match[1]
+        pod_version = match[2]
+        proxy_evaluator.mPaaS_pod(pod_name, pod_version)
+        LogTools.v "Extracted mPaaS_pod: #{pod_name}, version: #{pod_version}"
+      elsif (match = line.match(mpaas_baseline_regex))
+        baseline = match[1]
+        proxy_evaluator.mPaaS_baseline(baseline)
+        LogTools.v "Extracted mPaaS_baseline: #{baseline}"
+      elsif (match = line.match(mpaas_version_code_regex))
+        version_code = match[1].to_i
+        proxy_evaluator.mPaaS_version_code(version_code)
+        LogTools.v "Extracted mPaaS_version_code: #{version_code}"
+      elsif (match = line.match(mpaas_local_component_regex))
+        proxy_evaluator.mPaaS_local_component_json(match[1])
+        LogTools.v "Extracted mPaaS_local_component_json: #{match[1]}"
+      elsif (match = line.match(mpaas_local_content_regex))
+        fallback = match[2] == 'true'
+        proxy_evaluator.mPaaS_local_content_json(match[1], fallback)
+        LogTools.v "Extracted mPaaS_local_content_json: #{match[1]}, fallback: #{fallback}"
+      elsif (match = line.match(mpaas_repo_url_regex))
+        proxy_evaluator.mPaaS_repo_url(match[1])
+        LogTools.v "Extracted mPaaS_repo_url: #{match[1]}"
+      end
+    end
+
+    LogTools.v "Final mPaaSPodNames: #{self.mPaaSPodNames.inspect}"
+    LogTools.v "Final mPaaSBaseline: #{self.mPaaSBaseline}"
+    LogTools.v "Final mPaaSPodVersion: #{self.mPaaSPodVersion}"
+    LogTools.v "Final mPaaSVersionCode: #{self.mPaaSVersionCode}"
+
+  rescue Exception => e
+    LogTools.p_yellow Pod::MPAAS::Localization.t('mpaas.podfile.execute_error', message: e.message)
+    LogTools.p_yellow Pod::MPAAS::Localization.t('mpaas.podfile.error_stack_trace', backtrace: e.backtrace.join("\n"))
+  end
+end