Application des modifications
Modifier une propriété dans craftforJ change l’application en cours d’exécution, et rien d’autre. Pour conserver une modification, examinez-la et écrivez-la dans le fichier Java dont elle provient. Cette page décrit cette étape.
Conservez votre travail dans le contrôle de version. Lisez le diff avant de l’appliquer, puis relisez-le avant de valider.
Modifications en attente
Chaque propriété que vous modifiez est enregistrée comme une modification en attente, et craftforJ indique combien sont en attente. Les modifications en attente sont conservées après le rechargement d’une page ou un changement de route, car craftforJ les réapplique lorsque vos composants sont reconstruits.
Examiner et appliquer
Appuyez sur Cmd/Ctrl + S pour ouvrir l’écran de vérification. Les modifications sont regroupées par fichier de destination. Chacune affiche la propriété avec son ancienne et sa nouvelle valeur, et permet de développer le diff du fichier. Si une modification remplace une valeur calculée par une valeur fixe, craftforJ vous avertit et indique l’expression qu’il s’apprête à remplacer. Rien n’est écrit tant que vous n’appliquez pas les modifications. Avant cela, vous pouvez annuler ou supprimer chaque modification individuellement.
Choisir où écrire une modification
L’endroit où une modification est écrite détermine sa portée. Lorsqu’un composant est directement créé dans une vue, la modification est écrite dans cette vue. Lorsqu’il est créé dans une classe réutilisable, vous avez deux possibilités :
- L’utilisation — l’endroit où le composant est utilisé, ce qui ne modifie que l’écran affiché. C’est l’option par défaut.
- La définition — l’endroit où le composant est créé, ce qui modifie tous les écrans qui l’utilisent.
Chaque modification en attente indique laquelle des deux options s’applique et vous permet de passer de l’une à l’autre. Certaines propriétés ne peuvent être écrites que dans la définition, car le composant les définit lui-même au lieu de les accepter de l’appelant. craftforJ les signale avant que vous appliquiez les modifications.
Après l’application
L’écriture dans un fichier Java entraîne la reconstruction et le redémarrage de votre application. craftforJ signale le redémarrage, attend qu’il se termine, puis se reconnecte en conservant votre sélection et les modifications en attente restantes. Une fois les modifications appliquées dans vos fichiers, elles disparaissent de la liste des modifications en attente.
C’est le seul moment où votre configuration de rechargement entre en jeu. craftforJ n’a pas besoin du rechargement à chaud pour fonctionner : toutes les modifications effectuées pendant l’inspection prennent immédiatement effet dans l’application en cours d’exécution, sans reconstruction. L’écriture dans le code source est différente : elle modifie un fichier à partir duquel votre application a été construite, et l’application doit donc être reconstruite pour que la modification provienne de votre code plutôt que de craftforJ. Si le rechargement à chaud est configuré, cela se fait automatiquement. Sinon, redémarrez l’application vous-même.
Annuler et rétablir 26.03
Appuyez sur Cmd/Ctrl + Z dans craftforJ pour annuler votre dernière modification, et sur Cmd/Ctrl + Shift + Z pour la rétablir.
L’annulation fonctionne pour les modifications effectuées dans l’application en cours d’exécution, des modifications de propriétés aux ajustements de thème. Elle fonctionne également pour les modifications que craftforJ a écrites dans votre projet, comme les modifications de propriétés appliquées, un thème enregistré ou un composant supprimé du code source. L’annulation d’une modification écrite rétablit le fichier dans son état précédent. Si ce fichier est un fichier Java, votre application doit être reconstruite avant que la modification soit visible, comme après l’application.
Appuyer plusieurs fois sur Annuler revient sur vos modifications une par une, en commençant par la plus récente ; Rétablir les rejoue dans l’ordre où vous les avez effectuées. Si vous effectuez une nouvelle modification après une annulation, toutes les modifications que vous auriez pu rétablir sont effacées.
Quand une annulation est bloquée
Si vous modifiez et enregistrez un fichier dans votre propre éditeur après que craftforJ y a écrit des changements, annuler ou rétablir cette étape écraserait votre modification. craftforJ refuse alors l’opération, laisse le fichier tel quel et indique son nom :
Modifié en dehors de craftforJ : ContactFormView.java. Annulez cette modification dans votre éditeur, ou ignorez cette étape.
Deux possibilités s’offrent à vous :
- Annulez votre modification dans votre éditeur pour que le fichier corresponde à ce que craftforJ a écrit, puis réessayez.
- Choisissez Ignorer. Le fichier reste tel quel et cette étape est supprimée de l’historique. L’ignorance n’annule rien ; les étapes précédentes qui ont modifié le même fichier peuvent donc toujours être bloquées.
Désactiver cette fonctionnalité
Vous pouvez désactiver l’écriture dans les fichiers Java pour une application dans les paramètres de craftforJ, ou la supprimer entièrement avec la propriété source-changes. Dans les deux cas, la modification des propriétés reste possible, mais les changements ne s’appliquent qu’à l’exécution.
