IPALane

#ipa打包、分发测试

##1.打包

###xcodebuild Apple的命令行打包工具 #####下载xcodebuild(Command Line Tools Package) 或命令行执行xcode-select --install #####使用举例：导出ipa包

xcodebuild clean install
xcodebuild -project marathon.xcodeproj -scheme marathon archive -archivePath ./
xcodebuild -exportArchive -exportFormat IPA -archivePath ../marathon.xcarchive -exportPath ./

###xctool

xctool是Apple的xcodebuild基础上的封装；操作更简便

###shenzhen

命令行生成、分发ipa包到各平台(iTunes Connect、fir.im等)
支持命令行方式查看ipa信息

###gym

Fastlane的部分工具之一；可以替代shenzhen
创建打包有签名的ipa包，支持TestFlight(iTunes Connect)方式分发测试

##2.分发平台

###蒲公英

支持命令行分发ipa

###fir.im

非企业账号安装app需要添加UDID
支持命令行生成、分发ipa

###TestFlight(iTunes Connect)

内部测试者：最多25个
外部测试者：最多1000个
- 不需要添加UDID，只需要提供邮箱

##3.分发 ###Fastlane

命令行打包、分发、邀请tester的工具链
- deliver • snapshot • frameit • PEM • sigh • produce • cert • codes • spaceship • pilot • boarding • gym
- deliver
  - 将ipa包命令行方式分发到iTunes Connect中
- snapshot
  - 自动截图
- spaceship
  - ...
- pilot
  - 管理builds和测试者
- boarding
  - 邀请外部测试者
支持TestFlight
支持多航线分发，可选择分发到不同平台：蒲公英、fir.im、TestFlight(iTunes Connect)

##4.方案 ###非TestFlight分发测试

shenzhen
shenzhen + deliver

###TestFlight分发测试

gym + deliver
Fastlane

##5.举例(Fastlane) ###5.1 安装以下工具

###5.2 配置Xcode工程文件

选择TARGET下Build Settings中Code Signing选项
Code Signing Identity 选为iOS Distribution;Provisioning Profile 选为Automatic,值填$(PROFILE_UDID)
参照CodeSigning->Best Solution: Using environment variables

###5.3 运行Fastlane命令后，配置Fastfile

lane beta(TestFlight) 配置如下

 lane :beta do
 sigh
 ENV["PROFILE_UDID"] = lane_context[SharedValues::SIGH_UDID]
 gym(scheme: "marathon")
 deliver(beta: true)    
end

lane pgyer(蒲公英) 配置如下

 lane :pgyer do
 ENV["PROFILE_UDID"] = lane_context[SharedValues::SIGH_UDID]
 gym(scheme: "marathon",use_legacy_build_api: true)
 sh "../pgyer.sh"

end

lane fir(fir.im) 配置如下

 lane :fir do
 ENV["PROFILE_UDID"] = lane_context[SharedValues::SIGH_UDID]
 gym(scheme: "marathon",use_legacy_build_api: true)
 sh "../fir.sh"

end

参照CodeSigning->Best Solution: Using environment variables

###5.4 配置渠道脚本

####pgyer.sh(蒲公英)

	pwd
	#切换到目标目录
	cd ..
	pwd
	
	#替换ipa文件名
	curl -F "file=@{$filePath}" \
	#替换uKey（User Key）和_api_key（API Key）
	-F "uKey={$uKey}" \
	-F "_api_key={$apiKey}" \
	http://www.pgyer.com/apiv1/app/upload

其中：

{$filePath}是应用安装包文件的路径
{$uKey}是开发者的用户 Key，在应用管理-API中查看
{$apiKey}是开发者的 API Key，在应用管理-API中查看

见蒲公英

####fir.sh(fir.im)

	pwd
	#切换到目标目录
	cd ..
	pwd
	
	#发布应用到fir.im(配置生成的ipa名和fir.im API  Token)
	fir p path/to/application -T YOUR_FIR_TOKEN

见fir-cli

###5.5 工程目录结构

projectName
- framework
- projectName
- projectName.xcodeproj
- projectNameTests
- fastlane
  - Appfile
  - Deliverfile
  - Fastfile
- fir.sh
- pgyer.sh

##6.常见问题 ###6.1 Ruby类库安装不了？选择RubyGems 镜像(淘宝网) ###6.2 fastlane配置文件中带自定义脚本，运行命令时出现 Permission denied - ../xx.sh

是脚本文件权限不够，修改脚本权限：sudo chmod a+x ./xx.sh

###TODO

deliver/fastlane分发ipa到iTunes Connect不支持TestFlight?
- fastlane已支持TestFlight
管理provision
IPALane优化
- 支持多target配置
- 支持多Configuration配置

purplepeng/IPALane

IPALane