NRF SDK 0.9Maintenance
Journaux et dépannage
Ajoutez des diagnostics utiles, trouvez les erreurs pertinentes et préparez un rapport reproductible.
Retrouver le bon journal
Sous Windows, la racine habituelle est %LOCALAPPDATA%/NimbyRailsFrance/logs/. Cherchez le composant et l’heure de votre essai. Le journal du Hub explique une construction ou une activation ; le journal d’un mod ou d’une application explique son exécution.
DiagnosticLog, côté JVM, écrit dans un dossier par composant et un fichier par processus. NRF_LOG_DIR remplace sa racine ; un root explicite au constructeur permet aussi de choisir le dossier. Les fichiers tournent avec une limite de taille : conservez rapidement les éléments d’un incident.
val log = fr.nimby.sdk.DiagnosticLog.forComponent("mon-outil")
log.startApplication("0.1.0")
log.write("Profile loaded")Journaliser des événements utiles
context.log("Preview unavailable", LogLevel.Warning)ToolContext.log accepte un message UTF-8 de 1 à 4 096 octets, sans caractère nul, avec Info, Warning ou Error. Utilisez le contexte uniquement pendant le callback. Consignez un changement d’état, une action demandée, un résultat ou une erreur exploitable ; évitez un message pour chaque lecture réussie.
DiagnosticLog regroupe les répétitions identiques pendant une courte période. Gardez donc un message stable et ajoutez seulement les informations nécessaires : opération, identifiant concerné, résultat et contexte de session. Ne créez pas un texte unique à chaque tick pour contourner ce regroupement.
Relier le symptôme à une vérification
| Symptôme | Première vérification |
|---|---|
| Import Kotlin non résolu | API Native ou JVM, kit sélectionné, rechargement Gradle et première erreur de configuration. |
| Paquet construit, comportement ancien en jeu | Profil réellement activé, versions chargées et lancement effectué après l’activation. |
| Signal au repli | Fraîcheur, disponibilité des réglages, occupation et résolution du voisin avant l’image. |
| Outil refusé ou résultat en attente | État de la partie, session et résultat du ticket ; ne pas rejouer la demande sans vérification. |
| Fichier absent après installation | Premier échec de copie ou de vérification et historique de protection correspondant à la même heure. |
Fournir un rapport reproductible
- Versions du jeu, du SDK, du kit, du mod et de l’application ; version de Windows.
- Étapes exactes, sauvegarde ou petit scénario, vitesse sélectionnée et actions avant l’incident.
- Résultat attendu et observé, avec heure et fuseau ; identifiants utiles dans la session concernée.
- Première erreur et lignes qui la précèdent, puis résultat de récupération ou de fermeture.
Les journaux peuvent contenir des chemins locaux et des noms de la partie. Relisez le rapport avant partage. Si vous retirez une information personnelle, indiquez-le en conservant les heures, les codes et l’ordre des événements utiles au diagnostic.