cocoapods-tdfire-binary 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4327aaa2c7f9aa393126b8b39558ee07d1910f67
-  data.tar.gz: e5bb43d5aa8db3c817660b5c1b81667a47d2fedb
+  metadata.gz: 7915044a0d73ec21c492c83bb27b87d7d9ea834f
+  data.tar.gz: 5f76e87ee1c80a862f0bffb5093d20637b6f07e9
 SHA512:
-  metadata.gz: 8ab2e1648f66e17a55511cf41dd7233ae440d9f07609672735b90c4deabc12a1dc0d8baec70a81e25c337154cc387122d849aa49041223c434867f2a71e70fb9
-  data.tar.gz: 47a447746ea39b6658746e2f15b6d6a92504ed51153520f504d31fffaddd0bd612f25a2ee971cab6b62be5e63e49a83b0af5934de9c91f419259e609ac1f1717
+  metadata.gz: dac999ec5ab4483d7c64f80f819efefaec0e20e6088e11d47f26f26bd457e43e62603c16aab92f45d9755efe08891077299e2c1223d5e7036c1174240936c362
+  data.tar.gz: d9807ae59b68239a08854b8db1cc54f3cfcaab446588420574bbfc7d96c6e93513ab1b4d01d5231f928112fc0ad83f4fd9ce59952d57b6aace8ec44cb072edc5

data/Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: .
   specs:
-    cocoapods-tdfire-binary (1.2.0)
-      cocoapods (~> 1.2.1)
+    cocoapods-tdfire-binary (1.2.1)
+      cocoapods (~> 1.2)
       cocoapods-packager (~> 1.5.0)
 
 GEM

data/README.md

@@ -2,12 +2,113 @@
 
 <a href="https://travis-ci.org/tripleCC/cocoapods-tdfire-binary"><img src="https://img.shields.io/travis/tripleCC/cocoapods-tdfire-binary/master.svg"></a>
 
-## Installation
+## 安装
 
     $ gem install cocoapods-tdfire-binary
-    
 
