如何将Unity以库形式集成到原生iOS和Android应用

从Unity 2019.3.a2开始，我们通过把Unity运行时组件和内容集成到原生平台项目，在原生应用中将Unity作为库使用。

本文将分享如何将Unity以库形式集成到原生iOS和Android应用。了解更多信息，请阅读：《在原生iOS或Android应用中将Unity作为库使用》。

下载示例项目

本文提供可以构建和部署的完整项目，请发送“集成应用”到微信后台，获得示例项目下载地址。

iOS

请iOS开发者使用Unity 2019.3.a2及更高版本，以及Xcode 9.4及更高版本。

下载Unity 2019.3.a2：

https://unity3d.com/alpha/2019.3

1

下载和解压项目

我们会把该Unity项目加入到原生iOS应用，Assets/Plugins/iOS文件夹中的文件用于使Unity播放器和原生应用进行通信。

我们提供了一个简单的Xcode单视图应用，该项目拥有UI，可以使用UnityFrameworkLoad()加载播放器。

为了方便起见，我们把二个项目解压到相同文件夹下。

2

生成iOS的Xcode项目

我们按正常操作生成Xcode项目即可。

首先在Unity编辑器打开UnityProject项目，选择Menu -> Window -> Package Manager，因为2.0.8版本不兼容使用Unity作为库，所以要移除Ads资源包，或更新Ads资源包到v 3.*版本。

选择Menu -> Edit -> Player Settings -> Player -> iOS设置标签页 -> Identification Section，设置有效的Bundle Identification和Signing Team ID，以避免后续步骤出现Xcode签名问题。

打开Menu -> File -> Builds Settings，在此选择并切换平台为iOS。将UnityProject项目构建到iosBuild文件夹。

3

设置Xcode工作空间

Xcode工作空间允许同时处理多个项目，并结合它们的结果。

我们在Xcode打开NativeiOSApp.xcodeproj。选择File -> New -> Workspace，创建工作空间，把它保存在UaaLExample/both.xcworkspace。

关闭NativeiOSApp.xcodeproj项目，此后的步骤会在刚创建的工作空间项目完成。

选择File -> Add Files to “both”，把NativeiOSApp.xcodeproj和第2步生成的Unity-iPhone.xcodeproj添加到相同等级的工作空间。

4

添加UnityFramework.framework

我们以框架的形式添加Unity播放器到NativeiOSApp，它目前不会改变NativeiOSApp的行为。

首先从NativeiOSApp项目选择NativeiOSApp目标。在General -> Embedded Binaries中按下+按钮。选择Unity-iPhone/Products/UnityFramework.framework。

我们从Linked Frameworks and Libraries移除UnityFramework.framework，选中该条目并按下-按钮即可。

5

公开NativeCallProxy.h

原生应用会实现下面文件定义的NativeCallsProtocol。

首先找到并选择Unity-iPhone / Libraries / Plugins / iOS / NativeCallProxy.h。

然后在Target Membership中勾选UnityFramework，通过UnityFramework右侧的下拉图标，把标头可见性设为Public。

6

使Data文件夹成为UnityFramework的一部分

默认情况下，Data文件夹是Unity-iPhone目标的一部分，我们会通过修改它，使所有内容封装到单个框架文件中。

我们把Data文件夹的Target Membership改为UnityFramework。

在之前的改动后，为了使Unity-iPhone项目继续工作，Unity播放器需要通过从Unity-iPhone/MainApp/main.mm进行调用，指向Data文件夹所处的新位置。

[ufw setDataBundleId: "com.unity3d.framework"];

在这种情况下不支持按需使用资源。为了使它们正常工作，我们不会使用前面的调用，因为默认情况下Data文件夹位于mainBundle，所以我们要复制Data文件夹到原生应用，并跳过前面的调用。

运行

所有内容已经准备好针对二个项目进行构建，运行和调试，即：Unity-iPhone项目和NativeiOSApp项目，选择Scheme为NativeiOSApp或Unity-iPhone。

如果一切顺利，我们可以运行NativeiOSApp。

完整项目说明

在集成步骤中遇到问题，你可以尝试已经准备好构建和部署的完整项目，只需要修复Xcode的签名即可。

• NativeiOSApp目标

• Unity-iPhone目标（可选）

• UnityFramework目标不需要签名

请下载并解压完整项目文件，在Xcode打开both.xcworkspace，运行NativeiOSApp Scheme。

关键要点

