DYXCFrameworkBuilder 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1af6467d63380ea871464c1a7787ccd9ebb765980a10f51de31f5171c1f6aa5e
+  data.tar.gz: 5a07af622ede9668a273afc49def2561cea4b5167e65df5f72ab6d3582eb7501
+SHA512:
+  metadata.gz: 97f166e726f7f9d01f26225424c2c525623b6921c19294745ffc5c675b4386de323446c12a9116ad82a6f3d9b812244bd766bde70db4e18da9ecc11565a7a470
+  data.tar.gz: 790ce39b20ef473c2158561e48c0fa02f76fe74c7c433e811075b69e1721b4ed818381a9825fb93d8d4788142afd7f0d88254e8472546af08fd196af0916f4c7

data/.idea/.gitignore

@@ -0,0 +1,8 @@
+# 默认忽略的文件
+/shelf/
+/workspace.xml
+# 基于编辑器的 HTTP 客户端请求
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

data/.idea/DYXCFrameworkBuilder.iml

@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="ModuleRunConfigurationManager">
+    <shared />
+  </component>
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/features" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
+    </content>
+    <orderEntry type="jdk" jdkName="RVM: ruby-3.2.0" jdkType="RUBY_SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="CFPropertyList (v3.0.7, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="activesupport (v6.1.7.10, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="addressable (v2.8.7, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="algoliasearch (v1.27.5, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="aliyun-sdk (v0.8.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="atomos (v0.1.3, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="base64 (v0.2.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.1.4, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="claide (v1.1.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="cocoapods (v1.11.3, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="cocoapods-core (v1.11.3, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="cocoapods-deintegrate (v1.0.5, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="cocoapods-downloader (v1.6.3, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="cocoapods-plugins (v1.0.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="cocoapods-project-gen (v0.2.5, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="cocoapods-search (v1.0.1, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="cocoapods-trunk (v1.6.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="cocoapods-try (v1.2.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="colored2 (v3.1.2, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="concurrent-ruby (v1.3.5, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="date (v3.4.1, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="domain_name (v0.6.20240107, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="escape (v0.0.4, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ethon (v0.16.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ffi (v1.17.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="fourflusher (v2.3.1, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="fuzzy_match (v2.0.4, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="gh_inspector (v1.1.3, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="http-accept (v1.7.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="http-cookie (v1.0.8, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="httpclient (v2.8.3, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="i18n (v1.14.6, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="json (v2.7.2, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="logger (v1.7.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="mime-types (v3.7.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="mime-types-data (v3.2025.0805, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="mini_portile2 (v2.8.9, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="minitest (v5.25.1, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="molinillo (v0.8.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="nanaimo (v0.4.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="nap (v1.1.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="netrc (v0.11.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="nkf (v0.2.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="nokogiri (v1.18.9, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="psych (v5.2.6, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="public_suffix (v4.0.7, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="racc (v1.8.1, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rake (v13.0.1, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rest-client (v2.1.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rexml (v3.3.8, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ruby-macho (v2.5.1, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubyzip (v2.3.2, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="stringio (v3.1.7, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="typhoeus (v1.4.1, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="tzinfo (v2.0.6, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="xcodeproj (v1.27.0, RVM: ruby-3.2.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="zeitwerk (v2.6.13, RVM: ruby-3.2.0) [gem]" level="application" />
+  </component>
+</module>

data/.idea/misc.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" project-jdk-name="RVM: ruby-2.7.2 [global]" project-jdk-type="RUBY_SDK" />
+</project>

data/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/DYXCFrameworkBuilder.iml" filepath="$PROJECT_DIR$/.idea/DYXCFrameworkBuilder.iml" />
+    </modules>
+  </component>
+</project>

data/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

data/ARCHITECTURE.md

@@ -0,0 +1,163 @@
+# DYXCFrameworkBuilder 架构说明
+
+## 项目结构
+
+```
+DYXCFrameworkBuilder/
+├── lib/
+│   ├── DYXCFrameworkBuilder.rb           # 主入口点，提供向后兼容的API
+│   └── DYXCFrameworkBuilder/
+│       ├── version.rb                    # 版本信息
+│       ├── config.rb                     # YAML配置解析器
+│       ├── builder.rb                    # 主构建器门面类
+│       ├── xcframework_builder.rb        # 核心XCFramework构建逻辑
+│       ├── podspec_parser.rb             # .podspec文件解析器
+│       ├── yaml_generator.rb             # YAML配置文件生成器
+│       ├── framework_podspec_generator.rb # 框架发布用podspec生成器
+│       └── framework_publisher.rb        # 私有仓库发布器
+├── bin/
+│   └── builder                          # 命令行入口点
+└── README.md                            # 使用说明
+```
+
+## 类结构和职责
+
+### 1. `DYXCFrameworkBuilder::XCFrameworkBuilder` (主入口)
+- **位置**: `lib/DYXCFrameworkBuilder.rb`
+- **职责**: 提供向后兼容的API，委托给Builder类
+- **方法**:
+  - `initialize(options)` - 初始化，创建Builder实例
+  - `build()` - 执行构建，委托给Builder
+  - `self.create_config_template(path)` - 创建配置模板
+
+### 2. `DYXCFrameworkBuilder::Builder` (构建协调器)
+- **位置**: `lib/DYXCFrameworkBuilder/builder.rb`
+- **职责**: 协调整个构建过程，处理配置加载和构建策略选择
+- **方法**:
+  - `initialize(options)` - 加载配置
+  - `build()` - 根据配置类型选择构建策略
+  - `load_configuration()` - 加载YAML配置或创建简单配置
+  - `build_from_config()` - 使用配置文件构建
+  - `build_from_options()` - 使用命令行参数构建（向后兼容）
+
+### 3. `DYXCFrameworkBuilder::Config` (配置解析器)
+- **位置**: `lib/DYXCFrameworkBuilder/config.rb`
+- **职责**: 解析和验证YAML配置文件
+- **方法**:
+  - `initialize(yaml_path)` - 从YAML文件加载配置
+  - `self.create_template(path)` - 创建配置文件模板
+  - `parse_config(config)` - 解析配置数据
+  - `validate_config()` - 验证配置有效性
+
+### 4. `DYXCFrameworkBuilder::CoreBuilder` (核心构建器)
+- **位置**: `lib/DYXCFrameworkBuilder/xcframework_builder.rb`
+- **职责**: 包含所有核心XCFramework构建逻辑
+- **主要方法**:
+  - `build()` - 主构建流程
+  - `build_for_platform(sdk, platform_config)` - 为特定平台构建
+  - `build_archive_command()` - 生成xcodebuild命令
+  - `create_framework_from_archives()` - 从archive创建framework
+  - `create_universal_framework()` - 创建通用二进制
+  - `create_xcframework()` - 创建最终的XCFramework
+  - `find_framework_in_archive()` - 在archive中查找framework
+
+### 5. `DYXCFrameworkBuilder::SimpleConfig` (简单配置)
+- **位置**: `lib/DYXCFrameworkBuilder/builder.rb`
+- **职责**: 为命令行参数提供配置对象，保持向后兼容
+- **特点**: 提供默认的平台配置，简化直接参数使用
+
+### 6. `DYXCFrameworkBuilder::PodspecParser` (Podspec解析器)
+- **位置**: `lib/DYXCFrameworkBuilder/podspec_parser.rb`
+- **职责**: 解析.podspec文件，提取构建所需的信息
+- **方法**:
+  - `initialize(podspec_path)` - 初始化并解析podspec文件
+  - `find_workspace_path()` - 在Example目录中查找workspace文件
+  - `to_yaml_config()` - 生成YAML配置数据结构
+
+### 7. `DYXCFrameworkBuilder::YamlGenerator` (YAML生成器)
+- **位置**: `lib/DYXCFrameworkBuilder/yaml_generator.rb`
+- **职责**: 根据podspec解析结果生成YAML配置文件
+- **方法**:
+  - `generate(custom_output_path)` - 生成YAML文件
+  - `self.generate_from_podspec(podspec_path, output_path)` - 静态方法，一步完成解析和生成
+
+## 数据流
+
+```
+命令行/API调用
+    ↓
+XCFrameworkBuilder (主入口)
+    ↓
+Builder (协调器)
+    ↓
+Config (配置解析) ←→ YAML文件
+    ↓
+CoreBuilder (核心构建器)
+    ↓
+xcodebuild命令执行
+    ↓
+.xcframework文件
+```
+
+## 核心构建流程
+
+1. **配置加载**: 从YAML文件或命令行参数加载配置
+2. **平台构建**: 为每个目标平台（iOS设备、模拟器）构建framework
+   - 为每个架构创建archive
+   - 从archive提取framework
+   - 如果有多个架构，创建通用二进制
+3. **XCFramework创建**: 使用xcodebuild将所有platform framework合并为XCFramework
+4. **清理**: 删除中间文件，保留最终的.xcframework
+
+## 特性
+
+- ✅ **模块化设计**: 每个类都有明确的职责
+- ✅ **可扩展**: 容易添加新平台或构建选项
+- ✅ **错误处理**: 完整的错误处理和日志记录
+- ✅ **向后兼容**: 保持原有API不变
+- ✅ **配置驱动**: 支持YAML配置文件和命令行参数
+- ✅ **智能项目支持**: 自动识别.xcworkspace和.xcodeproj文件
+- ✅ **跳过警告**: 自动配置编译器跳过警告
+- ✅ **多架构支持**: 支持通用二进制创建
+
+## 扩展点
+
+## 🎉 新增功能: Podspec集成
+
+从版本更新后，工具新增了从`.podspec`文件自动生成配置的功能：
+
+### 特性
+- ✅ **自动解析**: 从podspec文件提取name、version、deployment_target等信息
+- ✅ **智能查找**: 自动在Example/目录下查找.xcworkspace文件
+- ✅ **一键生成**: 生成完整的YAML配置文件，无需手动编写
+- ✅ **同级输出**: 配置文件生成在podspec文件同级目录
+- ✅ **元数据追踪**: 在配置中保存podspec来源信息
+
+### 使用方法
+```bash
+# 从podspec生成配置文件
+bundle exec builder --from-podspec MyLibrary.podspec
+
+# 然后直接使用生成的配置构建
+bundle exec builder -f build_config.yml -v
+```
+
+### 目录结构要求
+```
+MyLibrary.podspec           # 源podspec文件
+Example/
+├── MyLibrary.xcworkspace   # 工具会自动查找这个文件
+└── ...
+build_config.yml           # 自动生成的配置文件
+build/                      # 构建输出目录
+└── MyLibrary.xcframework   # 最终输出的xcframework
+```
+
+## 扩展点
+
+如果需要添加新功能，可以在以下位置扩展：
+
+1. **新平台支持**: 在`CoreBuilder#build_for_platform`中添加新的SDK处理
+2. **新配置选项**: 在`Config`类中添加新的配置字段
+3. **构建后处理**: 在`CoreBuilder#create_xcframework`后添加处理步骤
+4. **自定义构建命令**: 修改`build_archive_command`方法 

data/Gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in DYXCFrameworkBuilder.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+gem 'cocoapods-project-gen'
+gem 'aliyun-sdk'

data/Gemfile.lock

@@ -0,0 +1,143 @@
+PATH
+  remote: .
+  specs:
+    DYXCFrameworkBuilder (0.1.0)
+      aliyun-sdk (~> 0.8.0)
+      psych (~> 5.0)
+      rubyzip (~> 2.3)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    CFPropertyList (3.0.7)
+      base64
+      nkf
+      rexml
+    activesupport (6.1.7.10)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    algoliasearch (1.27.5)
+      httpclient (~> 2.8, >= 2.8.3)
+      json (>= 1.5.1)
+    aliyun-sdk (0.8.0)
+      nokogiri (~> 1.6)
+      rest-client (~> 2.0)
+    atomos (0.1.3)
+    base64 (0.2.0)
+    claide (1.1.0)
+    cocoapods (1.11.3)
+      addressable (~> 2.8)
+      claide (>= 1.0.2, < 2.0)
+      cocoapods-core (= 1.11.3)
+      cocoapods-deintegrate (>= 1.0.3, < 2.0)
+      cocoapods-downloader (>= 1.4.0, < 2.0)
+      cocoapods-plugins (>= 1.0.0, < 2.0)
+      cocoapods-search (>= 1.0.0, < 2.0)
+      cocoapods-trunk (>= 1.4.0, < 2.0)
+      cocoapods-try (>= 1.1.0, < 2.0)
+      colored2 (~> 3.1)
+      escape (~> 0.0.4)
+      fourflusher (>= 2.3.0, < 3.0)
+      gh_inspector (~> 1.0)
+      molinillo (~> 0.8.0)
+      nap (~> 1.0)
+      ruby-macho (>= 1.0, < 3.0)
+      xcodeproj (>= 1.21.0, < 2.0)
+    cocoapods-core (1.11.3)
+      activesupport (>= 5.0, < 7)
+      addressable (~> 2.8)
+      algoliasearch (~> 1.0)
+      concurrent-ruby (~> 1.1)
+      fuzzy_match (~> 2.0.4)
+      nap (~> 1.0)
+      netrc (~> 0.11)
+      public_suffix (~> 4.0)
+      typhoeus (~> 1.0)
+    cocoapods-deintegrate (1.0.5)
+    cocoapods-downloader (1.6.3)
+    cocoapods-plugins (1.0.0)
+      nap
+    cocoapods-project-gen (0.2.5)
+      cocoapods (~> 1.11.3)
+    cocoapods-search (1.0.1)
+    cocoapods-trunk (1.6.0)
+      nap (>= 0.8, < 2.0)
+      netrc (~> 0.11)
+    cocoapods-try (1.2.0)
+    colored2 (3.1.2)
+    concurrent-ruby (1.3.5)
+    date (3.4.1)
+    domain_name (0.6.20240107)
+    escape (0.0.4)
+    ethon (0.16.0)
+      ffi (>= 1.15.0)
+    ffi (1.17.0)
+    fourflusher (2.3.1)
+    fuzzy_match (2.0.4)
+    gh_inspector (1.1.3)
+    http-accept (1.7.0)
+    http-cookie (1.0.8)
+      domain_name (~> 0.5)
+    httpclient (2.8.3)
+    i18n (1.14.6)
+      concurrent-ruby (~> 1.0)
+    json (2.7.2)
+    logger (1.7.0)
+    mime-types (3.7.0)
+      logger
+      mime-types-data (~> 3.2025, >= 3.2025.0507)
+    mime-types-data (3.2025.0805)
+    mini_portile2 (2.8.9)
+    minitest (5.25.1)
+    molinillo (0.8.0)
+    nanaimo (0.4.0)
+    nap (1.1.0)
+    netrc (0.11.0)
+    nkf (0.2.0)
+    nokogiri (1.18.9)
+      mini_portile2 (~> 2.8.2)
+      racc (~> 1.4)
+    psych (5.2.6)
+      date
+      stringio
+    public_suffix (4.0.7)
+    racc (1.8.1)
+    rake (13.0.1)
+    rest-client (2.1.0)
+      http-accept (>= 1.7.0, < 2.0)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 4.0)
+      netrc (~> 0.8)
+    rexml (3.3.8)
+    ruby-macho (2.5.1)
+    rubyzip (2.3.2)
+    stringio (3.1.7)
+    typhoeus (1.4.1)
+      ethon (>= 0.9.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    xcodeproj (1.27.0)
+      CFPropertyList (>= 2.3.3, < 4.0)
+      atomos (~> 0.1.3)
+      claide (>= 1.0.2, < 2.0)
+      colored2 (~> 3.1)
+      nanaimo (~> 0.4.0)
+      rexml (>= 3.3.6, < 4.0)
+    zeitwerk (2.6.13)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  DYXCFrameworkBuilder!
+  aliyun-sdk
+  cocoapods-project-gen
+  rake (~> 13.0)
+
+BUNDLED WITH
+   2.1.4