Skip to content

Commit d973f7b

Browse files
sio2sio2sio2sio2
committed
Ilustra cómo crear una tarea para ejecutar JShell
1 parent d2d581e commit d973f7b

File tree

4 files changed

+129
-40
lines changed

4 files changed

+129
-40
lines changed

‎docs/98.apendices/99.tools/10-vscode.html

Lines changed: 38 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -226,9 +226,9 @@ <h2>Personalización<a class="headerlink" href="#personalizacion" title="Enlace
226226
</dd>
227227
</dl>
228228
<dl id="vscode-atajos">
229-
<dt><strong>Atajos de teclado</strong></dt><dd><p>El programa da la posibilidad de asociar combinaciones de teclas a
230-
las distintas tareas definidas. Las asociaciones se puede hacer de
231-
distintos modos:</p>
229+
<dt><strong>Atajos de teclado</strong></dt><dd><p>A nivel de perfil (y no de área de trabajo), el programa ofrece la
230+
posibilidad de asociar combinaciones de teclas a las distintas tareas
231+
definidas. Las asociaciones se puede hacer de distintos modos:</p>
232232
<ul class="simple">
233233
<li><p>Pulsando <kbd class="kbd docutils literal notranslate">Ctrl</kbd>+<kbd class="kbd docutils literal notranslate">Shift</kbd>+<kbd class="kbd docutils literal notranslate">P</kbd> para abrir el diálogo
234234
que permite ejecutar tareas y, en vez de ejecutarla, pulsar sobre la
@@ -241,15 +241,10 @@ <h2>Personalización<a class="headerlink" href="#personalizacion" title="Enlace
241241
cómodo, en vez de buscarlo en el sistema de archivos, es acceder a la lista
242242
de asociaciones que se acaba de citar, y pulsar aquí:</p>
243243
<img alt="../../_images/addkeybinding.png" src="../../_images/addkeybinding.png" />
244-
<p>El archivo contiene de un array en que cada <em>ítem</em> es una de esas
244+
<p>El archivo contiene un array en que cada <em>ítem</em> es una de esas
245245
asociaciones. Más adelante se sugerirán algunos.</p>
246246
</li>
247247
</ul>
248-
<div class="admonition note">
249-
<p class="admonition-title">Nota</p>
250-
<p>Los atajos de teclado sólo se pueden definir para perfiles, no para
251-
áreas de trabajo.</p>
252-
</div>
253248
<div class="admonition seealso">
254249
<p class="admonition-title">Ver también</p>
255250
<p>La ayuda oficial del programa tiene <a class="reference external" href="https://code.visualstudio.com/docs/getstarted/keybindings">una buena explicación
@@ -337,10 +332,9 @@ <h2>Personalización<a class="headerlink" href="#personalizacion" title="Enlace
337332
durante la depuración.</p>
338333
<div class="admonition seealso">
339334
<p class="admonition-title">Ver también</p>
340-
<p>A la configuración básica que proporcionan esas estadísticas, se le puede
341-
añadir otra adicional dentro de <code class="file docutils literal notranslate"><span class="pre">.vscode/launch.json</span></code>, cuyos
342-
princiipios pueden leerse en el artículo <a class="reference external" href="https://gigi.nullneuron.net/gigilabs/working-with-vs-code-launch-configurations/">Working with VSCode launch
343-
configurations</a>.</p>
335+
<p>A la configuración básica citada, se le puede añadir otra
336+
adicional dentro de <code class="file docutils literal notranslate"><span class="pre">.vscode/launch.json</span></code>, cuyos principios pueden
337+
leerse en el artículo <a class="reference external" href="https://gigi.nullneuron.net/gigilabs/working-with-vs-code-launch-configurations/">Working with VSCode launch configurations</a>.</p>
344338
</div>
345339
<div class="admonition seealso">
346340
<p class="admonition-title">Ver también</p>
@@ -921,8 +915,8 @@ <h2>Perfiles de desarrollo<a class="headerlink" href="#perfiles-de-desarrollo" t
921915
</tr>
922916
</tbody>
923917
</table>
924-
<div class="admonition note">
925-
<p class="admonition-title">Nota</p>
918+
<div class="admonition caution">
919+
<p class="admonition-title">Prudencia</p>
926920
<p><a class="reference internal" href="#code-runner"><span class="std std-ref">Code Runner</span></a> es absolutamente prescindible, ya que al tener
927921
instalada <a class="reference external" href="https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-debug">Debugger for Java</a> podemos ejecutar los desarrollos pulsando
928922
<kbd class="kbd docutils literal notranslate">Ctrl</kbd>+<kbd class="kbd docutils literal notranslate">F5</kbd>.
@@ -940,6 +934,35 @@ <h2>Perfiles de desarrollo<a class="headerlink" href="#perfiles-de-desarrollo" t
940934
<span class="p">}</span>
941935
</pre></div>
942936
</div>
937+
<p>Además, durante la codificación puede interesarnos hacer alguna prueba
938+
individual de cómo funciona método a través de la consola interactiva <a class="reference external" href="https://docs.oracle.com/en/java/javase/22/jshell/introduction-jshell.html">JShell</a>.
939+
Podemos, por supuesto, abrir una terminal (<kbd class="kbd docutils literal notranslate">Ctrl</kbd>+<kbd class="kbd docutils literal notranslate">`</kbd>) y escribir
940+
directamente la orden en ella, pero sin duda es más cómodo <a class="reference internal" href="#vscode-tasks"><span class="std std-ref">crear una tarea</span></a> y asociarla a una <a class="reference internal" href="#vscode-atajos"><span class="std std-ref">combinación de teclas</span></a>.
941+
La tarea podemos definirla con este código <abbr title="JavaScript Object Notation">JSON</abbr>:</p>
942+
<div class="highlight-json notranslate"><div class="highlight"><pre><span></span><span class="p">{</span>
943+
<span class="w"> </span><span class="nt">&quot;label&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Shell para Java&quot;</span><span class="p">,</span>
944+
<span class="w"> </span><span class="nt">&quot;type&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;shell&quot;</span><span class="p">,</span>
945+
<span class="w"> </span><span class="nt">&quot;command&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;jshell&quot;</span><span class="p">,</span>
946+
<span class="w"> </span><span class="nt">&quot;windows&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
947+
<span class="w"> </span><span class="nt">&quot;command&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;${env:JAVA_HOME}\\bin\\jshell.exe&quot;</span>
948+
<span class="w"> </span><span class="p">},</span>
949+
<span class="w"> </span><span class="nt">&quot;presentation&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
950+
<span class="w"> </span><span class="nt">&quot;reveal&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;always&quot;</span><span class="p">,</span>
951+
<span class="w"> </span><span class="nt">&quot;panel&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;new&quot;</span>
952+
<span class="w"> </span><span class="p">},</span>
953+
<span class="w"> </span><span class="nt">&quot;problemMatcher&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span>
954+
<span class="p">}</span>
955+
</pre></div>
956+
</div>
957+
<p>y la asociación a la combinación <kbd class="kbd docutils literal notranslate">Ctrl</kbd>+<kbd class="kbd docutils literal notranslate">Shift</kbd>+<kbd class="kbd docutils literal notranslate">J</kbd> de
958+
este modo:</p>
959+
<div class="highlight-json notranslate"><div class="highlight"><pre><span></span><span class="p">{</span>
960+
<span class="w"> </span><span class="nt">&quot;key&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;ctrl+shift+j&quot;</span><span class="p">,</span>
961+
<span class="w"> </span><span class="nt">&quot;command&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;workbench.action.tasks.runTask&quot;</span><span class="p">,</span>
962+
<span class="w"> </span><span class="nt">&quot;args&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Shell para Java&quot;</span>
963+
<span class="p">}</span>
964+
</pre></div>
965+
</div>
943966
<dl>
944967
<dt><strong>Creación del proyecto</strong></dt><dd><p>Para comenzar un proyecto, en vez de abrir directamente un área de trabajo,
945968
lo mejor es <em>crear un nuevo proyecto</em> a través de la extensión <a class="reference external" href="https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-dependency">Project Manager

‎docs/_sources/98.apendices/99.tools/10-vscode.rst.txt

Lines changed: 45 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -171,9 +171,9 @@ archivos de configuración |JSON|:
171171
.. _vscode-atajos:
172172

173173
**Atajos de teclado**
174-
El programa da la posibilidad de asociar combinaciones de teclas a
175-
las distintas tareas definidas. Las asociaciones se puede hacer de
176-
distintos modos:
174+
A nivel de perfil (y no de área de trabajo), el programa ofrece la
175+
posibilidad de asociar combinaciones de teclas a las distintas tareas
176+
definidas. Las asociaciones se puede hacer de distintos modos:
177177

178178
.. rst-class:: simple
179179

@@ -192,12 +192,9 @@ archivos de configuración |JSON|:
192192

193193
.. image:: files/addkeybinding.png
194194

195-
El archivo contiene de un array en que cada *ítem* es una de esas
195+
El archivo contiene un array en que cada *ítem* es una de esas
196196
asociaciones. Más adelante se sugerirán algunos.
197197

198-
.. note:: Los atajos de teclado sólo se pueden definir para perfiles, no para
199-
áreas de trabajo.
200-
201198
.. seealso:: La ayuda oficial del programa tiene `una buena explicación
202199
sobre estos atajos <https://code.visualstudio.com/docs/getstarted/keybindings>`_.
203200

@@ -298,10 +295,10 @@ archivos de configuración |JSON|:
298295
ejecución; y podrán vigilarse y manipularse los valores de las variables
299296
durante la depuración.
300297

301-
.. seealso:: A la configuración básica que proporcionan esas estadísticas, se le puede
302-
añadir otra adicional dentro de :file:`.vscode/launch.json`, cuyos
303-
princiipios pueden leerse en el artículo `Working with VSCode launch
304-
configurations <https://gigi.nullneuron.net/gigilabs/working-with-vs-code-launch-configurations/>`_.
298+
.. seealso:: A la configuración básica citada, se le puede añadir otra
299+
adicional dentro de :file:`.vscode/launch.json`, cuyos principios pueden
300+
leerse en el artículo `Working with VSCode launch configurations
301+
<https://gigi.nullneuron.net/gigilabs/working-with-vs-code-launch-configurations/>`_.
305302

306303
.. seealso:: Para aprender a depurar lea el artículo `Debugging
307304
<https://code.visualstudio.com/docs/editor/debugging>`_ de la
@@ -913,7 +910,7 @@ mientras que en *Windows* podemos utilizar los instalables que nos ofrece
913910
| `IntelliCode`_ | Proporciona sugerencias basadas en |IA| |
914911
+-----------------------------------------+---------------------------------------------------------------------------------------+
915912

916-
.. note:: :ref:`Code Runner <code-runner>` es absolutamente prescindible, ya que al tener
913+
.. caution:: :ref:`Code Runner <code-runner>` es absolutamente prescindible, ya que al tener
917914
instalada `Debugger for Java`_ podemos ejecutar los desarrollos pulsando
918915
:kbd:`Ctrl`\ +\ :kbd:`F5`.
919916
Además, :ref:`Code Runner <code-runner>` no atenderá a la jerarquía de directorios creados por
@@ -932,6 +929,42 @@ Además de estas extensiones puede interesarnos añadir configuración adicional
932929
"editor.inlayHints.enabled": "off"
933930
}
934931
932+
Además, durante la codificación puede interesarnos hacer alguna prueba
933+
individual de cómo funciona método a través de la consola interactiva `JShell
934+
<https://docs.oracle.com/en/java/javase/22/jshell/introduction-jshell.html>`_.
935+
Podemos, por supuesto, abrir una terminal (:kbd:`Ctrl`\ +\ :kbd:`\``) y escribir
936+
directamente la orden en ella, pero sin duda es más cómodo :ref:`crear una tarea
937+
<vscode-tasks>` y asociarla a una :ref:`combinación de teclas <vscode-atajos>`.
938+
La tarea podemos definirla con este código |JSON|:
939+
940+
.. code:: json
941+
942+
{
943+
"label": "Shell para Java",
944+
"type": "shell",
945+
"command": "jshell",
946+
"windows": {
947+
"command": "${env:JAVA_HOME}\\bin\\jshell.exe"
948+
},
949+
"presentation": {
950+
"reveal": "always",
951+
"panel": "new"
952+
},
953+
"problemMatcher": []
954+
}
955+
956+
y la asociación a la combinación :kbd:`Ctrl`\ +\ :kbd:`Shift`\ +\ :kbd:`J` de
957+
este modo:
958+
959+
.. code-block:: json
960+
961+
{
962+
"key": "ctrl+shift+j",
963+
"command": "workbench.action.tasks.runTask",
964+
"args": "Shell para Java"
965+
}
966+
967+
935968
**Creación del proyecto**
936969
Para comenzar un proyecto, en vez de abrir directamente un área de trabajo,
937970
lo mejor es *crear un nuevo proyecto* a través de la extensión `Project Manager

‎docs/searchindex.js

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎source/98.apendices/99.tools/10-vscode.rst

Lines changed: 45 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -171,9 +171,9 @@ archivos de configuración |JSON|:
171171
.. _vscode-atajos:
172172

173173
**Atajos de teclado**
174-
El programa da la posibilidad de asociar combinaciones de teclas a
175-
las distintas tareas definidas. Las asociaciones se puede hacer de
176-
distintos modos:
174+
A nivel de perfil (y no de área de trabajo), el programa ofrece la
175+
posibilidad de asociar combinaciones de teclas a las distintas tareas
176+
definidas. Las asociaciones se puede hacer de distintos modos:
177177

178178
.. rst-class:: simple
179179

@@ -192,12 +192,9 @@ archivos de configuración |JSON|:
192192

193193
.. image:: files/addkeybinding.png
194194

195-
El archivo contiene de un array en que cada *ítem* es una de esas
195+
El archivo contiene un array en que cada *ítem* es una de esas
196196
asociaciones. Más adelante se sugerirán algunos.
197197

198-
.. note:: Los atajos de teclado sólo se pueden definir para perfiles, no para
199-
áreas de trabajo.
200-
201198
.. seealso:: La ayuda oficial del programa tiene `una buena explicación
202199
sobre estos atajos <https://code.visualstudio.com/docs/getstarted/keybindings>`_.
203200

