Unity 2018.4.5f1 LTS项目AR Core构建运行问题求助
问题描述
我接手了一个基于**AR Core(疑似AR Core Legacy)**实现家具放置功能的Unity项目,打算添加摄影测量(扫描家具生成3D模型)功能,但当前项目根本跑不起来。点击Build & Run(快捷键Ctrl+B)后,应用在设备上完全启动不了,不确定是Android SDK配置出问题,还是AR Core相关的锅。
遇到的报错情况:
- 构建阶段:Unity弹出构建失败提示,日志显示
AndroidManifest.xml找不到android:style/Theme.Material.Light.NoActionBar.Fullscreen资源。 - 设备端:安装后显示“未安装应用程序”,无法启动。
- 控制台日志:出现
Android resource linking failed错误,核心问题是主题资源缺失。
排查修复步骤
一、先搞定Android SDK与构建配置
- 检查Unity的
Edit > Preferences > External Tools,确认Android SDK路径指向正确的已安装目录,且SDK版本和项目Target API Level匹配(AR Core Legacy要求API 24及以上)。 - 打开Android SDK Manager,确保装了对应Target API的
Android Build Tools、Android SDK Platform,还有Google Play Services组件。 - 调整Unity Player Settings:
- 进入
Edit > Project Settings > Player > Android > Other Settings,把Package Name改成符合规范的格式(比如com.yourcompany.projectname)。 - 把
Internet Access设为Require,AR Core需要联网验证设备兼容性。 Minimum API Level设为24或更高,Target API Level选Automatic (highest installed)。- 替换缺失的主题:把
Theme.Material.Light.NoActionBar.Fullscreen换成Unity自带主题(比如UnityThemeSelector),或系统自带的Theme.Material.Light.NoActionBar,全屏需求后续单独通过代码配置。
- 进入
二、AR Core Legacy配置校验
- 打开
Window > Package Manager,搜索AR Core Legacy,确认已安装且版本与当前Unity版本兼容(比如Unity 2020.x搭配AR Core Legacy 1.28.x)。 - 检查场景AR组件:确保场景内存在
AR Session和AR Session Origin对象,AR Session的AR Core Settings需勾选Require AR Core。 - 验证设备兼容性:设备必须是Android 7.0(API 24)及以上,且在AR Core官方支持设备列表内。
三、构建流程排障
- 清理缓存:删除项目根目录的
Library、Temp文件夹,重启Unity后重新构建。 - 手动安装APK:构建完成后找到输出的APK文件,用
adb install -r [APK路径]命令安装到设备,查看终端返回的具体报错信息,定位问题更精准。 - 监控控制台日志:构建前切换到Android平台,打开Console窗口,仅显示
Error和Warning,排查构建过程中被忽略的细节报错。
四、摄影测量功能的前置注意
等启动问题解决后,添加摄影测量功能需注意:
- AR Core Legacy本身不带摄影测量能力,需借助第三方SDK(比如Google Model Maker API),要确保新SDK与现有AR Core Legacy版本兼容。
- 补充权限配置:摄影测量需要
CAMERA权限,可能还需要WRITE_EXTERNAL_STORAGE权限,在Player Settings的Permissions中勾选对应选项。
内容的提问来源于stack exchange,提问作者Wakeel Furqan Ahmed
相关产品推荐
相关产品推荐

