Mac OS命令行流程 Unity项目打包出.ipa

做什么？

本文介绍在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项目的同级目录下创建以下三个目录：

1. /cache_archive/
2. /cache_builds/
3. /cache_exportOpts/

初次步骤

在初次执行出包流程时，使用Xcode GUI编辑器执行一次完整的ipa流程以确保能成功出ipa包。

1. 配置签名和证书

   进入Unity-iPhone -> Signing & Capabilities -> All，进行证书配置，包括调试和发包ipa。

image.png

2. 获取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());
  }
}

常规步骤

1. 增加脚本执行权限

   在xcode项目根目录下，如果有无权限的脚本，给它加权限，例如，给MapFileParser.sh增加执行权限。

   chmod +x ./MapFileParser.sh
   

2. 打开终端

   打开终端，进入到Unity发布出来的Xcode项目根目录。

3. 使用xcodebuild清理+构建项目

   xcodebuild -project ./Unity-iPhone.xcodeproj/ -scheme Unity-iPhone -destination 'generic/platform=iOS' clean build
   

4. 生成打包归档xcarchive

   xcodebuild -project ./Unity-iPhone.xcodeproj/ -scheme Unity-iPhone -destination 'generic/platform=iOS' -archivePath ../cache_archive/unity.xcarchive archive
   

5. 使用xcodebuild导出IPA文件

   xcodebuild -exportArchive -archivePath ../cache_archive/unity.xcarchive -exportPath ../cache_builds/ -exportOptionsPlist ../cache_exportOpts/ExportOptions.plist
   

发包自动化

整个过程可以通过脚本执行和Jenkins结合，实现自动化打包出ipa。