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

本文转自Unity Connect

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

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

请访问云盘下载示例项目

下载链接: https://pan.baidu.com/s/1JFWjbrh2x-qAsCzMwLywLA

提取码: 9a71

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()加载播放器。

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

image

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文件夹。

image

3、设置Xcode工作空间

Xcode工作空间允许同时处理多个项目,并结合它们的结果。 我们在Xcode打开NativeiOSApp.xcodeproj。选择File -> New -> Workspace,创建工作空间,把它保存在UaaLExample/both.xcworkspace。

image

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

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

image

4、添加UnityFramework.framework

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

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

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

image

5、公开NativeCallProxy.h

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

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

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

image

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

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

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

image

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

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

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

image

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

image

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

image

完整项目说明 在集成步骤中遇到问题,你可以尝试已经准备好构建和部署的完整项目,只需要修复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及更高版本。

1、下载和解压项目

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

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

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

image

2、生成Android平台的Gradle项目

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

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

image

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

image

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') 
image

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

implementation project(':unityLibrary')

image

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

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

image

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

image

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

image

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

image

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

image

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

完整项目说明

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

小结

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

原文链接:https://connect.unity.com/p/ru-he-jiang-unityyi-ku-xing-shi-ji-cheng-dao-yuan-sheng-ioshe-androidying-yong?app=true
更多Unity干货资源,请戳上方链接下载Unity官方app。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 160,585评论 4 365
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,923评论 1 301
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 110,314评论 0 248
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,346评论 0 214
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,718评论 3 291
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,828评论 1 223
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 32,020评论 2 315
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,758评论 0 204
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,486评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,722评论 2 251
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,196评论 1 262
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,546评论 3 258
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,211评论 3 240
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,132评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,916评论 0 200
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,904评论 2 283
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,758评论 2 274

推荐阅读更多精彩内容