Unity播放器由UnityFramework对象控制。为了获取该对象，我们要调用UnityFrameworkLoad，它会加载UnityFramework.framework，然后返回单个实例到UnityFramework类，请观察Unity-iPhone/UnityFramework/UnityFramework.h，了解它的API。

请在NativeiOSApp/NativeiOSApp/MainViewController.mm文件中或Unity-iPhone/MainApp/main.mm文件中观察UnityFrameworkLoad。

#include <UnityFramework/UnityFramework.h>

UnityFramework* UnityFrameworkLoad()

{

    NSString* bundlePath = nil;

    bundlePath = [[NSBundle mainBundle] bundlePath];

    bundlePath = [bundlePath stringByAppendingString: @"/Frameworks/UnityFramework.framework"];

    NSBundle* bundle = [NSBundle bundleWithPath: bundlePath];

    if ([bundle isLoaded] == false) [bundle load];

    UnityFramework* ufw = [bundle.principalClass getInstance];

    if (![ufw appController])

    {

        // 首次初始化Unity

        [ufw setExecuteHeader: &_mh_execute_header];   

        // 同步Data文件夹的Target Membership设置

        [ufw setDataBundleId: "com.unity3d.framework"];

    }

    return ufw;

}

Android

请Android开发者使用Unity 2019.3.a2及更高版本，以及Android Studio 3.3.2及更高版本。

下载Unity 2019.3.a2：

https://unity3d.com/alpha/2019.3

1

下载和解压项目

请下载Unity项目，该项目是要加入原生Android应用的示例Assets/Plugins/Android文件夹中有扩展UnityPlayerActivity的OverrideUnityActivity文件。

我们提供的原生Android项目是来自Android Studio模板的Basic Activity应用程序，我们会把前面的Unity项目加入到这里。该项目有UI和MainUnityActivity来扩展OverrideUnityActivity，可以使用Intent启动MainUnityActivity。

为了方便起见，我们把二个项目解压到相同文件夹下。

2

生成Android平台的Gradle项目

我们在Unity编辑器打开UnityProject项目，点击Menu -> File -> Build Settings打开Build Settings。

选择并切换为Android Platform，勾选Export Project选项。

我们把UnityProject导出到androidBuild文件夹，该文件夹结构如下图所示。

3

把Unity Library模块添加到NativeAndroidApp

现在把androidBuild/unityLibrary模块添加给Android Studio 中的NativeAndroidApp Gradle项目：

我们在Android Studio打开NativeAndroidApp，然后打开settings.gradle文件。在该文件末尾，添加指向unityLibrary的新项目。

include ':unityLibrary'

project(':unityLibrary').projectDir=new File('..\\UnityProject\\androidBuild\\unityLibrary') 

打开build.gradle文件，把下面代码添加到dependencies代码块。

implementation project(':unityLibrary')

打开build.gradle文件，把下面代码添加到allprojects{repositories{代码块。

flatDir {

   dirs "${project(':unityLibrary').projectDir}/libs"

}

Gradle文件已经修改，单击Sync Now。

如果一切顺利，我们会看到unityLibrary模块添加到Android视图中。

运行

现在已经准备好进行构建，运行和调试。

如果一切顺利，我们应该可以运行NativeAndroidApp。

请注意：在应用程序安装到设备后，会出现二个启动应用程序的图标，请把<intent-filter>...</intent-filter>从unityLibrary的AndroidManifest.xml去掉，仅保留集成版本。

完整项目说明

如果在集成步骤中遇到问题，你可以尝试已经准备好构建和部署的完整项目。请下载并解压完整项目文件，在Android Studio打开NativeAndroidApp。

小结

如何将Unity以库形式集成到原生iOS和Android应用为大家介绍到这里，请下载示例项目动手操作起来吧。

更多Unity最新信息，请关注Unity Connect平台(Connect.unity.com）。

下载Unity Connect APP，请点击此处。 观看部分Unity官方视频，请关注B站帐户：Unity官方。

推荐阅读

官方活动

活动一：Unity官方教师培训课程

7月29日－8月2日将举办Unity官方教师培训课程，现诚邀广大教师一同学习分享Unity最新技术，探讨Unity在教育教学中的创新应用。［了解详情......］

培训时间：7月29日－8月2日，共5天

报名地址：

https://www.bagevent.com/event/5329696

活动二：Unity K12暑期编程体验课报名开启

我们将从7月13日～8月24日每周六13:30-16:00举办Unity K12编程免费体验课程，欢迎10～15岁的青少年进行报名。［了解详情......］

报名地址：

https://www.bagevent.com/event/5330872 

喜欢本文，请点击“在看”