Notifications
Article
在原生iOS或Android应用中将Unity作为库使用
Published 21 days ago
318
2
Unity 2019.3将添加支持,可以将Unity作为原生Android/Java和iOS/Objective C应用控制的库,以便轻松加入AR和其它Unity功能。
在一些情况下,使用Android/Java和iOS/Objective C等原生平台技术的开发者可能希望在应用或游戏中加入Unity提供的功能,通常用于3D或2D实时渲染。
从Unity 2019.3.a2开始,我们通过把Unity运行时组件和内容集成到原生平台项目,在原生应用中将Unity作为库使用。Unity Runtime Library公开了控制功能,从而在原生应用中管理加载、激活和卸载的时间和方式。
这意味着开发者可以将Unity所能实现的增强现实AR、3D/2D实时渲染、2D迷你游戏等功能,直接添加到自己的原生移动应用。
请注意:将Unity作为库使用,要求开发者对Android/Java和iOS/Objective C的架构有着深入的了解。
限制
我们测试了很多种将Unity作为库并由原生应用托管的情况,但由于Unity不再控制运行时的生命周期,因此我们无法确保它可以在所有用例都正常工作,例如:
1、作为库使用的Unity仅支持全屏渲染,不支持在屏幕的一部分进行渲染。
2、不支持加载多个Unity运行时实例。
3、开发者需要调整第三方插件,包括原生插件和托管插件,从而让它们正常工作。
项目结构改变
Unity运行时库会公开控制功能,以管理在原生应用中加载,激活和卸载的时间和方式。移动应用的构建过程总体上依旧相同,Unity将创建iOS Xcode和Android Gradle项目。
为了启用该功能,我们修改了生成iOS Xcode和Android Gradle项目的结构,结构如下:
1、库:iOS框架和Android Archive(AAR)文件,包含所有源文件和插件。
2、精简的启动器:包含应用程序展示数据,它会运行库部分。
我们将在后续文章中,提供关于如何把iOS / Android库部分加入到原生应用程序的分步讲解。下面介绍Xcode项目和Android Gradle项目的变化。
iOS
主要功能围绕Xcode项目展开,以获得名为UnityFramework的额外目标。此目标包括源/插件和依赖框架,并生成UnityFramework.framework文件。启动屏幕,Xib,图标,数据等保留在Unity-iPhone目标中。Unity-iPhone目标将对UnityFramework目标具有单一依赖性。
UnityFramework提供简单的API来管理播放器从本机端加载/卸载,在需要时暂停/取消暂停,向游戏对象发送消息并设置播放器数据文件夹所在的捆绑包,这样就可以在一个地方拥有Unity播放器需要运行的所有框架文件。
改变
将Unity作为库的功能对API和Xcode项目结构带来了一些变化。
对于大多数用例而言,所有内容会和原先一样工作,但如果你开发或使用插件、自定义BuildPostProcessor、PBXProject和CI,即使在开发者没有将Unity作为库使用,这些变化也可能会影响项目。
1、PBXProject
PBXProject.GetUnityTargetName和pbxProject->TargetGuidByName(“Unity-iPhone”)都已经被弃用。
我们改为使用pbxProject->GetUnityFrameworkTargetGuid(),它用于源代码、插件、依赖框架和源代码构建选项,或使用pbxProject->GetUnityMainTargetGuid()。使用已弃用函数会遇到异常。
如何在资源包或自定义后处理程序中,同时支持旧的和新的代码路径?
a、在允许情况下使用插件导入器功能,例如:指定额外框架。
b、使用反射。

2、ProjectCapabilityManager
ProjectCapabilityManager现在会接收目标的全局唯一标识符GUID。
3、xcodebuild
一些构建设置拥有后缀来指定确切目标,这些后缀有:*_APP表示应用目标,*_FRAMEWORK表示框架目标。
在构建xcodebuild时,这样使用加入后缀的版本:
PRODUCT_NAME -> PRODUCT_NAME_APP
PROVISIONING_PROFILE -> PROVISIONING_PROFILE_APP
PROVISIONING_PROFILE_SPECIFIER -> PROVISIONING_PROFILE_SPECIFIER_APP
OTHER_LDFLAGS -> OTHER_LDFLAGS_FRAMEWORK
示例
将Unity作为库集成到原生iOS应用的示例,请参考:
https://forum.unity.com/threads/integration-unity-as-a-library-in-native-ios-app.685219/

