XUPorter 使用教程

XUPorter 使用教程

项目介绍

XUPorter 是一个用于 Unity 3D 项目的开源工具，主要功能是在 Unity 项目生成 Xcode 工程后，自动添加文件和框架。它简化了在 Unity 项目中接入不同 SDK 的过程，通过在 Unity 中使用 [PostProcessBuild] 标签的函数，XUPorter 在构建后自动调用，添加或修改 iOS 工程配置。

项目快速启动

安装 XUPorter

1. 从 GitHub 项目中复制所有文件：

   git clone https://github.com/onevcat/XUPorter.git
   

2. 将复制的文件放入 Unity 项目的 Editor 目录下。

配置 projmods 文件

1. 确定一个存放 projmods 文件的目录。
2. 添加相关的 SDK 依赖文件。例如，创建一个 WeChatSDK.projmods 文件，内容如下：

   {
     "group": "WeChatSDK",
     "libs": ["libWeChatSDK.a"],
     "frameworks": ["CoreGraphics", "Security"],
     "headerpaths": ["WeChatSDK/Headers"]
   }
   

使用 XUPorter

在 Unity 项目中，创建一个脚本 PostProcessBuild.cs，内容如下：

using UnityEngine;
using UnityEditor;
using UnityEditor.Callbacks;
using System.IO;

public class PostProcessBuild
{
    [PostProcessBuild]
    public static void OnPostProcessBuild(BuildTarget target, string pathToBuiltProject)
    {
        if (target == BuildTarget.iOS)
        {
            // 调用 XUPorter 进行处理
            XUPorter.ProjectModifier.ModifyProject(pathToBuiltProject);
        }
    }
}

应用案例和最佳实践

接入微信支付 SDK

1. 创建 WeChatPay.projmods 文件，配置微信支付 SDK 的依赖。
2. 在 PostProcessBuild.cs 中调用 XUPorter 进行处理。

接入极光推送 SDK

1. 创建 JPush.projmods 文件，配置极光推送 SDK 的依赖。
2. 在 PostProcessBuild.cs 中调用 XUPorter 进行处理。

典型生态项目

Unity 与 iOS 交互

XUPorter 是 Unity 与 iOS 交互的重要工具之一。它可以帮助开发者自动化处理 iOS 工程的配置，减少手动操作，提高开发效率。

Unity 官方 xcodeapi

Unity 官方提供了 xcodeapi 工具，用于更深入地操作 Xcode 工程。虽然 XUPorter 已经能够满足大部分需求，但对于更复杂的操作，可以考虑使用 xcodeapi。

通过以上步骤，您可以快速上手并使用 XUPorter 工具，自动化处理 Unity 项目中的 iOS 工程配置。