Skip to content

Commit 0a139e7

Browse files
committed
Añade Maven a las instrucciones de Visual Studio Code sobre Java
1 parent d1a91c4 commit 0a139e7

File tree

4 files changed

+157
-7
lines changed

4 files changed

+157
-7
lines changed

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

Lines changed: 48 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -405,7 +405,7 @@ <h3>Inicialización<a class="headerlink" href="#inicializacion" title="Enlace pe
405405
<p class="admonition-title">Prudencia</p>
406406
<p>El <em>commit</em> necesita realizarse bajo una identidad. Si no hay
407407
definida ninguna en el archivo de configuración de <em>Git</em>
408-
(<code class="file docutils literal notranslate"><span class="pre">~/gitconfig</span></code> en <em>Linux</em> o <code class="file docutils literal notranslate"><span class="pre">%USERPROFILE%.gitconfig</span></code> en
408+
(<code class="file docutils literal notranslate"><span class="pre">~/.gitconfig</span></code> en <em>Linux</em> o <code class="file docutils literal notranslate"><span class="pre">%USERPROFILE%\.gitconfig</span></code> en
409409
<em>Windows</em>) la acción no se llevará a cabo, así que tendremos que realizarla
410410
antes:</p>
411411
<div class="highlight-ini notranslate"><div class="highlight"><pre><span></span><span class="k">[user]</span>
@@ -990,7 +990,7 @@ <h2>Perfiles de desarrollo<a class="headerlink" href="#perfiles-de-desarrollo" t
990990
necesidad de que el archivo activo sea <code class="file docutils literal notranslate"><span class="pre">App.java</span></code> podemos crear un
991991
<code class="file docutils literal notranslate"><span class="pre">launch.json</span></code><a class="footnote-reference brackets" href="#id15" id="id8" role="doc-noteref"><span class="fn-bracket">[</span>7<span class="fn-bracket">]</span></a>:</p>
992992
<div class="highlight-json notranslate"><div class="highlight"><pre><span></span><span class="p">{</span>
993-
<span class="w"> </span><span class="nt">&quot;version&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;0.2.0&quot;</span><span class="p">,</span>
993+
<span class="w"> </span><span class="nt">&quot;version&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;2.0.0&quot;</span><span class="p">,</span>
994994
<span class="w"> </span><span class="nt">&quot;configurations&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
995995
<span class="w"> </span><span class="p">{</span>
996996
<span class="w"> </span><span class="nt">&quot;type&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;java&quot;</span><span class="p">,</span>
@@ -1012,6 +1012,52 @@ <h2>Perfiles de desarrollo<a class="headerlink" href="#perfiles-de-desarrollo" t
10121012
<p>En este caso, hemos definido dos mecanismos de ejecución. La diferencia entre
10131013
ambos es que el segundo comprobará las <a class="reference external" href="https://es.wikipedia.org/wiki/Aserci%C3%B3n_(inform%C3%A1tica)">aserciones</a>.</p>
10141014
</dd>
1015+
<dt><strong>Proyecto con Maven</strong></dt><dd><p>Una alternativa a lo anterior es usar <a class="reference external" href="https://maven.apache.org/">Maven</a>, que tiene la ventaja de
1016+
simplificar el uso de librerías de terceros. Para ello, necesitaremos haber
1017+
instalado la extensión <a class="reference external" href="https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-maven">Maven for Java</a></p>
1018+
<p>Al escoger la creación de un proyecto con <a class="reference external" href="https://maven.apache.org/">Maven</a> se nos pedirá escoger un
1019+
<em>groupID</em> y un <em>artifactID</em> (véanse <a class="reference external" href="https://maven.apache.org/guides/mini/guide-naming-conventions.html">las explicaciones al respecto en la página del propio software</a>). El proyecto tendrá esta estructura:</p>
1020+
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>+- src
1021+
| +-- main
1022+
| | +-- java
1023+
| | +-- es
1024+
| | +-- iescastillodeluna
1025+
| | +-- Main.java
1026+
| | +-- ... archivos del proyecto
1027+
| +-- test (pruebas de software)
1028+
|
1029+
+- target (aquí dentro se guardan los .class)
1030+
+- pom.xml (configuración de Maven)
1031+
</pre></div>
1032+
</div>
1033+
<p>La gestión del proyecto no es muy distinta de la ya descrita, aunque
1034+
deberemos cambiar el valor de la <em>mainClass</em> del <code class="file docutils literal notranslate"><span class="pre">launch.json</span></code>:</p>
1035+
<div class="highlight-json notranslate"><div class="highlight"><pre><span></span><span class="p">{</span>
1036+
<span class="w"> </span><span class="nt">&quot;version&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;2.0.0&quot;</span><span class="p">,</span>
1037+
<span class="w"> </span><span class="nt">&quot;configurations&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
1038+
<span class="w"> </span><span class="p">{</span>
1039+
<span class="w"> </span><span class="nt">&quot;type&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;java&quot;</span><span class="p">,</span>
1040+
<span class="w"> </span><span class="nt">&quot;name&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Main&quot;</span><span class="p">,</span>
1041+
<span class="w"> </span><span class="nt">&quot;request&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;launch&quot;</span><span class="p">,</span>
1042+
<span class="hll"><span class="w"> </span><span class="nt">&quot;mainClass&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;es.iescastillodeluna.Main&quot;</span>
1043+
</span><span class="w"> </span><span class="p">},</span>
1044+
<span class="w"> </span><span class="p">{</span>
1045+
<span class="w"> </span><span class="nt">&quot;type&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;java&quot;</span><span class="p">,</span>
1046+
<span class="w"> </span><span class="nt">&quot;name&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Main (assert)&quot;</span><span class="p">,</span>
1047+
<span class="w"> </span><span class="nt">&quot;request&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;launch&quot;</span><span class="p">,</span>
1048+
<span class="hll"><span class="w"> </span><span class="nt">&quot;mainClass&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;es.iescastillodeluna.Main&quot;</span><span class="p">,</span>
1049+
</span><span class="w"> </span><span class="nt">&quot;vmArgs&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;-ea&quot;</span>
1050+
<span class="w"> </span><span class="p">}</span>
1051+
<span class="w"> </span><span class="p">]</span>
1052+
<span class="p">}</span>
1053+
</pre></div>
1054+
</div>
1055+
<div class="admonition note">
1056+
<p class="admonition-title">Nota</p>
1057+
<p>Y, posiblemente, también nos interese modificar el valor de
1058+
<cite>files.exclude</cite> para incluir <code class="file docutils literal notranslate"><span class="pre">target/</span></code></p>
1059+
</div>
1060+
</dd>
10151061
<dt><strong>Exportar JAR</strong></dt><dd><p>Una acción muy recorrente, una vez que tengamos acabado un proyecto, es crear
10161062
un <abbr title="Java ARchive">JAR</abbr> a fin de distribuir el ejecutable de la aplicación (esto es, sólo
10171063
los archivos <cite>.class</cite> y no el código fuente). Con <strong class="program">Visual Studio

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

Lines changed: 54 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -368,7 +368,7 @@ permite indicar con qué mensaje queremos identificarlo):
368368

369369
.. caution:: El *commit* necesita realizarse bajo una identidad. Si no hay
370370
definida ninguna en el archivo de configuración de *Git*
371-
(:file:`~/gitconfig` en *Linux* o :file:`%USERPROFILE%\.gitconfig` en
371+
(:file:`~/.gitconfig` en *Linux* o :file:`%USERPROFILE%\\.gitconfig` en
372372
*Windows*) la acción no se llevará a cabo, así que tendremos que realizarla
373373
antes:
374374

@@ -998,7 +998,7 @@ este modo:
998998
.. code-block:: json
999999
10001000
{
1001-
"version": "0.2.0",
1001+
"version": "2.0.0",
10021002
"configurations": [
10031003
{
10041004
"type": "java",
@@ -1020,6 +1020,57 @@ este modo:
10201020
ambos es que el segundo comprobará las `aserciones
10211021
<https://es.wikipedia.org/wiki/Aserci%C3%B3n_(inform%C3%A1tica)>`_.
10221022

1023+
**Proyecto con Maven**
1024+
Una alternativa a lo anterior es usar Maven_, que tiene la ventaja de
1025+
simplificar el uso de librerías de terceros. Para ello, necesitaremos haber
1026+
instalado la extensión `Maven for Java
1027+
<https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-maven>`_
1028+
1029+
Al escoger la creación de un proyecto con Maven_ se nos pedirá escoger un
1030+
*groupID* y un *artifactID* (véanse `las explicaciones al respecto en la página del propio software <https://maven.apache.org/guides/mini/guide-naming-conventions.html>`_). El proyecto tendrá esta estructura:
1031+
1032+
.. code-block:: none
1033+
1034+
+- src
1035+
| +-- main
1036+
| | +-- java
1037+
| | +-- es
1038+
| | +-- iescastillodeluna
1039+
| | +-- Main.java
1040+
| | +-- ... archivos del proyecto
1041+
| +-- test (pruebas de software)
1042+
|
1043+
+- target (aquí dentro se guardan los .class)
1044+
+- pom.xml (configuración de Maven)
1045+
1046+
La gestión del proyecto no es muy distinta de la ya descrita, aunque
1047+
deberemos cambiar el valor de la *mainClass* del :file:`launch.json`:
1048+
1049+
.. code-block:: json
1050+
:emphasize-lines: 8, 14
1051+
1052+
{
1053+
"version": "2.0.0",
1054+
"configurations": [
1055+
{
1056+
"type": "java",
1057+
"name": "Main",
1058+
"request": "launch",
1059+
"mainClass": "es.iescastillodeluna.Main"
1060+
},
1061+
{
1062+
"type": "java",
1063+
"name": "Main (assert)",
1064+
"request": "launch",
1065+
"mainClass": "es.iescastillodeluna.Main",
1066+
"vmArgs": "-ea"
1067+
}
1068+
]
1069+
}
1070+
1071+
.. note:: Y, posiblemente, también nos interese modificar el valor de
1072+
`files.exclude` para incluir :file:`target/`
1073+
10231074
**Exportar JAR**
10241075
Una acción muy recorrente, una vez que tengamos acabado un proyecto, es crear
10251076
un |JAR| a fin de distribuir el ejecutable de la aplicación (esto es, sólo
@@ -1091,3 +1142,4 @@ este modo:
10911142
.. _IntelliCode: https://marketplace.visualstudio.com/items?itemName=VisualStudioExptTeam.vscodeintellicode
10921143
.. _Github: https://github.com
10931144
.. _Git: https://git-scm.com
1145+
.. _Maven: https://maven.apache.org/

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: 54 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -368,7 +368,7 @@ permite indicar con qué mensaje queremos identificarlo):
368368

369369
.. caution:: El *commit* necesita realizarse bajo una identidad. Si no hay
370370
definida ninguna en el archivo de configuración de *Git*
371-
(:file:`~/gitconfig` en *Linux* o :file:`%USERPROFILE%\.gitconfig` en
371+
(:file:`~/.gitconfig` en *Linux* o :file:`%USERPROFILE%\\.gitconfig` en
372372
*Windows*) la acción no se llevará a cabo, así que tendremos que realizarla
373373
antes:
374374

@@ -998,7 +998,7 @@ este modo:
998998
.. code-block:: json
999999
10001000
{
1001-
"version": "0.2.0",
1001+
"version": "2.0.0",
10021002
"configurations": [
10031003
{
10041004
"type": "java",
@@ -1020,6 +1020,57 @@ este modo:
10201020
ambos es que el segundo comprobará las `aserciones
10211021
<https://es.wikipedia.org/wiki/Aserci%C3%B3n_(inform%C3%A1tica)>`_.
10221022

1023+
**Proyecto con Maven**
1024+
Una alternativa a lo anterior es usar Maven_, que tiene la ventaja de
1025+
simplificar el uso de librerías de terceros. Para ello, necesitaremos haber
1026+
instalado la extensión `Maven for Java
1027+
<https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-maven>`_
1028+
1029+
Al escoger la creación de un proyecto con Maven_ se nos pedirá escoger un
1030+
*groupID* y un *artifactID* (véanse `las explicaciones al respecto en la página del propio software <https://maven.apache.org/guides/mini/guide-naming-conventions.html>`_). El proyecto tendrá esta estructura:
1031+
1032+
.. code-block:: none
1033+
1034+
+- src
1035+
| +-- main
1036+
| | +-- java
1037+
| | +-- es
1038+
| | +-- iescastillodeluna
1039+
| | +-- Main.java
1040+
| | +-- ... archivos del proyecto
1041+
| +-- test (pruebas de software)
1042+
|
1043+
+- target (aquí dentro se guardan los .class)
1044+
+- pom.xml (configuración de Maven)
1045+
1046+
La gestión del proyecto no es muy distinta de la ya descrita, aunque
1047+
deberemos cambiar el valor de la *mainClass* del :file:`launch.json`:
1048+
1049+
.. code-block:: json
1050+
:emphasize-lines: 8, 14
1051+
1052+
{
1053+
"version": "2.0.0",
1054+
"configurations": [
1055+
{
1056+
"type": "java",
1057+
"name": "Main",
1058+
"request": "launch",
1059+
"mainClass": "es.iescastillodeluna.Main"
1060+
},
1061+
{
1062+
"type": "java",
1063+
"name": "Main (assert)",
1064+
"request": "launch",
1065+
"mainClass": "es.iescastillodeluna.Main",
1066+
"vmArgs": "-ea"
1067+
}
1068+
]
1069+
}
1070+
1071+
.. note:: Y, posiblemente, también nos interese modificar el valor de
1072+
`files.exclude` para incluir :file:`target/`
1073+
10231074
**Exportar JAR**
10241075
Una acción muy recorrente, una vez que tengamos acabado un proyecto, es crear
10251076
un |JAR| a fin de distribuir el ejecutable de la aplicación (esto es, sólo
@@ -1091,3 +1142,4 @@ este modo:
10911142
.. _IntelliCode: https://marketplace.visualstudio.com/items?itemName=VisualStudioExptTeam.vscodeintellicode
10921143
.. _Github: https://github.com
10931144
.. _Git: https://git-scm.com
1145+
.. _Maven: https://maven.apache.org/

0 commit comments

Comments
 (0)