开始
CocoaPods Plugins 是一个Ruby gem，你需要安装Ruby和CocoaPods来为你的插件开发做准备。
要开始开发一个新的插件，你还需要安装cocoapods-plugins :
gem install cocoapods-plugins
为了演示和调试的目的，我们要先创建一个xcode工程，并且在其根目录下执行
git init
pod init
将其初始化为一个git仓库，以及添加Podfile到该工程
创建CocoaPods Plugins
运行下面的命令就可以生成一个插件模板工程
pod plugins create githooks
工程目录是这样的
插件工程目录
.gemspec文件是插件的主要配置文件。所有的spec字段都是自描述的(你可以查看我们的gemspec)，但是我想指出一件事:
默认情况下，spec.files是指向git仓库并引用其中的文件。但是如果您试图在git仓库中没有文件(还未进行版本控制)时构建gem，您将得到一个空的.gem文件，同时会没有任何警告或错误。我的建议是现在就将spec.files的值设置为Dir[' lib/*/ ']，它将引用lib目录下的所有文件。
替换其中spec.files这一行为
spec.files = Dir['lib/**/*']
Gemfile会包含所需的全部gem依赖。查看Bundle Doc 以获得更多信息
Rakefile包含测试所需要的引用，spec文件夹包含测试用例。有关Rake的更多信息，请访问官方Rake repo。
我们现在还不需要更改Gemfile和Rakefile，所以保持其原样。
lib是我们要使用的主文件夹。它包含构建.gem的所有ruby文件。
为了确保一切设置正确，运行下面的的命令:
gem build cocoapods-githooks.gemspec
你将看到'Successfully built RubyGem'的成功消息，同时Cocoapods-githooks-0.0.1.gem 也将会出现在目录之下
实现插件
Cocoapods-githooks这个插件我们只需要它做一件简单的事情：将项目的.git-hooks目录中的所有文件复制到.git/hooks/目录中，并在每次运行podinstall、pod update 或 pod githooks时执行这个操作。
为了实现这一点，我们将创建一个执行文件操作的类，并将其链接到 pre-install和post-install这两个CocoaPods钩子以及githooks命令。
在/lib/cocoapods-githooks中创建githooks-sync.rb文件
Require'cocoapods'和“fileutils”模块，并在CocoapodsGitHooks模块中使用同步方法创建GitHooksSync类。
require 'cocoapods'
require 'fileutils'
module CocoapodsGitHooks
class GitHooksSync
def sync
end
end
end
在复制git-hook之前，我们需要检查一些事情:
确保我们在git仓库中
确保.git-hooks目录存在
确保.git-hooks目录不是空的
我们可以通过在sync方法的开头添加下面的条件语句来实现这一点:
if !File.directory?(".git")
Pod::UI.puts "Git repository not found"
return
end
if !File.directory?(".git-hooks")
Pod::UI.puts ".git-hooks directory not found, nothing to sync"
return
end
if Dir['.git-hooks/*'].empty?
Pod::UI.puts ".git-hooks directory is empty, nothing to sync"
return
end
在这之后，我们检查hooks目录是否存在于.git中，如果不存在，创建它:
if !File.directory?(".git/hooks")
FileUtils.mkdir ".git/hooks"
end
现在我们准备将钩子从.git-hooks复制到.git/hooks:
FileUtils.cp_r(“.git-hooks/.”, “.git/hooks/”)
下一步是删除shell脚本文件扩展名(如果存在)使文件可执行:
path = ".git/hooks/"
Dir.open(path).each do |p|
filename = File.basename(p, File.extname(p))
if File.extname(p) == ".sh"
FileUtils.mv("#{path}/#{p}", "#{path}/#{filename}")
end
FileUtils.chmod("+x", "#{path}/#{filename}")
end
我们还添加了两个UI.puts 在同步方法的开始和结束处显示具有同步状态的系统通知。如果你遵循了上面所有的步骤，您得到的githook -sync.rb文件看起来如下所示:
require 'cocoapods'
require 'fileutils'
module CocoapodsGitHooks
class GitHooksSync
def sync
Pod::UI.puts "Synchronizing git hooks"
if !File.directory?(".git")
Pod::UI.puts "Git repository not found"
return
end
if !File.directory?(".git-hooks")
Pod::UI.puts ".git-hooks folder not found, nothing to sync"
return
end
if Dir['.git-hooks/*'].empty?
Pod::UI.puts ".git-hooks folder is empty, nothing to sync"
return
end
if !File.directory?(".git/hooks")
FileUtils.mkdir ".git/hooks"
end
FileUtils.cp_r(".git-hooks/.", ".git/hooks/")
path = ".git/hooks/"
Dir.open(path).each do |p|
filename = File.basename(p, File.extname(p))
if File.extname(p) == ".sh"
FileUtils.mv("#{path}/#{p}", "#{path}/#{filename}")
end
FileUtils.chmod("+x", "#{path}/#{filename}")
end
Pod::UI.puts "Git hooks synchronized"
end
end
end
注册CocoaPods钩子
现在让我们在每次pod install 或pod update之后调用sync方法。为此，我们需要在CocoaPods钩子管理器中注册post_install和post_update钩子。打开lib/cocoapods_plugin.rb写下下面的内容：
require 'command/githooks'
require_relative 'githooks-sync'
module CocoapodsGitHooks
Pod::HooksManager.register('cocoapods-githooks', :post_install)
do |context|
GitHooksSync.new.sync()
end
Pod::HooksManager.register('cocoapods-githooks', :post_update)
do |context|
GitHooksSync.new.sync()
end
end
正如你所看到的，我们在HooksManager中注册了post_install和post_update钩子，每次用户运行pod install或pod update后，都会调用GitHooksSync类的sync方法。
测试
先构建这个gem：
gem build cocoapods-githooks.gemspec
安装并运行：
gem install cocoapods-githooks-0.0.1.gem
如果你遇到权限问题的话：
gem install cocoapods-githooks-0.0.1.gem --user-install
运行这条命令以确保安装正确。它应该出现在已安装插件的列表中
pod plugins installed
#输出
- cocoapods-githooks : 0.0.1 (post_install and post_update hooks)
如果您看到弃用警告，不要担心，我们将在下一个步骤中修复它。
现在让我们回到测试项目。打开Podfile，在开头添加:
plugin 'cocoapods-githooks'
回到命令行执行：
pod install
你应该会看到下面两行打印的内容：
Synchronizing git hooks
.git-hooks directory not found, nothing to sync
这是因为我们没有创建.git-hooks目录。创建一个空的pre-commit.sh文件，并将其放入.git-hooks目录。
回到命令行执行：
pod update
你会看到下面的输出
Synchronizing git hooks
Git hooks synchronized
现在检查.git/hooks目录，它应该包含pre-commit这一可执行文件。
添加自定义CocoaPods命令
添加新命令非常简单。您只需要创建command类的子类。打开lib/cocoapods-githooks/command/githooks.rb，将其内容替换为:
require 'cocoapods'
require 'cocoapods-githooks/githooks-sync'
include CocoapodsGitHooks
module Pod
class Command
class Githooks < Command
self.summary = <<-SUMMARY
Syncs hooks between team members
SUMMARY
self.description = <<-DESC
CocoaPods plugins that syncs git-hooks placed in .git-hooks directory between team members
DESC
self.arguments = []
def run
CocoapodsGitHooks::GitHooksSync.new.sync()
end
end
end
end
它是一个简单的githooks命令，不带参数并调用sync方法。
现在 rebuild和重装重新构建后的gem：
gem build cocoapods-githooks.gemspec
gem install cocoapods-githooks-0.0.1.gem
删除.git中的hooks目录然后执行：
pod githooks
下面是发布时间
请保持官方 RubyGems 的整洁，避免发布测试和演示用的gem
发布CocoaPods插件需要两个步骤。首先，您需要创建一个帐户，然后将您的gem publish到RubyGems.org。之后你可以直接从RubyGems安装插件:
gem install cocoapods-PLUGIN_NAME
如果你想让你的插件被列在官方cocoapods插件列表中，运行:
pod plugins publish
它将在cocoapods-plugins库中创建一个issue并要求将您的插件添加到官方列表中。为了加速这个过程，您可以fork cocoapods-plugins，将生成的json对象添加为plugins.json文件中plugins数组中的最后一个对象，并创建一个pull请求。
最后
我们已经构建了一个非常简单的CocoaPods插件，但是你可以在这个强大的工具上添加更多的东西。如果你想为你未来的项目寻找灵感，可以运行以下程序浏览现有的多个插件:
pod plugins list
网友评论