iOS脚本打包和持续集成

BWiOSPackage

iOS Continuous Integration

Github：https://github.com/bobwongs/BWiOSPackage

Contents

iOS Xcode Project

Xcode打包

脚本打包

iOS ipa包

持续集成

自动化测试

Reference

经验总结

Follow Me

iOS Xcode Project

Workspace

简单来说，Workspace就是一个容器，在该容器中可以存放多个你创建的Xcode Project， 以及其他的项目中需要使用到的文件。使用Workspace的好处有，1),扩展项目的可视域，即可以在多个项目之间跳转，重构，一个项目可以使用另一个项目的输出。Workspace会负责各个Project之间提供各种相互依赖的关系;2),多个项目之间共享Build目录。

Project

指一个项目，该项目会负责管理生成一个或者多个软件产品的全部文件和配置，一个Project可以包含多个Target。

Target

一个Target是指在一个Project中构建的一个产品，它包含了构建该产品的所有文件，以及如何构建该产品的配置。

Scheme

一个定义好构建过程的Target成为一个Scheme。可在Scheme中定义的Target的构建过程有：Build/Run/Test/Profile/Analyze/Archive

Build Setting

配置产品的Build设置，比方说，使用哪个Architectures？使用哪个版本的SDK？。在Xcode Project中，有Project级别的Build Setting，也有Target级别的Build Setting。Build一个产品时一定是针对某个Target的，因此，XCode中总是优先选择Target的Build Setting，如果Target没有配置，则会使用Project的Build Setting。

Build Phases

Target Dependencies

Compile Sources（编译资源，可设置Compiler Flags）

Link Binary With Libraries

Copy Bundle Resources（直接拷贝到包里面的资源）

Run Script（运行脚本，运行脚本不用拷贝到Bundle

Xcode打包

打包机制

流程
xcodebuild -> Package；

xcodebuild

流程细节
Check dependencies（检查项目配置，如Code Sign） -> Preprocessor -> Compile -> Link -> Copy Resource、Compile Xib、CompileStoryboard、CompileAssetCatalog -> Generate DSYM File -> ProcessProductPackaging -> Code Signing（需要访问钥匙串信息） -> Validate -> Result；

Result
.app和.DSYM；

Code Signing

Code Signing Identity

Provisioning Profile

Reference：Terminal执行命令，查看输出信息

Package

把.app文件放入命名为“Payload”的新建文件夹中，对“Payload”文件夹进行压缩，对压缩生成的文件修改后缀名为.ipa，这样，就能生成有效的ipa包了；

Xcode可视化打包

Select Generic iOS Device -> Xcode Menu Bar - Product -> Archive -> Select Package Type -> Select Provisoning Profile -> Export ipa or Upload to App Store

脚本打包

脚本打包思路设计

配置参数设计

脚本修改项目配置和项目代码

xcodebuild clean和remove上次打包生成的文件

xcodebuild

Package, Denominate ipa file, Move files

Back up DSYM

配置参数设计

Configuration-Release or Debug

后台环境

包类型

App Store

InHouse

Adhoc

Bundle ID

App版本号

App Display Name

命令

xcodebuild命令

可构建的对象

workspace：必须和“-scheme”一起使用，构建该workspace下的一个scheme。

project：当根目录下有多个Project的时候，必须使用“-project”指定project，然后会运行

target：构建某个Target

scheme：和“-workspace”一起使用，指定构建的scheme。

构建行为

clean:清除build目录下的文件，build目录和其子目录没有被移除

build: 构建

test: 测试某个scheme，必须和"-scheme"一起使用

archive:打包，必须和“-scheme”一起使用

获取参数

$1、$2。。。、$n,n代表参数编号，$0为第一个参数，在此为脚本的路径，$#获取参数个数

param1=$1
param2=$2

文件操作

查找文件

命令：find

修改文件

修改文件名

命令：mv（move files）

mv file.txt new_file.txt  # 带上文件格式
mv directory new_directory  # 修改目录名

查找和修改文件内容

命令：sed（stream editor）

替换指定文本
sed -i ".tmp" "/words_to_find_which_line/s/replaced_word/new_word/" file_path
参数说明
-i：备份原文件，修改文件的操作不可逆，如果需要查看原来的内容，则可以在备份文件中进行查看，此脚本执行之后会生成一个.tmp文件，谨慎进行移除
.tmp：备份的原文件名称
words_to_find_which_line：通过文本找到需要修改的目标文本属于哪一行
s：替换操作
replaced_word：被替换的文本
new_word：新文本
替换目标位置文本
sed -i ".tmp" "/words_to_find_which_line/s/regular_expression/new_word/" file_path
示例
sed -i ".tmp" "/kEnvironment/s/=.*;/= new_tag;/" file_path  # 更换kEnvironment的值，不修改其余部分，如后面对代码的注释
说明
.*：正则表达式规则，“.”表示任意字符，“*”表示任意长度

移除文件

命令：rm（remove）

rm path/file.format  # 移除文件
rm -r path/directory  # 移除目录，-r命令可以删除非空目录

移动文件：mv（move files）

mv file_path/file.format new_file_path/new_file.format

项目的脚本

本项目Shell脚本放置在工程根目录下，脚本文件为package.sh；

Reference

终端查看对应的Manuel手册

待完善

脚本读取和修改Xcode工程文件信息，如版本号、包类型、授权文件等；

脚本中的参数编写需要设计得更加灵活；

学习方向

正则表达式

Shell Script

操作文本能力的提高

Python脚本的学习

iOS ipa包

ipa包的解压

修改后缀名，把后缀名修改为Mac OS可解压的，如：ipa -> zip；

.app包转换为有效的.ipa包

方式一：把.app文件拖入iTunes“我的应用”，再从iTunes中拖出来，就是一个.ipa文件啦；

方式二：把.app文件放入命名为“Payload”的新建文件夹中，对“Payload”文件夹进行压缩，对压缩生成的文件修改后缀名为.ipa；

从优秀App的ipa包中提炼信息

如微信等知名应用的ipa包；

持续集成

持续集成

编译，发布，自动化测试

目的

减少风险

减少重复过程

自动化构建

自动化构建的的首要前提

Anyone should be able to bring in a virgin machine, check the sources out of the repository, issue a single command, and have a running system on their machine.

自动化构建的的首要前提是有一个支持自动化构建的命令行工具，可以让开发人员可以通过一个简单的命令运行当前项目。

命令行工具

自动化构建的命令行工具比持续集成的概念要诞生得早很多，几十年前，Unix世界就已经有了Make，而Java世界有Ant，Maven，以及当前最流行的Gradle，.Net世界则有Nant和MSBuild。作为以GUI和命令行操作结合的完美性著称的苹果公司来说，当然也不会忘记为自己的封闭的iOS系统提供开发环境下命令行编译工具：xcodebuild

持续集成平台Jenkins

待研究，下载不了Jenkins

自动化测试

自动化测试

Reference

构建iOS持续集成平台（一）——自动化构建和依赖管理：http://www.infoq.com/cn/articles/build-ios-continuous-integration-platform-part1/

一步一步构建iOS持续集成:Jenkins+GitLab+蒲公英+FTP：http://www.jianshu.com/p/c69deb29720d

手把手教你利用Jenkins持续集成iOS项目：http://gold.xitu.io/post/57b01d50128fe10055bbc6d5

Jenkins：https://jenkins.io/index.html

Manual：xcodebuild

经验总结

Mac OS Terminal中的Shell脚本命令操作后不可以撤销

Xcode Command+B是按照当前设定的Scheme进行Build，而不是固定选择Release进行Build

Follow Me

Github:https://github.com/BobWongs