懒到极致之怒撸一键打包发布系统

一切得从上个版本的打包发布说起。

开发中本人负责了iOS包的版本发布工作。iOS打包:不就是选一下证书,再在Xcode上点几下按钮,IDE全都给你设置好流程了,有必要这么麻烦吗?

诚然,如果只是打包,在不考虑团队协同合作、打包效率、重复工作量的前提下,使用Xcode自带的打包方式当然是没问题的。但实际开发中,每次打包大概包含以下流程:
拉取最新代码(SVN或Git)编译通过设置打包环境(开发、测试、生产等)导出IPA包上传IPA包(App Store或者企业包上传至指定服务器)

可以看出,其中的很多步骤都是机械重复的,特别当进入测试验收阶段,有时每修复几个bug就要重新打包发布测试,比如上个版本的时候新功能主要是队友在开发,测试到最后频繁地让我打包发布,不停地打断我的工作去重复机械的事情,这简直就是在浪费人生啊!!!

虽然之前为了打包方便,我已经整理了一份脚本打包的流程(传送门:Shell脚本——Xcode脚本打包),但还是不够方便快捷,乘着新版发布后的空档期,撸出 一键打包发布系统 ,功能包括:
自动拉取Git最新代码自动选择签名证书并打包导出ipa文件Git自动同步代码自动上传ipa包(我们是企业包,上传至自己的服务器,这一步是可选的)


一键打包

项目链接地址

一键打包资源(ArchiveSource)简介:
  • Code文件夹下是打包应用程序源代码
  • Source文件夹下是打包资源

Source文件夹:

  1. Archive.app(打包应用程序)
  2. ExportOptions.plist(导出ipa包配置文件)
一键打包步骤:
  1. 进入Source文件夹,启动 Archive 应用程序
  2. 选择 .xcodeproj 或 .xcworkspace 文件
  3. 修改打包版本号

启动Xcode,手动选择签名证书(如果默认签名失败的话)

  1. 点击打包
打包生成的IPA包路径说明:

../项目所在路径/Archiving/(以AppId命名的文件夹)/(App名+版本号命名的文件夹)/(以打包时间命名的文件夹)

示例:
../Archiving/(AppID)/(App名)_3_1_29/2018_04_10_11:18:51


一键打包原理

一键打包发布系统其实很简单:开发一款Mac应用,应用启动时读取本机已有的Certificates和Provisioning Profiles信息,再在应用内调用Shell脚本,主要通过脚本来实现Git同步以及打包的相关操作。

  • Shell脚本调用

Objective-C中调用Shell脚本可以使用 NSTask 。通过NSTask,我们可以在应用中调用另一个程序或运行一段脚本并获得其执行状态和最终结果,NSTask最为常用的一个场景是为命令行操作提供图形化的界面。

    //创建一个新的Task
    NSTask *optTask = [[NSTask alloc] init];
    //设置调用路径
    optTask.launchPath = shellPath;
    //设置调用参数(被调用程序命令)
    optTask.arguments = @[@"-ls"];
    //创建输出Pipe
    NSPipe *outputPipe = [NSPipe pipe];
    [optTask setStandardOutput:outputPipe];
    //创建错误输出Pipe
    NSPipe *errorPipe = [NSPipe pipe];
    [optTask setStandardError:errorPipe];

    //执行完成Block 通知
    optTask.terminationHandler = ^(NSTask *theTask) {
        [theTask.standardOutput fileHandleForReading].readabilityHandler = nil;
        [theTask.standardError fileHandleForReading].readabilityHandler = nil;
    };

    //错误输出
    [[errorPipe fileHandleForReading] setReadabilityHandler:^(NSFileHandle *file) {
        NSData *data = [file availableData];
        NSString *errorMsg = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"errorMsg = %@",errorMsg);
        
    }];
    //执行结果输出
    [[outputPipe fileHandleForReading] setReadabilityHandler:^(NSFileHandle *file) {
        NSData *data = [file availableData];
        NSString *msg = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"msg = %@",msg);
    }];

    //开启执行
    [optTask launch];
    //阻塞直到执行完毕(NSTask默认是异步执行,如果有同步需求,可调用waitUntilExit()方法)
    [optTask waitUntilExit];

    [[outputPipe fileHandleForReading] closeFile];
    [[errorPipe fileHandleForReading] closeFile];
  • 自动选择签名证书

