Unity Build & CI/CD Configurator

Unity Build & CI/CD Configurator

Ce que fait cette skill

Configure l'ensemble du pipeline de build Unity : scripts de build C# automatises, workflows CI/CD (GitHub Actions ou GitLab CI), fichiers .gitignore et .gitattributes optimises avec Git LFS, et checklist pre-release par plateforme. Scanne le projet existant pour adapter la configuration.

Prerequis

• Un projet Unity existant avec ProjectSettings/ et Assets/
• Un repository Git (ou pret a etre initialise)
• Pour CI/CD : une licence Unity (Personal, Plus, Pro) stockee en secret

Arbre de decision

Que configurer ?
|
+-- Build automatise seulement ?
|   +-- --> Etape 3 (script C# BuildAutomation)
|
+-- CI/CD complet ?
|   +-- GitHub ? --> Etape 4 Option A (GitHub Actions + game-ci)
|   +-- GitLab ? --> Etape 4 Option B (GitLab CI)
|
+-- Git setup (nouveau projet) ?
|   +-- --> Etape 5 (.gitignore + .gitattributes + LFS)
|
+-- Build Profiles (Unity 6+) ?
    +-- --> Section Build Profiles (etape 2)

Demarrage rapide

1. L'utilisateur demande une configuration de build (ex: "configure CI/CD pour Windows et WebGL")
2. Le skill scanne le projet (scenes, packages, settings)
3. Le skill genere les fichiers de configuration adaptes

Guide etape par etape

Etape 1 : Identifier les plateformes cibles

Si l'utilisateur ne precise pas, demander les plateformes parmi :

• Desktop : StandaloneWindows64, StandaloneOSX, StandaloneLinux64
• Mobile : Android, iOS
• Web : WebGL
• Console : PS5, XboxSeriesX, Switch (necessite SDK proprietaire)

Etape 2 : Scanner le projet existant

Collecter les informations du projet avec les outils Claude Code :

Glob "Assets/**/*.unity"               → lister les scenes
Glob "ProjectSettings/*"               → verifier les settings existants
Read "Packages/manifest.json"          → packages et version Unity
Read "ProjectSettings/ProjectSettings.asset" → scripting backend, company name
Grep "com.unity.render-pipelines"      → pipeline de rendu
Glob ".gitignore"                      → verifier si existant
Glob ".gitattributes"                  → verifier si LFS configure

Build Profiles (Unity 6+)

Unity 6 remplace les Build Settings par des Build Profiles (assets .buildprofile configurables par plateforme). Permet plusieurs configs independantes, switchables sans reconfigurer manuellement. En CLI, utiliser -activeBuildProfile au lieu de -buildTarget.

Voir les details et exemples de code dans references/build-templates.md section "Build Profiles".

Etape 3 : Generer le script de build C#

Creer Assets/Editor/BuildAutomation.cs avec une classe statique contenant : helper GetEnabledScenes(), methode generique ExecuteBuild(), et une methode par plateforme cible avec [MenuItem]. Inclure un entrypoint BuildFromCommandLine() pour le CI.

Voir le template complet dans references/build-templates.md section "BuildAutomation.cs".

Etape 4 : Generer la configuration CI/CD

Option A : GitHub Actions (recommande) -- Utilise game-ci avec jobs test (EditMode + PlayMode) puis build en matrice multi-plateforme. Cache du dossier Library/ et upload des artifacts.

Option B : GitLab CI -- Image unityci/editor, stages test puis build. Dupliquer le job build par plateforme cible.

Voir les templates YAML complets dans references/build-templates.md sections "GitHub Actions" et "GitLab CI".

Etape 5 : Generer .gitignore et .gitattributes

Generer un .gitignore excluant Library/, Temp/, obj/, Builds/, IDE files, et keystores. Generer un .gitattributes configurant le YAML merge Unity et Git LFS pour les binaires (3D, textures, audio, video, packages).

Voir les templates complets dans references/build-templates.md sections ".gitignore" et ".gitattributes".

Etape 6 : Pre-build checks

Ajouter une methode PreBuildCheck() dans BuildAutomation.cs qui valide : scenes presentes dans Build Settings, pas d'erreurs de compilation. Verifier aussi les references manquantes et les tests EditMode.

Voir le code dans references/build-templates.md section "Pre-build Checks".

Checklist pre-release par plateforme disponible dans references/build-templates.md section "Checklist pre-release".

Regles strictes

• TOUJOURS scanner le projet existant avant de generer des configs
• TOUJOURS utiliser IL2CPP pour les builds release (pas Mono)
• TOUJOURS configurer Git LFS avant le premier commit d'assets binaires
• TOUJOURS mettre les secrets (licence Unity, keystore) dans les variables CI, jamais dans les fichiers
• TOUJOURS inclure un job de tests avant le job de build dans le CI
• JAMAIS hardcoder de licence Unity ou credentials dans les fichiers CI
• JAMAIS inclure Library/, Temp/, ou obj/ dans le version control
• JAMAIS committer de fichiers .keystore (sauf debug.keystore)
• PREFERER GitHub Actions avec game-ci comme solution CI par defaut
• PREFERER le cache du dossier Library/ pour accelerer les builds CI

Skills connexes

• Le script BuildAutomation necessite un editor tool plus avance ? Utiliser /unity-editor-tools (Unity Editor Tools)
• Generer un script de build custom ? Utiliser /unity-code-gen (Unity Code Gen) pour le code C# Editor
• Shader custom a builder ? Utiliser /shader (Unity Shader Generator)

Troubleshooting