Unity Builds & Platforms

Scripting backend

Ship IL2CPP for production on every platform that supports it.

Build profiles (Unity 6)

Window > Build Profiles — distinct configs per target (development PC, release PC, mobile dev, mobile release). Each profile has its own scripting backend, scenes list, scripting defines, and build path.

Android

Gradle + libraries

Assets/Plugins/Android/ for AAR/JAR drops. Use Custom Main Manifest / Custom Gradle Properties when third-party SDKs need them — avoid editing Library/ generated files.

AAB (App Bundle)

Mandatory on Play Store since 2021. Configure:

• Minimum API level (typically 26+)
• Target API level (latest stable)
• Architectures: ARM64 only for shipping (x86 is dev-only)
• IL2CPP Code Generation: Faster runtime
• Strip Engine Code = ON

Play Asset Delivery (PAD)

Splits content into install-time / fast-follow / on-demand asset packs. Pair with Addressables: configure remote group → builds into .aab asset packs. Use for big games (>150 MB base APK limit).

Permissions

Declare only what you use; runtime-request location/camera/mic. Recent Android requires Manifest.permission.POST_NOTIFICATIONS for push.

iOS

Build flow

Unity → Xcode project → archive → notarize/upload via Xcode or altool. Most issues come from Build Phases missing entitlements; fix via OnPostprocessBuild:

[PostProcessBuild]
public static void Modify(BuildTarget t, string path) {
    if (t != BuildTarget.iOS) return;
    var pbx = new PBXProject();
    var pbxPath = PBXProject.GetPBXProjectPath(path);
    pbx.ReadFromFile(pbxPath);
    string targetGuid = pbx.GetUnityMainTargetGuid();
    pbx.AddFrameworkToProject(targetGuid, "UserNotifications.framework", false);
    pbx.WriteToFile(pbxPath);
}

Capabilities & Info.plist

Push (UserNotifications), Sign in with Apple, Game Center, IAP — via Capabilities. Privacy strings (NSCameraUsageDescription) — must explain user-visible reason.

WebGL

Constraints:

• No real threads (until SharedArrayBuffer is fully unlocked)
• Memory cap (usually 256–512 MB; configure in Player Settings)
• Compression: Brotli when server supports it; Gzip otherwise; Disabled only for itch.io-style hosts that decompress for you

Disable: bloom (heavy), realtime shadows (gather), reflection probes if static.

Console (PS5/XSX/Switch)

Behind NDA. High-level: separate Unity install per platform; console-specific Build Pipeline calls; first-party libs (PSN/Xbox Live/Nintendo Account) wrap their own SDK on top of Unity. Get developer account + Unity console license before scoping.

CI for multi-platform

# pseudo-yaml: matrix over platforms
strategy:
  matrix:
    target: [StandaloneWindows64, Android, iOS]
steps:
  - uses: game-ci/unity-builder@v4
    with:
      targetPlatform: ${{ matrix.target }}
      buildMethod: CIBuild.Build

Anti-patterns

Production checklist

• Build Profiles configured per target
• Signing keys stored securely (GitHub secrets, not committed)
• Minimum/target SDK / iOS deployment target documented
• Addressables built before player on every platform
• Platform-specific permissions strings + capabilities reviewed
• Build size budget tracked over time (alert on regressions)
• Day-1 patch / fast-follow path tested