获取电脑中以iPhone DistributioniPhone Developer命名开头的Certificates:

+ (void)loadCerListBlock:(CerListBlock)listBlock {
    NSDictionary *options = @{(__bridge id)kSecClass: (__bridge id)kSecClassCertificate,
                              (__bridge id)kSecMatchLimit: (__bridge id)kSecMatchLimitAll};
    CFArrayRef certs = NULL;
    __unused OSStatus status = SecItemCopyMatching((__bridge CFDictionaryRef)options, (CFTypeRef *)&certs);
    NSArray *certificates = CFBridgingRelease(certs);

    NSMutableArray  *tempArray=[NSMutableArray array];
    for (int i=0;i<[certificates count];i++) {
        SecCertificateRef  certificate = (__bridge SecCertificateRef)([certificates objectAtIndex:i]);
        NSString *name =  CFBridgingRelease(SecCertificateCopySubjectSummary(certificate));

        if ([name hasPrefix:@"iPhone Distribution"]||[name hasPrefix:@"iPhone Developer"]) {
            [tempArray addObject:name];
        }
    }
    listBlock(tempArray);
}

获取电脑中Provisioning Profiles:

//获取电脑中满足条件的Provisioning Profiles的路径
+ (NSArray *)getAllProvisioningProfileList{
    NSString  *path=[NSString stringWithFormat:@"%@/%@", NSHomeDirectory(), kMobileprovisionDirName];
    
    NSFileManager *fileManager=[NSFileManager defaultManager];
    
    NSArray *provisioningProfiles =[fileManager contentsOfDirectoryAtPath:path error:nil];
    provisioningProfiles = [provisioningProfiles filteredArrayUsingPredicate:[NSPredicate predicateWithFormat:@"pathExtension IN %@",  @[@"mobileprovision", @"provisionprofile"]]];
    
    return provisioningProfiles;
}

//自定义 YAProvisioningProfile ,将profile转换为对应实体
YAProvisioningProfile *profile = [[YAProvisioningProfile alloc] initWithPath:path];

根据App ID匹配 Profile 描述文件:

//根据appBundleIdentifier匹配 profile 描述文件
YAProvisioningProfile *selectProfile = nil;
for (YAProvisioningProfile *profile in profileArray) {
    // 查找与bundleIdentifier相等,描述文件不以 XC: 命名开头,而且是最新的文件
    if ([profile.bundleIdentifier isEqualToString:appBundleIdentifier] && ![profile.name hasPrefix:@"XC:"] && profile.newest) {
        selectProfile = profile;
        break;
    }
}
  • 读写Xcode工程配置

右键 XXX.xcodeproj 文件,显示包内容,可以看到project.pbxprojproject.pbxproj存储着 Xcode 工程的各项配置参数,我们可以通过脚本来直接读取或修改其配置,执行效果等同于在Xcode的General、Build Settings中的修改。

读取App Bundler Identifier:

# Pbxproj_Path指向 project.pbxproj 文件路径
configuration=$(grep -i "PRODUCT_BUNDLE_IDENTIFIER =" ${Pbxproj_Path})
Array=($(echo $configuration))
# project.pbxproj 中存在多行PRODUCT_BUNDLE_IDENTIFIER信息,从后往前读取
Bundle_Identifier=${Array[5]}
if [ ! -n $Bundle_Identifier ]
then
    Bundle_Identifier=${Array[3]}
fi
echo "Bundle_Identifier = ${Bundle_Identifier}"

修改配置信息:
修改 project.pbxproj 配置可以通过 sed 命令实现,比如将签名类型指定为Manual

key="CODE_SIGN_STYLE"
value="Manual;"
# 修改 project.pbxproj 配置,指定签名类型为手动选择
sed -i "" "s/$key =.*$/$key = $value/g" $Pbxproj_Path

