一、安装Fastlane

需要先安装了 brew，打开终端，输入以下命令

brew install fastlane

如果是 M1 电脑，输入上面的命令有可能没办法安装，需要按照提示输出以下命令，非 M1 电脑可以忽略这段

arch -arm64 brew install fastlane

安装完毕后，查看版本号确认已安装完成

fastlane -v
fastlane installation at path:
/opt/homebrew/Cellar/fastlane/2.182.0/libexec/gems/fastlane-2.184.0/bin/fastlane
-----------------------------
[✔] 🚀 
fastlane 2.184.0

二、初始化 Fastlane

类似于 cocoapods，我们需要在每个项目中初始化 fastlane
在终端进入到项目所在文件夹中

fastlane init

接下来会出现4个选项，需要我们根据自己需求选择，这里我选择 4：手动设置，因为是发布到蒲公英。

[✔] 🚀 
[✔] Looking for iOS and Android projects in current directory...
[15:14:57]: Created new folder './fastlane'.
[15:14:57]: Detected an iOS/macOS project in the current directory: 'moyu.xcodeproj'
[15:14:57]: -----------------------------
[15:14:57]: --- Welcome to fastlane 🚀 ---
[15:14:57]: -----------------------------
[15:14:57]: fastlane can help you with all kinds of automation for your mobile app
[15:14:57]: We recommend automating one task first, and then gradually automating more over time
[15:14:57]: 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
?  

安装成功提示

[15:21:57]: --------------------------------------------------------
[15:21:57]: --- ✅  Successfully generated fastlane configuration ---
[15:21:57]: --------------------------------------------------------

之后我们会在项目文件夹中发现 fastlane 文件夹 和 Gemfile，说明初始化成功了。

fastlane 初始化

如果初始化过程中，一直卡在

[15:17:36]: ------------------------------------------------------------
[15:17:36]: --- Setting up fastlane so you can manually configure it ---
[15:17:36]: ------------------------------------------------------------
[15:17:36]: Installing dependencies for you...
[15:17:36]: $ bundle update

control+C 取消当前操作，然后打开 Gemfile 文件，将

source "https://rubygems.org"

修改为：

source "https://gems.ruby-china.com"

然后在终端输入下面命令重新运行，等待更新

bundle update

三、配置 Fastlane 文件

打开 Fastlane 文件，根据自己项目的需要编辑相关内容

default_platform(:ios)

platform :ios do

  desc "打包上传至蒲公英"
  lane :build_to_pgyer do
    # 需要打包的 target 名字
    scheme  = "xxxxx"
    # 总共有4种打包方式选择，根据自己需求选择
    # app-store ：上架App Store
    # ad-hoc ：内部测试
    # development ：内部测试
    # enterprise ：企业证书-内部测试
    export_method = "enterprise"
    # 允许访问钥匙串（有可能会用到）
    export_xcargs = "-allowProvisioningUpdates"
    # 获取版本号、build，方便自动命名包名（根据需求添加）
    version = get_info_plist_value(path: "./#{scheme}/Info.plist", key: "CFBundleShortVersionString")
    build = get_info_plist_value(path: "./#{scheme}/Info.plist", key: "CFBundleVersion")
    # ipa 包名称，可以根据自己需求改变下面的组合
    output_name = "#{scheme}_#{version}_#{build}_#{Time.now.strftime('%Y%m%d%H%M%S')}.ipa"
    # ipa 包导出路径
    output_directory = "/Users/xxxx/Desktop/Fastlane"
    # 蒲公英账号的 api_key 和 user_key
    pgyer_api_key = "xxxxxxxxxxxxxxxxxxxx"
    pgyer_user_key = "xxxxxxxxxxxxxxxxxxx"
    # 打包配置
    build_app(
    scheme: scheme,
    export_method: export_method,
    export_xcargs: export_xcargs,
    output_directory: output_directory,
    output_name: output_name,
    export_options: {
                # provisioningProfiles是手动配置证书，如果项目种选择了自动选择证书，则不需要添加这段
                # 如果项目中包含了 extension ，需要额外配置证书的才会用到
                provisioningProfiles: {
                    "com.xxxx.xxx" => "证书名称",
                    "com.xxxx.xxx.xxxx" => "证书名称"
                }
            }
    )
    # 上传到蒲公英
    pgyer(api_key: pgyer_api_key, user_key: pgyer_user_key)

  end
