Xcode Server/macOS Server 保姆级教程

发表于 更新于 本文字数： 1.8k 阅读时长 ≈ 2 分钟

  • 简介

    Xcode Server 是苹果官方提供的持续集成方案.

    • 优点: xcode 自带工具, 部署简单, 有手就能玩 甚至支持 swift 脚本.
    • 缺点: iOS 完美无缺 只支持 apple 体系.

  • 前提

    • 准备一个 iOS 的项目
      • 需要设置了 remote URL 的项目, 否则无法使用.
      • $ git remote add origin [URL]
    • 一个付费的 apple 开发者账号.
    • 去这个macOS APP store下载一个 macOS server 软件, 安装, 打开启动

  • 步骤

    以下步骤全部在 xcode 内进行

    • command , 打开偏好设置,
    • 选择 Accounts, + 号, 选择 xcode server, 选中在 macOS server 内相同主机名字的哪个栏目, next ->,
    • 输入 macOS server 内的可用 用户(可以自己创建)账户密码. 然后 add 进去
    • 偏好设置内选择 server&bot, 启动.
    • 项目的操作菜单内, Product, create bot:
      • server 选择刚才创建的, name随意写. next ->
      • verify SSH, 项目的 git 地址, 公钥验证. next ->
      • configuration, 选择 scheme, export 可选, 如果你是企业级项目进行分发的话, 需要选择 plist, 填写所需配置. next ->
      • integrate, 一般选择 on commit, 在收到 commit 的时候进行编译; 也可以选择 manually, 自己主动选择. clean, 我选的 once a weak, 自己按需选择. next ->
      • build for, 按需选择. next ->
      • 配置证书和描述文件, 选择配置项目打包证书 add to server. next ->
      • 环境变量, 按需填写. 我没有, 我不写
      • configure bot triggers, 配置 编译前后脚本和邮件事件.
        • pre-integration script
          • 打包编译前的脚本
            • 一般来说, 我们的项目是 cocoapods 管理的
              1
              2
              3
              4
              5
              export LANG=en_US.UTF-8
              cd ${XCS_PRIMARY_REPO_DIR}
              pwd
              rm -f Podfile.lock
              /usr/local/bin/pod install
        • post-intefration script
          • 打包编译后的脚本
            • 上报蒲公英
              1
              2
              3
              4
              curl -F "file=@$XCS_PRODUCT" \
              -F "uKey=you uKey" \
              -F "_api_key=you _api_key" \
              https://qiniu-storage.pgyer.com/apiv1/app/upload
            • 提交 app store
              1
              2
              3
              4
              5
              6
              7
              8
              9
              10
              #!/bin/sh
              altoolPath="/Applications/Xcode.app/Contents/Applications/Application Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/altool"
              # 填入你的Apple ID
              USERNAME="你的AppleID"
              #  需要去Apple ID账户生成 App 专用密码
              PASSWORD="App 专用密码"

              "$altoolPath" --validate-app -f ${XCS_PRODUCT} -u ${USERNAME} -p ${PASSWORD} -t ios
              "$altoolPath" --upload-app -f ${XCS_PRODUCT} -u ${USERNAME} -p ${PASSWORD} -t ios

        • issure email
          • 按需配置
        • Periodic Email Report
          • 按需配置

  • 遇到的问题

    • macOS server 付费: 自行解决, 苹果开发者中心的beta版本不要钱.
    • product 下 没有 create bot 选项: accounts 里面添加 xcode server 了吗?

  • xcode server RESTful API!

enjoy~🐸