如果程序成功读取到对应的证书签名,那么打包前需要修改的配置包括:

#修改 PRODUCT_BUNDLE_IDENTIFIER
changeConfiguration "PRODUCT_BUNDLE_IDENTIFIER" "${APP_ID};"

#修改 PROVISIONING_PROFILE
changeConfiguration "PROVISIONING_PROFILE" "\"${Profile_Name}\";"

#修改 PROVISIONING_PROFILE_SPECIFIER
changeConfiguration "PROVISIONING_PROFILE_SPECIFIER" "${Profile_Specifier};"

#修改 PRODUCT_NAME
changeConfiguration "PRODUCT_NAME" "${Scheme_Name};"

#修改 "CODE_SIGN_IDENTITY[sdk=iphoneos*]"
changeConfiguration "\"CODE_SIGN_IDENTITY\[sdk=iphoneos\*\]\"" '"iPhone Distribution";'

#修改 CODE_SIGN_STYLE
changeConfiguration "CODE_SIGN_STYLE" "Manual;"

#修改 ProvisioningStyle
changeConfiguration "ProvisioningStyle" "Manual;"

#修改 DEVELOPMENT_TEAM
changeConfiguration "DEVELOPMENT_TEAM" "${Development_Team};"

#修改 DevelopmentTeam
changeConfiguration "DevelopmentTeam" "${Development_Team};"

修改项目版本号:
Info.plist文件中CFBundleShortVersionString对应Version号,CFBundleVersion对应Build号,使用脚本可以直接指定版本号

# info.plist文件路径
InfoPlist_Path="${Project_Path}/${App_Name}/Info.plist"
# 如果是旧的项目,info.plist文件对应的名字为 (App_Name)-Info.plist
if [ ! -e "${InfoPlist_Path}" ];then
    InfoPlist_Path="${Project_Path}/${App_Name}/${App_Name}-Info.plist"
fi

/usr/libexec/PlistBuddy -c "Set :CFBundleShortVersionString ${Version_String}"  ${InfoPlist_Path}
/usr/libexec/PlistBuddy -c "Set :CFBundleVersion ${Version_String}" ${InfoPlist_Path}
  • 打包项目
# 指定打包模式为Release
Configuration="Release"
# 判断编译的项目类型是workspace还是project
if [[ ${Is_Workspace} == "YES" ]]; then
    # 编译前清理工程,>> ${Log_path} 表示将日志输出写入到Log_path文件
    xcodebuild clean -configuration "${Configuration}" -alltargets >> ${Log_path}

    # 自定义签名,指定签名证书
    if [[ ${Custom_Sign} == "YES" ]]; then
        xcodebuild archive -workspace "${Workspace_Path}" \
                       -scheme "${Scheme_Name}" \
                       -archivePath "${Xcarchive_path}" \
                       -configuration "${Configuration}" \
                       PROVISIONING_PROFILE="${Profile_Name}" \
                       CODE_SIGN_IDENTITY="${Sign_Identity}" \
                       >> ${Log_path}
    else
        xcodebuild archive -workspace "${Workspace_Path}" \
                       -scheme "${Scheme_Name}" \
                       -archivePath "${Xcarchive_path}" \
                       -configuration "${Configuration}" \
                       >> ${Log_path}
    fi
    

else
    # 编译前清理工程
    xcodebuild clean -configuration "${Configuration}" -alltargets >> ${Log_path}

    if [[ ${Custom_Sign} == "YES" ]]; then
        xcodebuild archive -project "${Xcodeproj_Path}" \
                           -scheme "${Scheme_Name}" \
                           -archivePath "${Xcarchive_path}" \
                           -configuration "${Configuration}" \
                           PROVISIONING_PROFILE="${Profile_Name}" \
                           CODE_SIGN_IDENTITY="${Sign_Identity}"\
                           >> ${Log_path}
    else
        xcodebuild archive -project "${Xcodeproj_Path}" \
                       -scheme "${Scheme_Name}" \
                       -archivePath "${Xcarchive_path}" \
                           -configuration "${Configuration}" \
                       >> ${Log_path}
    fi