end

四、添加蒲公英插件：pgyer

注意，必须要在项目文件夹路径下添加，否则打包成功后，会上传失败。
中间会要求修改 Gemfile，输入 y 即可。

fastlane add_plugin pgyer

[✔] 🚀 
[16:23:53]: fastlane detected a Gemfile in the current directory
[16:23:53]: However, it seems like you didn't use `bundle exec`
[16:23:53]: To launch fastlane faster, please use
[16:23:53]: 
[16:23:53]: $ bundle exec fastlane add_plugin pgyer
[16:23:53]: 
[16:23:53]: Get started using a Gemfile for fastlane https://docs.fastlane.tools/getting-started/ios/setup/#use-a-gemfile
[16:23:55]: Plugin 'fastlane-plugin-pgyer' was added to './fastlane/Pluginfile'
[16:23:55]: It looks like fastlane plugins are not yet set up for this project.
[16:23:55]: fastlane will modify your existing Gemfile at path '/Users/xxxx/Desktop/moyu/Gemfile'
[16:23:55]: This change is necessary for fastlane plugins to work
[16:23:55]: Should fastlane modify the Gemfile at path
'/Users/xxxx/Desktop/moyu/Gemfile' for you? (y/n)
y
[16:23:58]: Successfully modified '/Users/xxxx/Desktop/moyu/Gemfile'

看到上面的信息，说明已经成功安装了pgyer 插件

五、准备工作完毕，开始打包

输入以下命令，这里的 build_to_pgyer 就是 fastlane 文件中的方法名，之后可以根据自己的需求，多添加几个不同的方法，用于打包不同名字的、不同环境的target。

fastlane build_to_pgyer

这个时候喝口水，就可以看到下面的信息

[16:35:29]: Successfully exported and compressed dSYM file
[16:35:29]: Successfully exported and signed the ipa file:
[16:35:29]: /Users//Desktop/Fastlane/moyu_1.0_1_20210528163516.ipa
[16:35:29]: -------------------
[16:35:29]: --- Step: pgyer ---
[16:35:29]: -------------------
[16:35:29]: The pgyer plugin is working.
[16:35:29]: build_file: /Users/xxxx/Desktop/Fastlane/moyu_1.0_1_20210528163516.ipa
[16:35:29]: Start upload /Users/xxxx/Desktop/Fastlane/moyu_1.0_1_20210528163516.ipa to pgyer...
[16:35:35]: Upload success. Visit this URL to see: https://www.pgyer.com/xxx

+------+----------------------+-------------+
|             fastlane summary              |
+------+----------------------+-------------+
| Step | Action               | Time (in s) |
+------+----------------------+-------------+
| 1    | default_platform     | 0           |
| 2    | get_info_plist_value | 0           |
| 3    | get_info_plist_value | 0           |
| 4    | build_app            | 12          |
| 5    | pgyer                | 6           |
+------+----------------------+-------------+

[16:35:35]: fastlane.tools finished successfully 🎉

至此，我们的打包已经完成。
到输出文件下，可以看到2个文件，一个是dSYM文件，一个是ipa包。
在上面的信息也可以获取到蒲公英的下载地址。

今日份摸鱼轻松到手.png

六、其他问题

一般会卡主的地方出现在证书选择上，特别是项目比较复杂包含了extension的，证书需要额外配置，这一步会卡比较久。
另外就是蒲公英插件的添加位置不要弄错。
对于项目种有多个target，或者多个不同包名、不同环境的，建议每个target对应一个 lane 方法，打包时可以分别打包，这样比较方面。
基本上 fastlane 可以做到一次配置，多次使用，非常的方便。