Fr/Installing and Debugging the Source Code: Difference between revisions
< Fr
Jump to navigation
Jump to search
m (→Links) |
m (obsolete language category) |
||
(14 intermediate revisions by 9 users not shown) | |||
Line 1: | Line 1: | ||
{{LanguageBar}} | |||
Cet article a pour objectif de détailler les étapes d'installation et de debug du code source. | |||
== | == Étape par étape == | ||
# Lancer le SDK de Source | === Lancer l’assistant de Création de Mod === | ||
# Vous pouvez normalement choisir plusieurs types de | |||
# Choisissez un | # Lancer le SDK de Source à partir de Steam et choisir le lien '''Create a Mod'''. | ||
# Choisissez un nom pour votre Mod comme ''' | # Vous pouvez normalement choisir plusieurs types de Mod ; pour ce tutoriel, choisissez '''Modify Half-Life 2 Single Player''' puis cliquez '''Next'''. | ||
# | # Choisissez un répertoire où placer votre projet, par exemple : '''C:\MonMod'''. | ||
# Choisissez un nom pour votre Mod comme '''MonMod'''. Ceci construira un répertoire dans Steam sous le répertoire '''''SteamInstallPath'''\SteamApps\SourceMods''. | |||
# Cliquez '''Next''' et le code source sera copié sur votre disque dur. | |||
=== Compiler le code source === | === Compiler le code source === | ||
Pour le choix d'un compilateur allez à | Pour le choix d'un compilateur allez à {{L|Compiler Choices}} | ||
Et plus | Et plus spécifiquement: | ||
* | * {{L|Compiling under VS2003}} | ||
* | * {{L|Compiling under VS2005}} | ||
* | * {{L|Compiling under VS2008}} | ||
{{note|La compilation est en mode debug par | {{note|La compilation est en mode debug par défaut. Pour exécuter en debug le Mod avec une DLL, vous devez dans l'explorateur de jeux de Steam faire un clic droit sur le Mod, aller dans le menu '''Properties''' et dans '''Set Launch Options...''' ajouter ''-allowdebug'' à la fin des autres commandes éventuellement présentes. Vous pouvez passer en une génération finale en allant dans le manager de configuration.}} | ||
Pour l'instant le code se compile | Pour l'instant le code se compile mieux avec VS2005 en téléchargement libre à http://www.microsoft.com/express/2005/ | ||
Cependant VS2005 demande l'installation du SDK Windows que ne demande pas VS2008. | Cependant VS2005 demande l'installation du SDK Windows, ce que ne demande pas VS2008. | ||
==== | ==== Éditer les paramètres de debug ==== | ||
{{note|Ceci ne fonctionne que si vous avez installé et lancé le Source SDK Base.}} | {{note|Ceci ne fonctionne que si vous avez installé et lancé le Source SDK Base.}} | ||
# Dans le '''Solution Explorer window,''' clic droit sur le projet | # Dans le '''Solution Explorer window,''' clic droit sur le projet courant (celui en gras) et choisir '''Properties'''. | ||
# Dans le dialogue de | # Dans le dialogue de propriétés qui apparait choisir l'objet '''Debugging''' a gauche. | ||
# | # À droite, dans le contrôle qui suit '''Command''', entrez <code>C:\Steam\SteamApps\'''Username'''\source sdk base 2007\hl2.exe</code> (ajustez '''Username''' à votre propre répertoire d'installation de Steam). | ||
# | # À la suite de '''Command Arguments''', entrez <code>-dev -sw -game "C:\Steam\SteamApps\SourceMods\MyMod"</code> (où '''MyMod''' est le nom de votre Mod). | ||
# | # À la suite de '''Working Directory''', entrez <code>C:\Steam\SteamApps\'''Username'''\source sdk base 2007</code> (ajustez '''Username''' à votre propre répertoire d'installation de Steam). | ||
# Cliquer sur le bouton '''OK'''. | # Cliquer sur le bouton '''OK'''. | ||
==== Lancer dans le debugger ==== | ==== Lancer dans le debugger ==== | ||
# '' | # ''Important : après une mise à jour du SDK, vous devez vous assurer que les logiciels que vous utilisez fonctionnent toujours sous Steam avant de lancer le debugger. Sinon, vous risquez d'avoir des erreurs liées à Steam lors du debug'' | ||
# Clic droit sur le | # Clic droit sur le même projet que pour lequel vous avez édité les propriétés et choisir '''Debug->Start New Instance'''. | ||
# Si vous avez l'avertissement que <code>hl2.exe</code> n'a pas d'informations pour le debug, ignorez la. | # Si vous avez l'avertissement que <code>hl2.exe</code> n'a pas d'informations pour le debug, ignorez la. | ||
# | # Vous pouvez alors lancer Half-Life 2 et votre propre code. Vous pouvez maintenant effectuer des modifications sur le code, le recompiler et l'exécuter avec les changements opérés ! | ||
==== Alternative : Attachement au process ==== | ==== Alternative : Attachement au process ==== | ||
Line 46: | Line 48: | ||
# Lancer le Mod avec Steam | # Lancer le Mod avec Steam | ||
# Dans Visual Studio, faire '''Main Menu > Debug > Attach to Process...''' | # Dans Visual Studio, faire '''Main Menu > Debug > Attach to Process...''' | ||
# | # Sélectionnez le hl2.exe processus avec le titre de votre Mod. | ||
{{tip|Vous pouvez lancer l'application en mode | {{tip|Vous pouvez lancer l'application en mode fenêtré pour un meilleur confort : ajoutez "-window" option dans run_mod.bat}} | ||
== Liens == | == Liens == | ||
L' | L'étape suivante à ce document est d'aller voir {{L|Your First Entity}}, dans lequel il est expliqué où effectuer des changement dans le code source. | ||
{{ACategory|Programming}} | |||
{{ACategory|Modding}} |
Latest revision as of 03:31, 22 August 2024
Cet article a pour objectif de détailler les étapes d'installation et de debug du code source.
Étape par étape
Lancer l’assistant de Création de Mod
- Lancer le SDK de Source à partir de Steam et choisir le lien Create a Mod.
- Vous pouvez normalement choisir plusieurs types de Mod ; pour ce tutoriel, choisissez Modify Half-Life 2 Single Player puis cliquez Next.
- Choisissez un répertoire où placer votre projet, par exemple : C:\MonMod.
- Choisissez un nom pour votre Mod comme MonMod. Ceci construira un répertoire dans Steam sous le répertoire SteamInstallPath\SteamApps\SourceMods.
- Cliquez 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 spécifiquement:

Pour l'instant le code se compile mieux avec VS2005 en téléchargement libre à http://www.microsoft.com/express/2005/ Cependant VS2005 demande l'installation du SDK Windows, ce que ne demande pas VS2008.
Éditer les paramètres de debug

- Dans le Solution Explorer window, clic droit sur le projet courant (celui en gras) et choisir Properties.
- Dans le dialogue de propriétés qui apparait choisir l'objet Debugging a gauche.
- À droite, dans le contrôle qui suit Command, entrez
C:\Steam\SteamApps\Username\source sdk base 2007\hl2.exe
(ajustez Username à votre propre répertoire d'installation de Steam). - À la suite de Command Arguments, entrez
-dev -sw -game "C:\Steam\SteamApps\SourceMods\MyMod"
(où MyMod est le nom de votre Mod). - À la suite de Working Directory, entrez
C:\Steam\SteamApps\Username\source sdk base 2007
(ajustez Username à votre propre répertoire d'installation de Steam). - Cliquer sur le bouton OK.
Lancer dans le debugger
- Important : après une mise à jour du SDK, vous devez vous assurer que les logiciels que vous utilisez fonctionnent toujours sous Steam avant de lancer le debugger. Sinon, vous risquez d'avoir des erreurs liées à Steam lors du debug
- Clic droit sur le même projet que pour lequel vous avez édité les propriétés et choisir Debug->Start New Instance.
- Si vous avez l'avertissement que
hl2.exe
n'a pas d'informations pour le debug, ignorez la. - Vous pouvez alors lancer Half-Life 2 et votre propre code. Vous pouvez maintenant effectuer des modifications sur le code, le recompiler et l'exécuter avec les changements opérés !
Alternative : Attachement au process
- Lancer le Mod avec Steam
- Dans Visual Studio, faire Main Menu > Debug > Attach to Process...
- Sélectionnez le hl2.exe processus avec le titre de votre Mod.

Liens
L'étape suivante à ce document est d'aller voir Your First Entity , dans lequel il est expliqué où effectuer des changement dans le code source.