fi
  • 导出IPA包
xcodebuild -exportArchive -archivePath "${Xcarchive_path}" -exportPath "${IPA_Archiving_Path}" -exportOptionsPlist "${ExportOptionsPlistPath}" >> ${Log_path}

Xcarchive_path指向上一步打包生成的*.xcarchive文件路径;IPA_Archiving_Path指向导出的*.ipa文件所在路径;ExportOptionsPlistPath对应ExportOptions.plist文件路径,ExportOptions.plist是使用xcodebuild -exportArchive指令导出ipa包时需要指定的配置文件

ExportOptions.png

  • compileBitcode:不上架App Store,Xcode是否启用Bitcode重新编译,默认为YES。
  • method:归档类型,包括app-store、ad-hoc、
    package、enterprise、development以及developer-id。
  • provisioningProfiles:打包证书信息,包含的字典信息格式:<key为App ID>:<value为对应的profile文件名>。
  • uploadBitcode:上线App Store是否开启Bitcode,默认为YES。
  • uploadSymbols:上线App Store,是否开启符号序列化,这是与查crash相关的,默认为YES。

关于更多的xcodebuild指令,可以通过xcodebuild -help查看。

  • 其他

其他部分还包括Git代码管理、IPA包上传、无效资源删除等,都可以直接通过NSTask执行脚本命令实现,比如拉取Git代码:git pull origin,当然前提是你本地的Git已经配置为免密操作。
如果你是使用SourceTree进行Git管理,而且是http模式,那么可以这样设置免密操作,第3步将远程仓库路径编辑为 http://用户名:密码@仓库地址 这样的方式;当然如果你是SSH模式,那么本身就支持免密码操作了。

SourceTree.png

上传IPA包。
我这里打的是企业包,所以只要将ipa文件上传到指定服务器就能够下载了(想了解更多关于企业包的下载信息,可以参照我的另一篇文章iOS如何部署企业包,以供他人下载)。一开始想着将自动上传也集成到打包程序内,但最后发现这涉及到内网间不同服务器以及账号验证过程,太过复杂暂时将这一部分阉割了……

写在最后

以上便是一键打包系统的功能讲解,想了解更多可以查看源码

CJShellDemo 说明:

ArchiveSource 一键打包程序资源
CrashScript 线上crash查找脚本
ReleaseDir Xcode打包脚本

欢迎点赞以及GitHub Star

最新补充

根据反馈发现:不同的Xcode版本构建的项目配置文件project.pbxproj会存在差异,另外不同用户电脑上的Provisioning Profiles也存在各种情况(比如团队中不同成员拥有不同名字的有效Profile)。

此时运行一键打包可能会失败!提示 重命名ipa包失败 或者 导出ipa包失败 ,这种情况下请关闭“默认签名”选项,同时打开Xcode在工程文件中手动选择对应打包证书后,再返回Archive.app执行一键打包。

关闭默认签名.png

应用打包截图


打包.png
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,837评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,551评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,417评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,448评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,524评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,554评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,569评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,316评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,766评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,077评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,240评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,912评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,560评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,176评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,425评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,114评论 2 366
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,114评论 2 352

推荐阅读更多精彩内容

  • 用到的组件 1、通过CocoaPods安装 2、第三方类库安装 3、第三方服务 友盟社会化分享组件 友盟用户反馈 ...
    SunnyLeong阅读 14,610评论 1 180
  • 取经行动662/1001(17.7.14) 你若想被爱,就要先去爱人; 你期望被人关心,就要先去关心别人; 你要想...
    石林萍阅读 254评论 0 4
  • 起床了没 想我了没 在干嘛 吃饭了吗 吃了 吃的啥 吃的…… 晚安 晚安 么么哒 千篇一律 从没放弃 因为爱 因为你
    李木只阅读 544评论 5 3
  • 【读经】 伯33章 【金句】 开通他们的耳朵,将当受的教训印在他们心上,好叫人不从自己的谋算,不行骄傲的事(原文是...
    chanor阅读 295评论 0 0