Fr/Installing and Debugging the Source Code

Cet article a pour objectif de detailler les etapes d'intalations et de debug du code source.

Etape par etape

Lancer l'assistant de Creation de Mod

1. Lancer le SDK de Source a partir de Steam et choisir le lien Create a Mod.
2. Vous pouvez normalement choisir plusieurs types de Mod, pour ce tutorial, choisissez Modify Half-Life 2 Single Player puis cliquer Next.
3. Choisissez un repertoire où pour placer votre projet comme: C:\MyMod.
4. Choisissez un nom pour votre Mod comme MyMod. Ceci contruira un repertoire dans Steam sous le repertoire SteamInstallPath\SteamApps\SourceMods.
5. Cliquer Next et le code source sera copié sur votre disque dur.

Compiler le code source

Pour le choix d'un compilateur allez à Compiler Choices

Et plus specifiquement:

• Compiling under VS2003
• Compiling under VS2005
• Compiling under VS2008

Note:La compilation est en mode debug par defaut. Pour executer en debug le Mod avec une dll, vous devez dans l'explorateur de jeux de Steam faire un clic droit sur le Mod, allez dans le menu Properties et dans Set Launch Options... ajouter -allowdebug a la fin des autres commandes éventuellement presentes. Vous pouvez passer en une generation finale en allant dans le manager de configuration.

Pour l'instant le code se compile le mieux avec VS2005 en telechargement libre à http://www.microsoft.com/express/2005/ Cependant VS2005 demande l'installation du SDK Windows que ne demande pas VS2008.

Editer les parametres de debug

Note:Ceci ne fonctionne que si vous avez installé et lancé le Source SDK Base.

1. Dans le Solution Explorer window, clic droit sur le projet courant celui en gras et choisir Properties.
2. Dans le dialogue de propriétées qui apparait choisir l'objet Debugging a gauche.
3. A droite, dans le control qui suit Command, entrez C:\Steam\SteamApps\Username\source sdk base 2007\hl2.exe (ajuster Username a votre propre repertoire d'intallation de Steam).
4. A la suite de Command Arguments, entrez -dev -sw -game "C:\Steam\SteamApps\SourceMods\MyMod" (oùMyMod est le nom de votre Mod).
5. A la suite de Working Directory, entrez C:\Steam\SteamApps\Username\source sdk base 2007 (ajuster Username a votre propre repertoire d'intallation de Steam).
6. Cliquer sur le bouton OK.

Lancer dans le debugger

1. Important: apres une mise à jour du SDK, vous devez vous assurer que les logiciels que vous editez fonctionne toujours sous Steam avant de lancer le debugger. Sinon, vous risquez d'avoir des erreurs liées a Steam lors du debug
2. Clic droit sur le meme projet que pour lequel vous avez edité les propriétés et choisir Debug->Start New Instance.
3. Si vous avez l'avertissement que hl2.exe n'a pas d'informations pour le debug, ignorez la.
4. Vouspouvez alors lancer Half-Life 2 et votre propre code. Vous pouvez maintenant effectuer des modifications sur le code, le recompiler et l'executer avec les changements operés!

Alternative : Attachement au process

1. Lancer le Mod avec Steam
2. Dans Visual Studio, faire Main Menu > Debug > Attach to Process...
3. Selectionnez le hl2.exe processus avec le titre de votre Mod.

Astuce:Vous pouvez lancer l'application en mode fenetré pour un meilleur comfort: ajoutez "-window" option dans run_mod.bat

Liens

L'etape suivante a ce document est d'aller voir Your First Entity document, dans lequel il est expliqué ou effectuer des changement des le code source.