做什么？
本文介绍在Mac OS环境下，通过Unity项目发布iOS版本的Xcode项目，并使用脚本命令行的形式发布.ipa包。最后，将这个过程与Jenkins结合，构建一个自动化的ipa出包流程。
怎么做？
环境依赖
确保以下环境依赖已配置：
- 证书配置 (Provision Profile)
- IPA导出参数 (ExportOptions.plist)
关于ExportOptions.plist：
ExportOptions.plist是从archive导出ipa的参数配置文件。在GUI模式下导出ipa时，可以通过Xcode编辑器执行一次，导出目录将包含一个ExportOptions.plist文件。
新建目录
在Unity项目的同级目录下创建以下三个目录：
- /cache_archive/
- /cache_builds/
- /cache_exportOpts/
初次步骤
在初次执行出包流程时，使用Xcode GUI编辑器执行一次完整的ipa流程以确保能成功出ipa包。
-
配置签名和证书
进入Unity-iPhone -> Signing & Capabilities -> All，进行证书配置，包括调试和发包ipa。
-
获取ExportOptions.plist
重 归档xcarchive 打包 .ipa 时，中间的选项设置会形成一个,ExportOptions.plist的配置，获取它后我们在命令行打包时使用它。
3.放置ExportOptions.plist
将发布目录中的ExportOptions.plist文件拷贝到xcode项目根目录下的/cache_exportOpts/。
自动配置签名和证书
原理：修改 xcode项目中的 Unity-iPhone.xcodeproj/project.pbxproj 配置
1.方式一 ：编写文本维护程序
自行编写文本维护程序 ，来管理修改 project.pbxproj （不推荐）
2.方式二 ：Unity Build 过程修改 PBXProject
示例：
public class XcodeBuildPostprocessor
{
private static string CODE_SIGN_STYLE = "Manual";
//签名识别名 (可在xcode 手动打包时获得)
public static string CODE_SIGN_IDENTITY = "Apple Development: xxx xx (xxxxxx)";
//配置文件识别名 (可在xcode 手动打包时获得)
public static string PROVISIONING_PROFILE_SPECIFIER = "xxxDev";
[UnityEditor.Callbacks.PostProcessBuild(1002)]
public static void OnPostprocessBuild(UnityEditor.BuildTarget BuildTarget, string path)
{
if (BuildTarget == UnityEditor.BuildTarget.iOS)
{
string projPath = UnityEditor.iOS.Xcode.PBXProject.GetPBXProjectPath(path);
UnityEditor.iOS.Xcode.PBXProject proj = new UnityEditor.iOS.Xcode.PBXProject();
//读取 project.pbxproj 文件文本内容
proj.ReadFromString(System.IO.File.ReadAllText(projPath));
//Unity-iPhone 设置（项目主体名）
string target = proj.GetUnityMainTargetGuid(); // 2019
//设置手动证书、签名
//证书模式 设置
proj.SetBuildProperty(target, "CODE_SIGN_STYLE", CODE_SIGN_STYLE);
//签名识别名 设置
proj.SetBuildProperty(target, "CODE_SIGN_IDENTITY", CODE_SIGN_IDENTITY);
//配置文件识别名 设置
proj.SetBuildProperty(target, "PROVISIONING_PROFILE_SPECIFIER", PROVISIONING_PROFILE_SPECIFIER);
//修改后的 写入到 project.pbxproj 文本
File.WriteAllText(projPath, proj.WriteToString());
}
}
常规步骤
-
增加脚本执行权限
在xcode项目根目录下，如果有无权限的脚本，给它加权限，例如，给MapFileParser.sh增加执行权限。
chmod +x ./MapFileParser.sh -
打开终端
打开终端，进入到Unity发布出来的Xcode项目根目录。
-
使用xcodebuild清理+构建项目
xcodebuild -project ./Unity-iPhone.xcodeproj/ -scheme Unity-iPhone -destination 'generic/platform=iOS' clean build -
生成打包归档xcarchive
xcodebuild -project ./Unity-iPhone.xcodeproj/ -scheme Unity-iPhone -destination 'generic/platform=iOS' -archivePath ../cache_archive/unity.xcarchive archive -
使用xcodebuild导出IPA文件
xcodebuild -exportArchive -archivePath ../cache_archive/unity.xcarchive -exportPath ../cache_builds/ -exportOptionsPlist ../cache_exportOpts/ExportOptions.plist
发包自动化
整个过程可以通过脚本执行和Jenkins结合，实现自动化打包出ipa。