@@ -298,10 +295,10 @@ archivos de configuración |JSON|:
298295
ejecución; y podrán vigilarse y manipularse los valores de las variables
299296
durante la depuración.
300297

301-
.. seealso:: A la configuración básica que proporcionan esas estadísticas, se le puede
302-
añadir otra adicional dentro de :file:`.vscode/launch.json`, cuyos
303-
princiipios pueden leerse en el artículo `Working with VSCode launch
304-
configurations <https://gigi.nullneuron.net/gigilabs/working-with-vs-code-launch-configurations/>`_.
298+
.. seealso:: A la configuración básica citada, se le puede añadir otra
299+
adicional dentro de :file:`.vscode/launch.json`, cuyos principios pueden
300+
leerse en el artículo `Working with VSCode launch configurations
301+
<https://gigi.nullneuron.net/gigilabs/working-with-vs-code-launch-configurations/>`_.
305302

306303
.. seealso:: Para aprender a depurar lea el artículo `Debugging
307304
<https://code.visualstudio.com/docs/editor/debugging>`_ de la
@@ -913,7 +910,7 @@ mientras que en *Windows* podemos utilizar los instalables que nos ofrece
913910
| `IntelliCode`_ | Proporciona sugerencias basadas en |IA| |
914911
+-----------------------------------------+---------------------------------------------------------------------------------------+
915912

