在开发过程中，证书和配置文件的管理一直是一个让人头痛的问题，不管是Xcode自动创建的众多让人摸不着头脑的配置文件，还是不断被其它人revoke的证书，这些场景无不让人想要一个简单、彻底的解决方案， match正是为解决这些问题而开发的。

match的方案是只创建一份code sign所需文件，并使用Git在团队内共享它们。

match是https://codesigning.guide概念的实现。match创建所有必需的证书和配置文件，并将它们存储在单独的git存储库中。每个有权访问仓库的团队成员都可以使用这些凭据进行代码签名。match还会自动修复损坏和过期的凭据。这是跨团队共享签名凭据的最简单方法。

基本使用

准备

1. 创建一个Git仓库(务必保证是私有的，安全很重要), 取名为certificates
2. (非必要)创建一个共享的Apple Developer账号
3. 在项目目录中执行Shell命令:

fastlane match init

执行命令后会要求输入Git仓库地址, 可以是https://或gitURL（如果你是使用SSH对Git进行身份验证，则需要使用gitURL，否则在尝试匹配时将看会身份验证错误）。

fastlane match init命令不会获取或修改你的证书和配置文件, 只会在./fastlane目录生成一个Matchfile文件。

Matchfile内配置示例:

git_url("https://github.com/fastlane/certificates")
 
app_identifier("tools.fastlane.app")
# username("[email protected]")

文件内记录了证书和配置文件的Git仓库地址及match命令的相关配置，可以根据你的需求来修改它们。

生成证书和配置文件

在首次运行前, 可以使用fastlane match nuke命令清除现有的配置文件和证书。(了解更多)

你可以使用以下命令来生成证书:

# 开发证书及配置文件
fastlane match development 

# 生成证书及内部分发配置文件
fastlane match adhoc

# 生产证书及配置文件
fastlane match appstore

这将创建一个新的证书和配置文件（如果需要的话）并将它们存储在你的Git仓库中。

配置文件将安装在~/Library/MobileDevice/Provisioning Profiles中，证书和私钥安装在你的钥匙串中。

处理多个标识符

如果你有多个标识符，则可以将同步操作换成以下命令执行，不同标识符之间使用逗号隔开

fastlane match appstore -a tools.fastlane.app,tools.fastlane.app.watchkitapp 

当然，你也可以使用lane来处理以上操作：

lane :certificates do
  match(app_identifier: ["com.krausefx.app1", "com.krausefx.app2", "com.krausefx.app3"], type: appstrore, readonly: true)
end

这样，你就只需执行fantlane certificates命令即可完成操作

在同一个仓库中配置多个团队证书

要配置多个的证书，需要在Git中创建branch来存放这些证书

在生成证书时你应该使用--git_branch参数，或者在Matchfile中添加git_branch参数，这样就能把生成的证书保存在对应的branch中

fastlane match appstore -a tools.fastlane.app --git_branch team01

其他成员执行同步

其他成员需要同步证书和配置文件，只需执行相同的命令：

fastlane match development

它会识别Git仓库中是否有现成的证书和配置文件，如果有，就会安装仓库中现有的证书和配置文件。

你甚至可以在某个模式下执行match操作，readonly用来确保不会生成证书和配置文件

fastlane match development --readonly

扩展使用

在lane中使用match

添加match方法到Fastfile中，则可以使用lane来快速同步证书和配置文件

match(type: "appstore")

match(git_url: "https://github.com/fastlane/certificates",
      type: "development")

match(git_url: "https://github.com/fastlane/certificates",
      type: "adhoc",
      app_identifier: "tools.fastlane.app")

match(git_url: "https://github.com/fastlane/certificates",
      type: "enterprise",
      app_identifier: "tools.fastlane.app")

# _match_ should be called before building the app with _gym_
gym
# ...

注册新设备

通过使用match，每次将新设备添加到Ad Hoc或开发配置文件时都会节省大量的时间。将match与register_devices操作结合使用。

lane :beta do
  register_devices(devices_file: "./devices.txt")
  match(type: "adhoc", force_for_new_devices: true)
end

通过使用force_for_new_devices参数，match将检查自上次运行匹配以来，设备计数是否已更改，并在必要时自动重新生成配置文件。你也可以使用force: true参数强制每次运行时都重新生成配置文件。

要点：App Store配置文件将会忽略force_for_new_devices参数，因为这种模式不包含任何设备信息。

如果你不使用fastlane，还可以使用命令行中的force_for_new_devices选项：

fastlane match adhoc --force_for_new_devices

清除现有配置文件和证书

如果你的Apple Developer账户中有大量无效、过期或者Xcode自动生成的配置文件和证书，可以使用match nuke命令撤销证书和配置文件，不必担心，App Store / TestFlight中已有的应用程序仍然可以使用，推送证书也不在清理范围内。清除账户后，你就可以从零开始，运行match生成证书和配置文件。

要撤消特定环境的所有证书和配置文件：

fastlane match nuke development
fastlane match nuke distribution
fastlane match nuke enterprise

match会在操作前会向你确认操作是否执行

Git 仓库

第一次运行match后，你的Git仓库将包含2个目录：

• certs文件夹包含所有带有私钥的证书
• profiles文件夹包含所有配置文件

此外，match还生成了一个README.md文件，让新的团队成员更容易上手：

参数

参考链接

1. match官方文档