iOS使用fastlane match来管理代码签名

image.png

match是fastlane提供的一种全新的管理证书的方式,它使团队所有成员共享一份代码签名,以减免不必要的证书创建,描述文件失效等问题。

官网文档

为什么要用match?

  • 很多团队中证书与描述文件的关系比较混乱,各自为政,创建了很多相同的描述文件,并且新的旧的都有在用,像因包含设备不同步导致打包失败等问题时有发生。

  • 虽然xcode带来的自动管理签名带来了一定的方便,但同时也增加了不可控性,打包具体用的哪个描述文件?包不包含特定设备?有时候往往到结果那一步才了解。

match能做什么?

  • match使所有成员共享同一份证书和描述文件,大大减少管理和维护的成本,并有着完善的同步机制。

  • 因为match将所有的证书和描述文件存放于你的git仓库中,所以只要拥有git仓库的访问权限,安装了fastlane,那新设备可以迅速投入到工作中。

  • 简化请求证书,生成描述文件,注册设备等工作,这些全部可以在终端通过命令进行操作。

如何使用

初始化

  1. 因为match是将所有的证书和描述文件统一放在git仓库中,所有第一步就是先创建一个私有仓库,注意一定要是私有仓库!名字官方建议为certificates

  2. 在项目文件夹下执行

    fastlane match init

    系统会提示输入Git仓库的链接,需确保当前账户有git仓库的访问权限。执行完成后会在/fastlane下生成一个叫做Matchfile的文件。里面保存着你刚才输入的Git仓库链接,以后操作match,会默认读取该URL。

    image

    type是match的默认类型,当执行fastlane match时,在当前环境下也就相当于执行fastlane match development

  3. 这一步官方建议通过命令清除之前的证书和描述文件,毕竟我们想从一个干净的环境出发,所以如果当前不是上线时刻,或是其他急用的场景就放心的搞吧。
    企业账号慎用,销毁描述文件可能会导致App无法打开

 fastlane match nuke development  ---开发证书
    ​
 fastlane match nuke distribution ---apple store 和 adhoc使用此命令
    ​
 fastlane match nuke enterprise  ---企业证书

  1. 创建新的证书和描述文件,通常来说,我们需要appstoredevelopment、以及adhoc环境的证书和描述文件,所以分别执行
    fastlane match appstore
    ​
    fastlane match development
    ​
    fastlane match adhoc

第一次执行完后,match会创建新的证书和描述文件,之后执行会拉取仓库已经存在的。
此时打开你的git仓库可以看到证书和描述文件已经存在了,并且证书和私钥也存放到了钥匙串中,描述文件存放于Mac下的~/Library/MobileDevice/Provisioning Profiles文件夹下。

image

到此我们的证书和描述文件已经准备好了。

配置Xcode

之前我们有说过xcode自动管理证书的问题,现在我们可以放心的关掉它了。

打开Xcode->general关掉Automatically manage signing这时会多出Signing(Debug)、Signing(Release),或者还有Signing(adhoc)这取决于你的项目。

分别选用相对应的描述文件,如果提示描述文件不包含xx证书,就到Build Settings->Code Signing Identity 将对应的证书选一下。

image

新电脑接入

当公司来了一个新人,或是换设备了,我们也可以很方便的将证书和描述文件拉取下来。

  1. 将设备的SSH key设置到git仓库中,以使其拥有仓库的读取权限。

  2. 安装fastlane,这个可以参考上一篇文章,这里如果不使用fastlane其他功能,只需安装即可,无需其他的无需配置。

  3. 拉取证书和描述文件

    fastlane match [type] type可以是appstore, adhoc, development, enterprise。

    你也可以加上--readonly以保证只读取仓库的,不会创建新的。

️在我的实践中发现了一个问题,当其他设备第一次使用上述命令拉取证书和描述文件时发现git clone命令被挂起了。原因在于并没有读取本地的SSH key,以至于缺少访问权限,但是当随便git clone其他仓库时,就会提示读取SSH key,然后再回头拉取certificates仓库就会很顺利的执行下去。

注册新设备

想一下之前我们添加设备是什么流程,打开开发者网站,添加一个新设备,重新生成描述文件,然后下载描述文件到本地,在Automatically manage signing模式下,xcode还偶尔不选用最新的。。。

现在通过match,更多的是fastlane提供的功能,我们只需要

  1. 到项目文件下,执行fastlane run register_device,执行中会要求提供设备的name 和 UDID,当然fastlane也提供了多设备注册的方式。

  2. 执行fastlane match [type] --force_for_new_devices 来更新描述文件。force_for_new_devices参数意味着,match将检查自上次运行match后设备数是否已更改,如有更改即会重新生成描述文件并下载安装到你的计算机

结合fastlane打包时同步描述文件

match作为fastlane一个action,自然可以和自动打包结合的起来,通过设置我们可以在每一次打包时获取最新的描述文件。

match(type: "appstore")
​
match(git_url: "https://github.com/fastlane/certificates",
 type: "development",force_for_new_devices: true)
​
match(git_url: "https://github.com/fastlane/certificates",
 type: "adhoc")
​
match(git_url: "https://github.com/fastlane/certificates",
 type: "enterprise")
# _match_ should be called before building the app with _gym_
gym 
# ...

force_for_new_devices:true 参数会检测设备数变化进行同步,不适用于appstore type
force:true 参数会每次更新描述文件

结尾

愿世间没有Bug 阿门。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容

  • fastlane运行所需要的环境: OS X 10.9以上 Ruby 2.0 以上 Xcode 拥有一个开发者账号...
    阿姣_0405阅读 2,931评论 0 4
  • 用到的组件 1、通过CocoaPods安装 2、第三方类库安装 3、第三方服务 友盟社会化分享组件 友盟用户反馈 ...
    SunnyLeong阅读 14,598评论 1 180
  • 眼光放远,满目悲凉。 眼光放近,满目疮痍。 眼光,你究竟应该看向何方? 初入大学,心怀天下,趾高气扬,指点江山,好...
    望与君共勉阅读 317评论 1 2
  • 今天上午写完作业后,爸爸说带我去公园玩。我一听很高兴,穿上外套,我就和爸爸去公园玩了。今天的天气很好,可是公园里的...
    赵泽烁阅读 260评论 0 0
  • 《石头》——蓝风 夜晚的道,是孤独的 那颗心,谁来安抚 你的温润,是母亲慈祥的笑 有了你,一辈子都是温暖的 想把你...
    是蓝风吖阅读 158评论 0 0