创建一个iOS自动化打包脚本

背景:

在此之前,我是使用过fastlane进行打包的,据我的了解,fastlane也是xcodebuildaltool等一系列xcode打包命令的集合。因为换了公司,公司的开发者账号并没有向全部开发者开放,所以功能更强大的fastlane在这里肯定是用不了了。但也不甘愿就此回到解放前(完全手动点击去打包。)

所以,就决定自己讲xcode打包命令集成到一个脚本上面,到时候自己运行脚本打包。这虽然不够完全自动化,但也能很大程度上省时省力了

废话到此结束,进入正题

xcodebuild

目前使用的xcode版本是9.4

xcodebuild -h: 查看xcodebuild改如何使用

在终端输入 xcodebuild -h 可以看到如下常用命令

➜  Desktop xcodebuild -h
Usage: xcodebuild [-project ] [[-target ]...|-alltargets] [-configuration ] [-arch ]... [-sdk [|]] [-showBuildSettings] [=]... []...
       xcodebuild [-project ] -scheme  [-destination ]... [-configuration ] [-arch ]... [-sdk [|]] [-showBuildSettings] [-showdestinations] [=]... []...
       xcodebuild -workspace  -scheme  [-destination ]... [-configuration ] [-arch ]... [-sdk [|]] [-showBuildSettings] [-showdestinations] [=]... []...
       xcodebuild -version [-sdk [|] [] ]
       xcodebuild -list [[-project ]|[-workspace ]] [-json]
       xcodebuild -showsdks
       xcodebuild -exportArchive -archivePath  -exportPath  -exportOptionsPlist 
       xcodebuild -exportLocalizations -localizationPath  -project  [-exportLanguage ...]
       xcodebuild -importLocalizations -localizationPath  -project 
       xcodebuild -resolvePackageDependencies [-project |-workspace ] -clonedSourcePackagesDirPath 

这里我主要介绍以下几个命令

  • xcodebuild clean : 清理项目缓存,等同于xcode快捷键shift+command+K
一般使用:
xcodebuild clean -workspace ${TARGET_NAME}.xcworkspace -scheme ${SCHEME_NAME} -configuration ${BUILD_TYPE}
  • xcodebuild archive : 导出.xcarchive文件
一般使用:
xcode9+:
xcodebuild archive -workspace ${TARGET_NAME}.xcworkspace -scheme ${SCHEME_NAME} -archivePath {ARCHIVEPATH}

xcode9之前
xcodebuild archive  -workspace ${TARGET_NAME}.xcworkspace  -scheme ${SCHEME_NAME}  -configuration ${BUILD_TYPE}  -archivePath "${ARCHIVEPATH}/${TARGET_NAME}.xcarchive" CODE_SIGN_IDENTITY=证书  PROVISIONING_PROFILE=描述文件UUID
  • xcodebuild -exportArchive : 导出ipa包
一般使用:
xcode9+
xcodebuild -exportArchive -archivePath "${ARCHIVEPATH}/${TARGET_NAME}.xcarchive" -exportPath ${EXPORTPATH} -exportOptionsPlist ${EXPORTOPTIONSPLIST}

xcode9之前
xcodebuild -exportArchive -archivePath "${ARCHIVEPATH}/${TARGET_NAME}.xcarchive"  -exportPath ${EXPORTPATH} -exportOptionsPlist "${EXPORT_PLIST}" CODE_SIGN_IDENTITY=证书  PROVISIONING_PROFILE=描述文件UUID

参数解释:

  • ${TARGET_NAME} 项目对应targets的名字
  • ${SCHEME_NAME} 项目对应的Scheme的名字
  • ${BUILD_TYPE} 打包类型 Debug,Release 等
  • ${archivePath} .xcarchive文件导出目录
  • ${EXPORTPATH} 导出.ipa包的目录
  • ${EXPORTOPTIONSPLIST} exportOptionsPlist文件所在目录,可判断development, ad-hoc等

从上面xcode9前后的打包命令就可以看出来,还是有点不一样的。xcode9之前有证书和描述文件信息这两个参数。没填xcode会找默认设置。xcode9之后,这两个参数被删除了。将这两个参数的信息放到了ExportOptions.plist这个文件里面。两者之前的差异如下:

xcode9之前的ExportOptions.plist文件信息





    method
    development
    teamID
    yourTeamID


