Documentation

Support

Build Automation

DevOps

Build Automation REST API

Build Automation Editor Package

Open Unity Dashboard

Build Automation

Unrecognized project error

Resolve unrecognized project errors in Unity Build Automation and configure project paths correctly.
Read time 1 minuteLast updated 16 hours ago

Symptom

Your build fails with the following error: 
[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).

Cause

Unity Build Automation only supports builds of Unity Projects. The most common cause for this error is when the 
ProjectSettings
and 
Assets
folders are contained within a subdirectory of the folder targeted by Unity Build Automation in your source code repository, or your repository.

Resolution

If your project is a Unity Project but is in a subdirectory, you can create a new target and define the name of the Project subdirectory path. This tells Unity Build Automation to look in this subdirectory for the project it needs to build. To change the target in your Unity Dashboard:
  1. Select Build Automation > Configurations.
  2. Select the Edit button on the build you want to edit.
  3. Edit the target in the Basic settings tab.
"UBA - Project subdirectory"

UBA - Project subdirectory

Additional resource