美文网首页移动知识iOS进阶自动化打包
[iOS] 打包原理及脚本自动打包的实现

[iOS] 打包原理及脚本自动打包的实现

作者: objcat | 来源:发表于2018-12-10 11:27 被阅读144次

    前文链接

    [iOS]快速打包(仅限提测使用)
    https://www.jianshu.com/writer#/notebooks/4525183/notes/34587852

    前言

    9月份写了一篇- iOS快速打包 , 广受好评, 但是它的缺点也是不言而喻, 其一就是就是打包方法不官方, 其二是无法应用于AppStore, 所以我们只用它来快速生成测试包, 这样做无伤大雅; 而本篇文章主要讲的是Xcode官方的打包方法, 也就是图形化操作打包背后的原理, 顺便实现一下脚本自动打包, 下面就跟着我们的镜头一起来看吧.

    一.打包原理

    首先要说一下Xcode打包的过程, 我们写出的代码经过llvm进行build, 编译完成后会生成.app文件, 之后进行Archive归档, 然后进行Export导出, 这就是最基本的原理, 听起来是不是很简单, 那么我们下面就来用命令实现一个打包过程吧!

    那我们可以简单总结一下步骤:

    一.编译
    二.归档
    三.导出

    上述就是官方的打包原理了, 接下来我们就开始逐一实现.

    首先配置好你们的证书和描述文件


    1.build(编译)

    首先把证书和描述文件都选好, 之后执行命令xcodebuild, 工程文件分为两种, 不同类型的工程需要使用不同的命令, 一种是.xcworkspace工程文件, 我们经常使用的cocoapods导入依赖库后就会生成这样一个工作空间, 另一种是.xcodeproj也就是普通的Xcode工程

    workspace
    xcodebuild -workspace "/Users/sam/Desktop/TestPackage-workspace/TestPackage.xcworkspace" -scheme "TestPackage" -configuration "Debug"
    

    xcodebuild执行编译
    -workspace编译基于 xcworkspace
    -scheme 编译工程名
    -configuration 编译环境 Debug Release

    出现上面的画面说明编译成功了 如图所示可以查到到当中的编译文件生成路径 我们追过去看看吧


    我们可以看到.app文件就是经过上面命令编译生成的, 证书和描述文件都记录在TestPackage.xcodeproj里面, 所以都是自动选择的, 我们来看一看它的签名
    右键 -> 显示包内容

    我们可以看到签名文件在这里 说明编译过程中就已经根据环境自动签名了 而且这个签名是编译器根据工程文件中配置的文件自动选择的

    xcodeproj
    xcodebuild -project "/Users/sam/Desktop/TestPackage/TestPackage.xcodeproj" -configuration "Debug"
    

    普通的xcode工程编译起来也很简单 就是把-workspace修改成-project本片文章以.workspace为例, 其他的自行参悟

    2.Archive(归档)

    Archive翻译为存档, 归档, 是xcode记录打包结果的一种手段, 你有可能想不起来这个东西, 但是你认识这个么


    这个呢

    到这里你应该可以明白了, 你每次打包都会生成这么一个归档文件, 并且会以列表的形式显示出来, 这其实就是Archive文件, 它用来记录你的每次打包记录, 我先现在就看一看他在哪, 右键 show in finder

    我们可以看到这个灰色图标的文件就是我们归档的包, 我们右键显示包内容来参观一下

    我们可以看到, 它实际上就是.appInfo.plist以及一些其他文件组成的, 你可能从来没拆过它, 但是你拆与不拆, 它还在那里... - -我们继续

    之后我们就用命令来生成一个.xcarchive文件

    xcodebuild -workspace "/Users/sam/Desktop/TestPackage-workspace/TestPackage.xcworkspace" -scheme "TestPackage" -configuration "Debug" -archivePath "/Users/sam/Desktop/TestPackage.xcarchive" archive
    

    归档完成后就是这样


    我们可以看到归档这个命令和编译差不多, 只是多了一个-archivePath归档路径和一个archive表示归档的命令

    之后我们双击看看吧

    我们可以看到, 它自动加入到了我们的列表中, 到这里, 我相信你一定可以使用xcode来完成下面的导出操作了, 不过我们想要自动化构建项目一定是要用命令行来操作的, 我们继续往下看

    3.Export(导出)

    下面就是最激动人心的时刻了, 我们开始导出我们的项目

    xcodebuild -exportArchive -archivePath "/Users/sam/Desktop/TestPackage.xcarchive" -exportPath "/Users/sam/Desktop/TestPackage_export" -exportOptionsPlist "/Users/sam/Desktop/TestPackage 2018-12-07 17-29-35/ExportOptions.plist"
    

    -exportArchive 声明导出
    -archivePath xcarchive文件路径
    -exportPath导出文件夹路径 注意这里导出的并不是一个ipa而是一个文件夹
    -exportOptionsPlist 导出配置

    你可能会说前面几个参数你都懂, 但最后那个plist是什么, 怎么获取, 这个其实是最简单的, 首先你先用xcode手动导出个包 导出之后目录是这样的

    直接拷贝ExportOptions.plist路径拿过来用就可以了, 至于里面内容是什么, 自己去看 - -

    之后执行命令 如果没有问题的话 是可以导出ipa的

    好的我这里我们已经完成了所有步骤 我们接下来就用命令行导出一个.ipa上传到AppStore吧
    1.手动操作打包获取ExportOptions.plist文件
    2.使用打包命令来打包

    我们写成一个脚本
    这里可以看到 我直接使用了archive, 这是因为archive的作用是先编译归档, 所以不用预先编译了

    # archive
    xcodebuild -workspace "/Users/sam/Desktop/TestPackage-workspace/TestPackage.xcworkspace" -scheme "TestPackage" -configuration "Release" -archivePath "/Users/sam/Desktop/TestPackage.xcarchive" archive
    # 导出ipa
    xcodebuild -exportArchive -archivePath "/Users/sam/Desktop/TestPackage.xcarchive" -exportPath "/Users/sam/Desktop/TestPackage_appstore" -exportOptionsPlist "/Users/sam/Desktop/TestPackage 2018-12-07 17-43-02/ExportOptions.plist"
    

    我们上传AppStore试试

    我们可以看到, 包是上传成功的, 证明这种打包方法是完全有效并且正规的.

    之后我们去AppStore Connect查看一下吧

    我们可以看到 项目已经在上面了 接下来我们就是用TestFlight来测试一下吧!

    能在手机上运行可以证明这种方法是完全正确的.

    之后我们对脚本进行一下优化, 试想有这样一种情况, 你有很多的app, 你不会为所有的应用都分别写一个脚本, 这样岂不是太麻烦了, 所以这里我们使用脚本传参的方式来优化一下.

    我们可以看到, 想要自动打包一个工程需要上面那些参数, 下面我们就来完善一下

    # 工程文件路径
    APP_PATH=$1
    # 获取文件名与后缀 - xxx.xcworkspace
    BASE_NAME=$(basename ${APP_PATH})
    # 编译工程名
    APP_SCHEME=${BASE_NAME%.*}
    # 归档路径
    ARCHIVE_PATH="/Users/sam/Desktop/${APP_SCHEME}.xcarchive"
    # 编译环境
    CONFIGURATION=$2
    # 导出路径
    EXPORT_PATH="/Users/sam/Desktop/${APP_SCHEME}_appstore"
    # plist路径
    PLIST_PATH=$3
    
    # archive
    xcodebuild -workspace "${APP_PATH}" -scheme "${APP_SCHEME}" -configuration "${CONFIGURATION}" -archivePath "${ARCHIVE_PATH}" archive
    # 导出ipa
    xcodebuild -exportArchive -archivePath "${ARCHIVE_PATH}" -exportPath "${EXPORT_PATH}" -exportOptionsPlist "${PLIST_PATH}"
    

    然后运行脚本

    sh package.sh /Users/sam/Desktop/TestPackage-workspace/TestPackage.xcworkspace Release /Users/sam/Desktop/TestPackage_ex/ExportOptions.plist
    

    $1, $2, $3分别是命令中传递的三个参数, 之后我们运行脚本

    image.png

    发现是可以打包成功的, 到这里已经实现了脚本自动打包了, 而且是官方正规方法, 那么接下来, 你有可能还是觉得不爽, 每次都执行这个命令行也太麻烦了! 这里提供一种解决方案使用AlfredWorkflows来执行脚本

    finally enjoy it.

    by objcat

    2018.12.10

    相关文章

      网友评论

      本文标题:[iOS] 打包原理及脚本自动打包的实现

      本文链接:https://www.haomeiwen.com/subject/hiithqtx.html