916-
.. note:: :ref:`Code Runner <code-runner>` es absolutamente prescindible, ya que al tener
913+
.. caution:: :ref:`Code Runner <code-runner>` es absolutamente prescindible, ya que al tener
917914
instalada `Debugger for Java`_ podemos ejecutar los desarrollos pulsando
918915
:kbd:`Ctrl`\ +\ :kbd:`F5`.
919916
Además, :ref:`Code Runner <code-runner>` no atenderá a la jerarquía de directorios creados por
@@ -932,6 +929,42 @@ Además de estas extensiones puede interesarnos añadir configuración adicional
932929
"editor.inlayHints.enabled": "off"
933930
}
934931
932+
Además, durante la codificación puede interesarnos hacer alguna prueba
933+
individual de cómo funciona método a través de la consola interactiva `JShell
934+
<https://docs.oracle.com/en/java/javase/22/jshell/introduction-jshell.html>`_.
935+
Podemos, por supuesto, abrir una terminal (:kbd:`Ctrl`\ +\ :kbd:`\``) y escribir
936+
directamente la orden en ella, pero sin duda es más cómodo :ref:`crear una tarea
937+
<vscode-tasks>` y asociarla a una :ref:`combinación de teclas <vscode-atajos>`.
938+
La tarea podemos definirla con este código |JSON|:
939+
940+
.. code:: json
941+
942+
{
943+
"label": "Shell para Java",
944+
"type": "shell",
945+
"command": "jshell",
946+
"windows": {
947+
"command": "${env:JAVA_HOME}\\bin\\jshell.exe"
948+
},
949+
"presentation": {
950+
"reveal": "always",
951+
"panel": "new"
952+
},
953+
"problemMatcher": []
954+
}
955+
956+
y la asociación a la combinación :kbd:`Ctrl`\ +\ :kbd:`Shift`\ +\ :kbd:`J` de
957+
este modo:
958+
959+
.. code-block:: json
960+
961+
{
962+
"key": "ctrl+shift+j",
963+
"command": "workbench.action.tasks.runTask",
964+
"args": "Shell para Java"
965+
}
966+
967+
935968
**Creación del proyecto**
936969
Para comenzar un proyecto, en vez de abrir directamente un área de trabajo,
937970
lo mejor es *crear un nuevo proyecto* a través de la extensión `Project Manager

0 commit comments

Comments
 (0)