xcode9之后的ExportOptions.plist文件信息





    compileBitcode
    
    method
    development
    provisioningProfiles
    
        com.xingshulin.abc
        abc_dev
        com.xingshulin.abc.NotificationServiceExtension
        abc-Notification-dev
    
    signingCertificate
    iPhone Developer
    signingStyle
    manual
    stripSwiftSymbols
    
    teamID
    yourTeamID
    thinning
    


所以xcode从8+升级到9一般会遇到以下错误。这就是这个文件的变化导致的。我们只需要提供对应的ExportOptions.plist文件就可以了。

error: exportArchive: "AppName.app" requires a provisioning profile with the Push Notifications and App Groups features.
Error Domain=IDEProvisioningErrorDomain Code=9
"AppName.app" requires a provisioning profile with the Push Notifications and App Groups features." UserInfo={NSLocalizedDescription="AppName.app" requires a provisioning profile with the Push Notifications and App Groups features., NSLocalizedRecoverySuggestion=Add a profile to the "provisioningProfiles" dictionary in your Export Options property list.}
// 或
"Error Domain=IDEProvisioningErrorDomain Code=9 \"\"ios-simple-objc.app\" requires a provisioning profile.\"
UserInfo={NSLocalizedDescription=\"ios-simple-objc.app\" requires a provisioning profile., NSLocalizedRecoverySuggestion=Add a profile to the \"provisioningProfiles\" dictionary in your Export Options property list.}"

下面说说怎么获取这个文件吧
1、可以自己创建一个plist文件,然后按照文件格式填上相关的参数就ok。

2、用xcode手动导出一个包。在导出的文件夹里面就有ExportOptions.plist这个文件,我拿来用就行了。

大概的目录结构如下

ipa包所在的文件夹
    ├── DistributionSummary.plist
    ├── ExportOptions.plist
    ├── ipa文件
    ├── Packaging.log

具体的脚本文件:

介绍完了打包的几个命令,就来说说打包的脚本文件吧。

具体内容如下:

##!/bin/sh

TARGET_NAME=hdproject ## 项目名
SCHEME=hdproject_test ## Scheme名
BUILD_TYPE=Debug      ## 编译类型
SORCEPATH=$( cd "$( dirname $0 )" & pwd )##当前目录
WORKSPACE=$SORCEPATH/../${TARGET_NAME}.xcworkspace ## workspace名
ARCHIVEPATH=$SORCEPATH/$TARGET_NAME.xcarchive      ##xcarchive文件的存放路径
EXPORTPATH=$SORCEPATH/$TARGET_NAME.ipa             ## ipa文件的存放路径
EXPORTOPTIONSPLIST=$SORCEPATH/ExportOptions.plist  ## ExportOptions.plist文件的存放路径

# 清理缓存
xcodebuild clean -workspace $WORKSPACE -scheme ${SCHEME} -configuration ${BUILD_TYPE}
# 输出关键信息
echo -e "  TARGET_NAME    : ${TARGET_NAME}"
echo -e "  BUILD_TYPE    : ${BUILD_TYPE}"
echo -e "  SORCEPATH    : ${SORCEPATH}"
echo -e "  ARCHIVEPATH    : ${ARCHIVEPATH}"
echo -e "  EXPORTPATH    : ${EXPORTPATH}"
echo -e "  EXPORTOPTIONSPLIST    : ${EXPORTOPTIONSPLIST}"

# 导出archive包
xcodebuild archive -workspace ${WORKSPACE} -scheme ${SCHEME} -archivePath $ARCHIVEPATH

#导出IPA包
xcodebuild -exportArchive -archivePath $ARCHIVEPATH -exportPath ${EXPORTPATH} -exportOptionsPlist ${EXPORTOPTIONSPLIST}

路径信息有疑问的可以结合项目目录结构来件,我的项目目录结构如下

项目根目录
    ├── ***.xcworkspace
    ├── ***.xcodeproj
    ├── build
        ├── ExportOptions.plist
        ├── build.sh 

其中build.sh为打包脚本文件,内容如上.

PS:后续还会将这篇文章完善。

1、包括代码管理。

2、ipa的发布。

3、jenkins自动化。

你可能感兴趣的:(创建一个iOS自动化打包脚本)