Build Profiles (Unity 6+)
Discovery
list_build_profiles— BuildProfile assets under Assets / ProjectSettingslist_build_scenes— classic EditorBuildSettings (fallback / shared list)get_scripting_defines— global + asmdef definesget_platform_build_hints— platform PlayerSettings snippets
Checklist
- Each shippable configuration (dev, staging, store, dedicated server) should be a named Build Profile.
- Prefer profile-scoped scene lists and scripting defines over editing one global list by hand.
- Document which profile CI uses (
-activeBuildProfile/ batchmode args). - If
list_build_profilesis empty, the project may still be on classic build settings — migrate deliberately.
Related
unity-release-readiness,unity-ci-github-actions,unity-platform-player-settings