XUPorter 使用教程

1. 项目的目录结构及介绍

XUPorter 是一个用于自动化添加 iOS SDK 配置的工具，它可以简化 Unity 项目中接入不同 SDK 的过程。以下是 XUPorter 项目的目录结构及介绍：

XUPorter/
├── Editor/
│   ├── XUPorter.cs
│   ├── XUPorter.projmods
│   └── ...
├── README.md
└── ...

• Editor/: 包含 XUPorter 的核心脚本和配置文件。
  • XUPorter.cs: 主要脚本文件，负责在 Unity 构建后自动调用，添加或修改 iOS 工程配置。
  • XUPorter.projmods: 配置文件，用于配置 SDK 的动态链接库、框架、头文件路径等。
• README.md: 项目的说明文档，包含基本的使用方法和介绍。

2. 项目的启动文件介绍

XUPorter 的启动文件是 XUPorter.cs，该文件通过在 Unity 中使用 [PostProcessBuild] 标签的函数，在构建后自动调用，添加或修改 iOS 工程配置。以下是 XUPorter.cs 的主要内容：

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

public class XUPorter
{
    [PostProcessBuild]
    public static void OnPostProcessBuild(BuildTarget target, string pathToBuiltProject)
    {
        if (target == BuildTarget.iOS)
        {
            // 自动添加或修改 iOS 工程配置
            // 具体实现代码
        }
    }
}

• [PostProcessBuild]: 标签标注的函数，在 build player 结束后会自动调用。
• OnPostProcessBuild: 函数名，参数 target 表示构建目标，pathToBuiltProject 表示构建后的项目路径。

3. 项目的配置文件介绍

XUPorter 的配置文件是 XUPorter.projmods，该文件用于配置 SDK 的动态链接库、框架、头文件路径等。以下是 XUPorter.projmods 的主要内容：

{
    "group": "SDK名称",
    "libs": [
        "libSDK.a"
    ],
    "frameworks": [
        "SDKFramework.framework"
    ],
    "headerpaths": [
        "SDK/Headers"
    ]
}

• group: 组名称，可以简单理解为该配置的名称。
• libs: 动态链接库列表。
• frameworks: 框架列表。
• headerpaths: 头文件路径列表。

通过配置 XUPorter.projmods 文件，可以自动化添加或修改 iOS 工程的配置，简化接入不同 SDK 的过程。