XUPorter 使用教程

XUPorter 使用教程

XUPorterAdd files and frameworks to your Xcode project after it is generated by Unity 3D.项目地址:https://gitcode.com/gh_mirrors/xu/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 工程配置。

XUPorterAdd files and frameworks to your Xcode project after it is generated by Unity 3D.项目地址:https://gitcode.com/gh_mirrors/xu/XUPorter