iOS 使用 Fastlane 一键打包

iOS 使用 Fastlane 上传 App 到蒲公英

1.安装Fastlane

三选一
sudo gem install fastlane
sudo gem install fastlane -NV
brew cask install fastlane

2.安装shenzhen

sudo gem install shenzhen

3.在xcodeproj文件同级目录下，执行

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不了解的，可以参考王巍写的这篇文章
3. 自动的App Store发布包。我们的目标是要提交审核到APP Store，按道理应该选这个，但这里我们先不选，因为选择了以后会需要输入用户名密码，以及下载meta信息，需要花费一定时间，这些数据我们可以后期进行配置。
4. 手动设置。

这里我们选择4后一路回车即可，结束后会在工程文件目录中看到生成了fastlane文件，该目录包含Appfile和Fastfile；

4.设置Appfile文件内容：

Appfile用来存放app_identifier，apple_id和team_id：
有多个的时候 可以for_lane这样添加多个；

# 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

app_identifier "com.****.****"      # bundleId
apple_id "*******@outlook.com"      # 苹果账号
team_id "*******"               # 团队ID

for_lane :inhouse do
  app_identifier "com.****.****"        # bundleId
  apple_id "*******@outlook.com"        # 苹果账号
  team_id "*******"             # 团队ID
end

5.设置Fastfile文件内容：

Fastfile管理你所创建的 lane
上面这个是网上查到的解释，下面的一个是我自己给项目配的

# 指定 fastlane 最小版本
fastlane_version "2.20.0"
# 指定当前平台，可以设置为 ios 、android、mac
default_platform :ios

platform :ios do
# 在执行每一个 lane 之前都先执行这个代码
  before_all do
  end

# 定义一个创建测试包的 lane
# 我们调用的命令就是调用 fastlane 的 lane
  lane :buildDebugApp do |op|
      # 根据输入的版本设置项目 version number （我们初始化 fastlane 的时候是在 .xcworkspace 目录下， 而我们的项目中 ，.xcworkspace 和 .xcodeproj 不在同一级目录，这里的“increment_version_number”需要检测 .xcodeproj 项目文件，所以需要指定该文件的目录）
    increment_version_number({xcodeproj: './HomeMate2_Trunk/HomeMate.xcodeproj', version_number: op[:version]})

    # 根据输入的版本设置项目 build number （同上，也是需要指定 .xcodeproj 的目录）
    increment_build_number({xcodeproj: './HomeMate2_Trunk/HomeMate.xcodeproj', build_number: op[:version]})

    # 最重要的打包命令
    gym(
              export_method: 'ad-hoc',        # 打包的方式，可设置为 appstore(默认)，enterprise
                     scheme: "HomeMate",    # 指定需要打那个 scheme 的包
                  workspace: "HMWorkSpac.xcworkspace",    # 指定打包的项目文件
                output_name: "HomeMate.ipa",      # 打包输出名称
                     silent: true,    # 隐藏不必要信息
                      clean: true,    # 打包前是否 clean 项目
              configuration: "Debug",    # 配置为 debug 版本
              buildlog_path: "./fastlanelog",    # 日志输出目录
       codesigning_identity: "iPhone Developer: Hailiang He (xxxxxxxxxx)",       # 代码签名证书
           output_directory: "/Users/xxx/Desktop"     # ipa输出目录
     )
  end

  # 在执行每一个 lane 之后执行该功能
  after_all do |lane|
  end

  # 在执行每一个 lane 出错的时候执行该功能
  error do |lane, exception|
  end

end

我的项目↓

# 指定 fastlane 最小版本
fastlane_version "2.20.0"
# 指定当前平台，可以设置为 ios 、android、mac
default_platform(:ios)

platform :ios do
  desc "Description of what the lane does"

  lane :enterprise do      #分号后面不能有空格
    gym(
      scheme:"enterprise",
     #export_method：可选的值有：app-store、ad-hoc、development、enterprise
      export_method:"enterprise",      #打包的类型，我打的是企业包
      output_directory:"/Users/***/Desktop",    #打包出来的地址
      output_name:"enterprise_***.ipa",      #打包好的文件名
      export_xcargs: "-allowProvisioningUpdates",
    )
  end

#  lane :custom_lane do
#    # add actions here: https://docs.fastlane.tools/actions
#    export_method:development
#  end

end

6.打包成ipa

保存之后在终端里面运行 三选一
fastlane enterprise
fastlane ios enterprise
fastlane enterprise version:2.2.0
就会开始打包了。

7.参考资料

iOS Fastlane自动化打包(1) 安装和打包IPA
Fastlane安装和使用和注意事项
使用fastlane实现iOS持续集成