-## Usage
+
+
+## 插件目标
+
+
+
+1. 通过提前将组件打包成 static-framework，减少主 App 打包时间
+
+2. 提供源码和二进制依赖切换功能，方便开发调试
+
+3. 尽量减少二进制化的工作量，以及对原发布流程的影响
+
+4. 规避维护两套 podspec 和对应的 tag 
+
+5. 体验尽量贴近 CocoaPods 原生 DSL
+
+   
+
+## 二进制化策略
+
+### 二进制依赖方式
+
+
+
+先了解下 podspec 的 source 字段，它接收一个 Hash，这个 Hash 对象指定了组件的储存地址。我们可以使用 keys 如下：
+
+
+
+```ruby
+:git => :tag, :branch, :commit, :submodules
+:svn => :folder, :tag, :revision
+:hg => :revision
+:http => :flatten, :type, :sha256, :sha1
+```
+
+其中值得注意的有两个 key ，:git 不多说，这里说下 :http。 podspec 允许通过 HTTP 去下载组件代码压缩包，支持 zip, tgz, bz2, txz 和 tar 格式 ：
+
+
+
+```ruby
+spec.source = { :http => 'http://dev.wechatapp.com/download/sdk/WeChat_SDK_iOS_en.zip' }
+```
+
+结合上面对 source 字段的了解，可以解决一个比较关键的问题：二进制文件存在哪。这里的选择不多，“常规”无非两种：
+
+
+
+1. 和源码一样，存在 tag 中
+2. 起一个独立的二进制文件服务器
+
+为什么说 “常规”，因为还有一种“非常规”的选择一一把源码和二进制一起打成 zip ，存在文件服务器上，通过指定 source 为 :http 去下载。当然，由于和 GitLab 本身的 tag 作用冲突，这种方式并不推荐。
+
+接下来比较下“常规”的两种方式。
+
+首先是实现起来较简单第一种，在把 framework 加入 tag 后，只需对 podspec 做如下更改：
+
+
+
+```ruby
+...
+ s.source = { :git => 'git 地址',
+                :tag => s.version.to_s }
+if ENV['use_binary']
+  s.vendored_frameworks = 'framework 的相对路径'
+else
+  s.source_files = '源码文件路径'
+  s.public_header_files = '需要暴露的头文件路径'
+end
+...
+```
+
+
+
+但是考虑到后期产生过多的二进制版本，势必会导致 GitLab 库急剧变大，所以暂时不考虑第一种方式。
+
+第二种，我们可以通过编写如下样式的 podspec 实现：
+
+
+
+```ruby
+...
+if ENV['use_binary']
+  spec.source = { :git => 'git url',
+                :tag => s.version.to_s }
+else
+  spec.source = { :http => 'binary server url' }
+end
+...
+```
+
+
+
+
+
+
+
+## 插件说明
+
+
+
+## 使用
+
+
 
 ```
 
@@ -112,8 +213,8 @@ end
       end
     end
   end
-  ``` 
-   
+  ```
+  
 - tdfire_set_binary_download_configurations
   - 强制设置 static_framework 为 true，规避使用 use_frameworks! 时，动态库依赖链（动态库依赖静态库问题）、影响启动时间问题
   - 设置 preserve_paths，让 cache 保留源码、资源、二进制全部文件

data/cocoapods-tdfire-binary.gemspec

@@ -20,6 +20,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'bundler', '~> 1.3'
   spec.add_development_dependency 'rake', '~> 12.0'
 
-  spec.add_runtime_dependency 'cocoapods', '~> 1.2.1'
+  spec.add_runtime_dependency 'cocoapods', '~> 1.2'
   spec.add_runtime_dependency 'cocoapods-packager', '~> 1.5.0'
 end

data/lib/cocoapods-tdfire-binary/binary_cache_cleaner.rb

@@ -35,12 +35,15 @@ module Pod
       def clean!
         # 判断有效组件的 cache 中是否有二进制，没有的话，删除组件缓存
         specs = use_binary_specs - no_binary_specs
-        specs.each do |s|
-          # 处理 cache
-          clean_pod_cache(s)
-          
-          # 处理 Pods 
-          clean_local_cache(s)
+
+        UI.section 'Tdfire: 处理没有二进制版本的组件' do
+          specs.each do |s|
+            # 处理 cache
+            clean_pod_cache(s)
+            
+            # 处理 Pods 
+            clean_local_cache(s)
+          end
         end
       end
 
@@ -68,7 +71,7 @@ module Pod
         pod_dir = Config.instance.sandbox.pod_dir(spec.root.name)
         framework_file = pod_dir + "#{spec.root.name}.framework"
         if pod_dir.exist? && !framework_file.exist?
-          UI.message "Tdfire: 删除缺少二进制的组件 #{spec.root.name}".yellow
+          UI.message "Tdfire: 删除本地 Pods 目录下缺少二进制的组件 #{spec.root.name}"
 
           # 设置沙盒变动标记，去 cache 中拿
           # 只有 :changed 、:added 两种状态才会重新去 cache 中拿
@@ -92,7 +95,7 @@ module Pod
           slug = d[:slug].dirname + "#{spec.version}-#{spec.checksum[0, 5]}"
           framework_file = slug + "#{spec.root.name}.framework"
           unless (framework_file.exist?)
-            UI.message "Tdfire: 删除缺少二进制的Cache #{spec.root.name}".magenta
+            UI.message "Tdfire: 删除缺少二进制的 Cache #{spec.root.name}"
             begin
               FileUtils.rm(descriptor[:spec_file])
               FileUtils.rm_rf(descriptor[:slug])

data/lib/cocoapods-tdfire-binary/gem_version.rb

@@ -1,3 +1,3 @@
 module CocoapodsTdfireBinary
-  VERSION = "1.2.0"
+  VERSION = "1.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cocoapods-tdfire-binary
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.1
 platform: ruby
 authors:
 - tripleCC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-11 00:00:00.000000000 Z
+date: 2018-05-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.2.1
+        version: '1.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.2.1
+        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: cocoapods-packager
   requirement: !ruby/object:Gem::Requirement