Android
如果使用Unity作为库,Android Gradle项目的结构会发生改变。如果使用自定义mainTemplate.gradle或AndroidManifest.xml,这些改变也会影响项目或Unity插件。
此前,Unity会使用单个Gradle模块来构建Android应用。现在,Unity会使用二个模块创建Gradle项目,即:unityLibrary模块和启动器模块。
改变
unityLibrary模块包含Unity运行时和项目数据。该模块是一个可以轻松集成到任何其它Gradle项目中的库,也可以把Unity嵌入到现有原生Android项目中。
启动器模块包含所有图标和应用名称,它是一个简单的Android应用程序,可以启动Unity。
1、Gradle项目结构
将Unity作为库会提供新的Gradle项目结构,它会更好的符合Android Studio项目最佳结构。该结构中有一个根文件夹,其中包含一些可以单独构建和使用的子项目。它让导入Unity Android Studio项目更加简单。
2、Gradle模板工作流程
Gradle模板会描述和配置使用Gradle构建Android应用的方法。每个Gradle模板代表一个Gradle项目,Gradle项目可以包括和依赖其它Gradle项目。
将Unity作为库的Gradle模板文件如下:
1、baseProjectTemplate.gradle:包含所有其它模板和Gradle项目共享的配置,即Android Gradle插件上的代码库和依赖。
2、launcherTemplate.gradle:包含如何构建Android应用的指令,例如:打包,签名和APK分离等,具体取决于unityLibrary项目,它会输出一个APK文件或App Bundle。
3、mainTemplate.gradle:包含如何把Unity构建为库的指令,它会输出.aar格式文件,用户可以提供自定义模板来重写Unity模板,包括编辑器设置。
4、libTemplate.gradle:与之前的工作方式相同。
清单工作流程
将Unity作为库会改变Unity Android应用清单文件的使用方式。此前会有一个AndroidManifest.xml文件,用于给Android应用提供图标、行为、权限和其它设置。
使用新系统后,我们有二个清单文件,而不是一个:
1、LauncherManifest.xml:负责处理图标、应用名称、开始行为及其目的、安装位置、支持的屏幕大小和设置“isGame”。
2、LibraryManifest.xml:负责声明Unity行为、权限、Unity行为使用的主题、VR模式、VR性能、使行为不可以调整大小、设置最大高宽比、应对配置改动、朝向、启动模式、Android UI硬件加速、使用的功能,例如游戏手柄或图形API和槽口支持。该清单文件可以通过在Plugins/Android文件夹中提供自定义AndroidManifest.xml文件来重写。
示例
将Unity作为库集成到原生Android应用的示例,请参考:
https://forum.unity.com/threads/integration-unity-as-a-library-in-native-android-app.685240/

推动改变营销的技术
作为库的Unity可以为不同行业的各种用例提供巨大优势,品牌和创意公司可以轻松地把AR直接加入原生移动应用。
前沿品牌会看到添加AR到传统营销活动的价值,由于Unity支持把Unity用作库,因此添加过程会得到简化。品牌和创意公司不再需要重新构建应用以加入AR功能,或自己开发解决方案来把Unity用作库。
消费者已经准备好迎接AR营销,AR让品牌和消费者建立起个人关系,我们很高兴提供推动营销发展的解决方案。
了解品牌和创意公司如何使用Unity,请访问Unity解决方案网站:
https://unity.com/solutions/brands-and-creative-agencies
更多Unity最新信息,请关注Unity 官方微信(Unity官方平台)。
Tags:
Unity China
611
Comments
zero
18 days ago
code
😅😅😅
1
R
RobertRoth
19 days ago
Among the products listed on the site, which one is the best? https://latestmusicalinstrument.com/best-ukulele-for-beginner/
0