作者 kyson老师 2018.03.01 16:49:00 iOS使用fastlane一键打包审核 评论：20 距离上次写[iOS 中使用Jenkins进行持续集成](http://kyson.cn/index.php/archives/34/)有一段时间了。毋庸置疑，Jenkins对我们打包的帮助还是很大的——被测试的同学追着要IPA包的日子终于一去不复返了。但作为追求效率的开发我们仅仅满足于此就可以了吗，想想我们iOS开发遇到的其他诸多类似的问题吧 1. 团队成员一不小心Revoke了证书导致所有的开发小伙伴需要重新下载证书 2. 每次提交App Store审核需要重复【修改证书】- 【打包】-【iTunes Connect】- 【发布】等一系列动作 真的是不厌其烦，让人抓狂。这个时候，幸好[Fastlane](https://fastlane.tools/)来了，看他怎么来拯救我们吧。在开始我们的教程之前，笔者先做个澄清，fastlane不是什么： - fastlane 不是一个工具，而是一系列工具的集合。比如match工具能管理证书，deliver能提交APPStore审核。所以我们在使用fastlane的时候更多的是和它的工具集打交道。 - fastlane内部的工具不是新写的，而是调用mac本身的命令，只不过是实现了自动化而已。比如gym工具只是xcodebuild工具的一个封装，如果你会xcodebuild，那gym对你来说小菜一碟。 - fastlane本身没有一套特殊语法，使用的Ruby语言，相信使用过cocoapods的同学应该很容易上手。 安装完fastlane并调用`fastlane init`后，目录结构大概如下所示：  具体的安装和初始化，本文稍后会详细讲述，先带大家分析一下安装后的fastlane的目录结构。红色区域就是多出来的文件。本项目是笔者的一个APP Store上线项目，大家可以[点击这里](https://github.com/kysonzhu/wallpaper)获取。 - Gemfile 告诉我们fastlane 依赖的gem以及版本等其他信息。这个跟本文主题不大，笔者就不详细描述了 - fastlane文件夹里的Appfile看文件也知道，里面是关于本App的信息的；Fastfile则是fastlane的最主要的文件，在这个文件中可以编写我们需要使用的各个工具的顺序、方式等。 这里我们先看一个已经写好的fastlane的内容: ``` default_platform(:ios) platform :ios do desc "Description of what the lane does" lane :custom_lane do # add actions here: https://docs.fastlane.tools/actions match( git_url: "https://github.com/zjh171/fastlaneProvingProfile", type: "appstore" , readonly: true ) gym( scheme:"Wallpaper", export_method:"app-store", output_directory:"./build", archive_path:"./Archive" ) end end ``` 这里我们只需要关注 match 和gym这两个工具以及括号后的内容。match工具是我们本文开头描述的用于同步开发小伙伴证书的工具，而gym则是xcodebuild工具的封装，它指定了打包的目录以及打包的类型。保存该文件并执行`fastlane custom_lane`后我们可看到  这就表明我们打的App Store包已经生成了。目录就是我们指定的`output_directory`对应的目录。当然大家也不难猜想到，如果要让fastlane实现自动提交到App Store审核，还需要在gym后面加上我们需要的工具。这里先卖个关子，稍后告诉大家。下面笔者就详细的介绍一下fastlane的使用。 ### 安装 执行命令`sudo gem install fastlane --verbose`即可，安装完成后检查一下是否安装成功输入`fastlane --version`看是否有版本号显示。 ### 初始化 输入命令`fastlane init`会看到如下选项 ``` What would you like to use fastlane for? 1. Automate screenshots 2. Automate beta distribution to TestFlight 3. Automate App Store distribution 4. Manual setup - manually setup your project to automate your tasks ``` 这四个选项的意思是 1. 自动截屏。这个功能能帮我们自动截取APP中的截图，并添加手机边框（如果需要的话），我们这里不选择这个选项，因为我们的项目已经有图片了，不需要这里截屏。 2. 自动发布beta版本用于TestFlight，如果大家有对TestFlight不了解的，可以参考王巍写的[这篇文章](https://onevcat.com/2012/01/testflight/) 3. 自动的App Store发布包。我们的目标是要提交审核到APP Store，按道理应该选这个，但这里我们先不选，因为选择了以后会需要输入用户名密码，以及下载meta信息，需要花费一定时间，这些数据我们可以后期进行配置。 4. 手动设置。 选择第四个后一路回车即可，我们会看到生成了我们熟悉的fastlane目录，该目录下包含了Appfile和Fastfile。我们打开这两个文件。 `Appfile` ``` # app_identifier("[[APP_IDENTIFIER]]") # The bundle identifier of your app # apple_id("[[APPLE_ID]]") # Your Apple email address # For more information about the Appfile, see: # https://docs.fastlane.tools/advanced/#appfile ``` 发现里面没有任何信息（“#”在ruby里是注释，所以里面没有任何信息）注释的部分中，`app_identifier`用于指定APP的`bundle id`，`apple_id`指的是你的AppleID。 `Fastfile` ``` # Uncomment the line if you want fastlane to automatically update itself # update_fastlane default_platform(:ios) platform :ios do desc "Description of what the lane does" lane :custom_lane do # add actions here: https://docs.fastlane.tools/actions end end ``` 这个文件的信息稍微多一点，而且我们也更熟悉了，语法跟cocoapods很像，而且我们在文章开头已经稍微做了一些介绍，发现在`lane :custom_lane do`后面是空的。其实意思也就是说，这里任何操作都没有执行。 ### 运行 虽然这是个什么都没有做的fastlane项目，但其实我们可以运行了，执行 `fastlane custom_lane`命令，我们可以看到如下输出 ``` fastlane detected a Gemfile in the current directory however it seems like you don't use `bundle exec` to launch fastlane faster, please use $ bundle exec fastlane custom_lane //此处省略多行 fastlane.tools finished successfully ``` 大致意思就是，我们可以使用命令`bundle exec fastlane custom_lane`代替`fastlane custom_lane`，这样会执行得更快。最后的`fastlane.tools finished successfully`表示执行成功了。 ### 打包 提交审核的前一步是打包，也是最主要的一步。fastlane中有专门用于编译、打包的命令`gym`，我们加到`lane :custom_lane do`后看看会不会有问题。  然后执行`fastlane custom_lane`我们会收到如下提示 ``` Select Scheme: 1. Wallpaper 2. AFNetworking 3. Mangogo 4. Masonry 5. MJRefresh 6. Pods-Wallpaper ? ``` 毫无疑问我们选择1，其他的都是我们调用的三方库。但聪明的读者肯定在想，这个`Scheme`是否能在`fastlane`文件中就设置好，省的这里在自己选择。是的，这就是文章开头提到的 ``` gym( scheme:"Wallpaper", export_method:"app-store", output_directory:"./build", archive_path:"./Archive" ) ``` 中`scheme:"Wallpaper",`的含义。其他的参数也就不一一赘述了。读到这里，相信大部分读者已经对fastlane的原理一清二楚了。其实所谓的会用fastlane也就是会用里面的各种工具而已。我相信大家选完`Scheme`后还没到打包这一步，应该已经出现了错误提示，错误应该就是大家都非常熟悉的证书问题；当然，如果读者够侥幸，证书已经设置好了，并将`output_directory`、`archive_path`设置好了，那就能生成对应的对应的IPA包。但相信成功的读者应该寥寥无几，这个时候就要使出我们的大杀器`match` ### 证书管理 fastlane中能管理证书和签名的工具其实还有`sigh`以及`cer`，那为何笔者要给大家推荐`match`呢，原因已经在文章开头指出了，对于多人开发时出现的证书错乱问题`match`可以很好的处理。它将开发人员的证书提交到一个git仓库进行集中处理，在有新的成员加入开发时候，只需要运行一两条命令。下面我就详细讲一下其实现过程吧： 1.创建一个仓库（空仓库或者现有仓库都可以，但建议大家使用一个空仓库专门处理证书），这里笔者的仓库地址是：[https://github.com/zjh171/fastlaneProvingProfile](https://github.com/zjh171/fastlaneProvingProfile) 2.在终端运行`fastlane match init`可以看到需要我们输入giturl地址，我们将地址拷进来即可。  输入地址后我们会看到如下提示 ``` You can now run `fastlane match development`, `fastlane match adhoc`, `fastlane match enterprise` and `fastlane match appstore ``` 我们按照提示生成`development`和`App Store`证书，然后会在Xcode中发现生成的证书以及`Provision Profile`文件。我们在Xcode中设置好即可。  接下来，我们将match添加到fastlane文件中，如下  当然，这个文件我们已经在文章开头看过了，是不是再次感觉豁然开朗。回到命令行，我们再次执行`fastlane custom_lane`发现我们可爱的IPA包已经打包完毕。 ### 提交App Store审核 终于到了最令人激动的提交App Store时刻了。我们要使用的工具是`deliver`。聪明的你应该已经知道，第一步肯定是要调用`fastlane deliver init`，这里会让我们输入`APPle ID`,输入以后就看到我们的项目文件夹发生了变化：  接着，我们修改一下`fastfile`文件，添加`deliver`，因此我们最终版的`fastlane`文件是这样的： ``` lane :release do # 增加build版本号 increment_build_number match( git_url: "https://github.com/zjh171/fastlaneProvingProfile", type: "appstore" ,#can be appstore,adhoc, development,enterprise app_identifier:"cn.kyson.wallpaper", username:"zjh171@qq.com", readonly: true ) # 编译代码 gym( scheme:"Wallpaper", export_method:"app-store", ) # 发布到Apple Store deliver end ``` 可以看到，大部分配置跟以前一样，只做了lane名的改变，还有添加了`increment_build_number`这一行。`increment_build_number`的作用是防止本地版本的build号比`App Store`(或上次)低而做的自动增长版本号的处理。当然加了这几句还需要在Xcode中做相应处理：  最后在命令行中输入`fastlane release`，等待大概十几分钟就可以看到成功的提示了。然后我们进入`iTunes Connect`，确认一下：  确实是已经在审核状态。如果大家想实现“一键审核”可以给deliver带上参数`submit_for_review`。这样就真正实现了一键提交`App Store`审核。至此，我们的一键打包审核流程完美收工。 #### 注意点 笔者从开始研究`fastlane`到完全跑出来大概花了三天时间，期间遇到了很多问题，走了很多弯路，总结一下，希望对读者有一定帮助 - fastlane的初始化命令是`fastlane init`，不需要加root权限，也就是`sudo fastlane init`是不需要的，如果使用了sudo会对后面的各个操作造成很大影响，比如项目文件(workspace后project文件)会锁定不能操作，还会引起打包失败 - 很多刚接触fastlane的同学会一不注意就被fastlane上的各种命令整的晕头转向，例如`sync_code_signing`命令，其实是`match`命令的另外一种写法；`build_app`命令其实是`gym`的别名。因此大家在学习fastlane的时候只需要学习本文介绍的命令，大部分情况下已经够用。如果对一个命令的用法不熟悉，可以通过`fastlane action`查找，例如`fastlane action match`。 #### 参考 [fastlane官网](https://docs.fastlane.tools/) [iOS自动化打包发布（Jenkins + Fastlane + GitLab + 蒲公英）](https://www.jianshu.com/p/0a113f754c09) 赏 标签：iosfastlane自动打包
学习了
1.配置证书，怎么输入账号和密码
你好， fastlane match init之后会要求你输入git仓库地址，输入你的地址，然后会要求你输入你appleID，接着会要求你输入证书管理的密码，最后输入`fastlane match development'或者输入即可同步开发证书`fastlane match appstore'生成生产证书
打包那里，在这里添加gym给个模版
gym(
scheme:"Wallpaper",
export_method:"app-store",
output_directory:"./build",
archive_path:"./Archive"
)
执行 fastlane match appstore 命令 输入Apple id然后要求输入The bundle identifier(s) of your app (comma-separated): 这里应该输入什么？输入bundle id 报错。
bundle identifier(s)就是bundle id，这是毫无疑问的；你遇到的问题，原因可能是在Apple开发者网站的证书列表中没有提前注册相关证书，导致fastlane match找不到你对应的app id，自然就生成不了证书了。
按照文章步骤，可以成功上传，感谢分享。
我分享在实际操作中遇到的一个小问题和解决方案，fastlane custom_lane这个一步，select Scheme的列表里面发现并没有我的项目scheme.网上搜了一下，要在xcode，Project菜单->Scheme->Manage Scheme里面，将你项目的scheme的share选项勾上才行。
很开心能帮助到你，确实需要将scheme的share选项勾上才行，笔者在操作的时候也是这么操作的。本文只讲解了流程，没有将这些细节描述出来。
请问 为什么我用 fastlane init 命令后 出来了选择1.2.3.4 选择3 报错 Unable to locate Xcode. Please make sure to have Xcode installed on your machine
很有可能是因为你在Xcode中没有设置“Command Line Tools”:打开Xcode偏好设置，选择"Location"选项卡，选择相应的“Command Line Tools”即可。
fastlane init 后 选择第三个 报错 Unable to locate Xcode. Please make sure to have Xcode installed on your machine 请问是什么原因 万分感谢
很有可能是因为你在Xcode中没有设置“Command Line Tools”:打开Xcode偏好设置，选择"Location"选项卡，选择相应的“Command Line Tools”即可。
是这个原因 多谢大佬 这个卡了一下午了
麻烦您 为什么fastlane init后 选择完第四个选项
Installing dependencies for you...
bundle update
等待了 2小时 依旧这个画面
你好，按道理不会出现这种情况，你可以清空一下缓存试试
如果是多Target下该怎么打包？
找一下，fastlane有对应参数可以设置的
你好，我fastlane match init后输入git地址，然后又出现Passphrase for Git Rep。 然后我密码忘记了，怎么办。可以重置换个git地址重新操作么？
你好，可以的，只要换个新的git空仓库，然后fastlane match init即可