文档

​
​

Development

User Acquisition

Monetization

工业

Build Automation

DevOps

Build Automation REST API

Build Automation Editor Package

Open Unity Dashboard

Build Automation

​
​
Build Automation
  • Overview
  • Get started with Build Automation
  • Build Automation Glossary
  • Build configuration
  • Advanced build configuration
  • Run builds
  • Check build results
    • Troubleshooting Build Automation failures
      • Builds fail immediately
      • Unrecognized project error
      • Clone hangs when you use Git submodules
      • Lightmap baking
      • Android build failures
      • Errors after migration to a new Xcode version
      • macOS notarization failure
      • Problems with iOS Build Automation during XCode export
      • iOS build can't download or install from Unity Build Automation
  • Optimize build speed
  • Manage consumption costs
  • Sign build artifacts
  • Build Automation integrations
  • Build Automation API
  • Build Automation Editor Package
  • Reference
  1. Unity Build Automation
  2. Build results
  3. Troubleshoot Build Automation failures

“项目无法识别”错误

Resolve unrecognized project errors in Unity Build Automation and configure project paths correctly.
阅读时间2 分钟
最后更新于 10 个月前

症状

构建失败并出现以下错误:
[error] Error: unrecognized project! Please check your app configuration - if this is a Unity application, We expect your "Project Subdirectory" to be set to the path which directly contains the ProjectSettings and Assets directories. For a native app, this should be set to the path which directly contains the project file (.xcodeproj, project.properties, etc).

原因

Unity Build Automation 仅支持对 Unity 项目进行构建。出现此错误的最常见原因是
ProjectSettings
和
Assets
文件夹位于源代码仓库或代码仓库中 Unity Build Automation 所指定目标文件夹的子目录内。

解决方案

如果您的项目是 Unity 项目,但位于子目录中,则可以创建新的目标,并定义项目子目录路径的名称。这会告知 Unity Build Automation 在该子目录中查找需要构建的项目。
要在 Unity Dashboard 中更改目标,请执行以下操作:
  1. 选择 Build Automation > Configurations(配置)。
  2. 选择要编辑的构建上的 Edit(编辑)按钮。
  3. 在 Basic settings(基本设置) 选项卡中编辑目标。
"UBA - 项目子目录"

UBA - 项目子目录

其他资源

  • 有关 Unity Build Automation 未来发展的信息,请参阅 Unity DevOps 路线图。

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。

  • 在本页上
    • 症状

    • 原因

    • 解决方案

    • 其他资源


报告此页面的问题