Configuración

Las siguientes instrucciones son para configurar a Eclipse Photon y el plugin Counterclockwise, algunas opciones son subjetivas y quedan en tí. El objetivo es configurar a Eclipse Photon para el desarrollo de proyectos en Clojure:

  • Configuración de Counterclockwise:

    • En Window > Preferences > Clojure > General:

      • Desactiva la opción Launch REPLs with cider-nrepl.

      • Activa el resto de opciones.

    • En Window > Preferences > Clojure > Editor:

      • Activa las opciones:

        • Start editors in strict/paredit Edit mode.
        • Start editors with rainbow parens.
        • Escape text when pasting into a string literal.
      • Desactiva las opciones:

        • Always use 2 spaces for indentation.
        • Auto activate Code Completion.
    • En Window > Preferences > Clojure > Editor > Hovers:

      • Desactiva todas las opciones bajo la columna Hover Name.
    • En Window > Preferences > Clojure > REPL View

      • Desactiva:

        • Trailing [Enter] sends valid REPL content.
        • Show hints (inputs area's top right corner, input area placeholder).
  • Configuración de Eclipse:

    • En Window > Perspective > Customize Perspective... > Action Set Availability > Available Action Sets:

      • Activa solamente a Convert Line Delimiters, Git y Open Files, las demás opciones desactivalas.
    • En Window > Perspective > Customize Perspective... > Shortcuts:

      • Submenus > New > Shorcut Categories:

        • Activa solamente a Clojure, General y Git, las demás opciones desactivalas.
      • Submenus > Show View > Shorcut Categories:

        • Activa solamente a Clojure, General, Git y Java, las demás opciones desactivalas.
    • En Window > Preferences > General:

      • Activa solamente a Always run in background y Single click, las demás opciones desactivalas.
    • En Window > Preferences > General > Appearance:

      • Selecciona Classic para la opción Theme y Default (current) para Color and Font theme.

      • Desactiva las opciones Enable animations y Use mixed fonts and colors for labels.

    • En Window > Preferences > General > Appearance > Label Decorations > Available label decorations:

      • Desactiva todas las opciones.
    • En Window > Preferences > General > Editors:

      • Desactiva a Restore editor state on startup y Close editors automatically, las demás opciones activalas.
    • En Window > Preferences > General > Startup and Shutdown > Plug-ins activated at startup:

      • Activa solamente a Counterclockwise Clojure Plug-in, las demás opciones desactivalas.
    • En Window > Preferences > Code Recommenders:

      • Desactiva todas las opciones inmediatamente encontradas en Advisors, Completions, Models y Snipchat. Las opciones anidadas en Completions no son modificadas.
    • En Window > Preferences > Install/Update > Automatic Updates:

      • Desactiva a Autocatically find new updates and notify me.
    • Finalmente:

      1. Cierra la pestaña de Welcome y te encontrarás ante la Perspectiva Java.

      2. En la Perspectiva Java cierra las pestañas (vistas o views) Task List, Javadoc y Declaration.

      3. Activa las siguientes vistas (views) de Eclipse:

        • Window > Show View > Console
        • Window > Show View > Namespace Browser
      4. Oculta la barra de herramientas accediendo a Window > Hide Toolbar.

      5. Accede a Window > Perspective > Save Perspective As..., en el campo Name introduce Clojure y da click al botón de OK. A partir de este momento estarás en la Perspectiva Clojure:

        images/09.png

  • Mejora el aspecto visual del editor de texto en Eclipse:

    Integra el plugin Eclipse Color Theme a Eclipse. Similar al proceso de instalar el plugin Counterclockwise a Eclipse, pero con los datos:

    • Name: Eclipse Color Theme
    • Location: http://eclipse-color-theme.github.io/update/
  • Codificación de caracteres

    Es importante el uso de UTF-8 en el código fuente de Clojure por lo que en Eclipse accede a Window > Preferences > General > Workspace y en la sección Text file encoding selecciona a UTF-8 de las opciones para Other:

    En esta misma sección selecciona las opciones Show perspective name y Show full workspace path (bajo Window title), da clic al botón Apply y finalmente al botón OK.

  • Desactivar el corrector ortográfico:

    Accede a Window > Preferences> General > Editors > Text Editors > Spelling y desactiva la opción Enable spell checking, da clic al botón Apply y posteriormente al botón OK.

  • Mejorar desempeño de Eclipse:

    Existe una gran cantidad de información en la Web sobre como mejorar/optimizar el desempeño/rendimiento de Eclipse.

    Lo siguiente se logra editando el archivo eclipse.ini que es el archivo de configuración de ejecución de Eclipse y se encuentra dentro del directorio de instalación de Eclipse: C:\plf\clojure\eclipse. En dicho archivo encontrarás los siguientes parámetros dados a la Máquina Virtual de Java (JVM): -XX:MaxPermSize, -Xms y -Xmx.

    Las modificaciones serían las siguientes:

    • Elimina (si es que existe) la línea -XX:MaxPermSize y la línea 256m (o 512m) justo debajo de esta.
    • Agregar al final las opciones:

      • -Xms con valor de 512m
      • -Xmx con valor de 1024m
      • -Xss con valor de 2m

      Estos valores para una computadora con 2G en memoria RAM, para una de 4G puedes incrementar en mitad los valores.

    Muestro a continuación, como ejemplo, el contenido de C:\plf\clojure\eclipse\eclipse.ini una vez hecho las anteriores modificaciones, siendo las últimas 4 líneas las más importantes:

    -startup
    plugins/org.eclipse.equinox.launcher...
    --launcher.library
    plugins/org.eclipse.equinox.launcher...
    -product
    org.eclipse.epp.package.java.product
    -showsplash
    org.eclipse.epp.package.common
    --launcher.defaultAction
    openFile
    --launcher.defaultAction
    openFile
    --launcher.appendVmargs
    -vmargs
    -Dosgi.requiredJavaVersion=1.8
    -Dosgi.instance.area.default=@user.home/eclipse-workspace
    -XX:+UseG1GC
    -XX:+UseStringDeduplication
    --add-modules=ALL-SYSTEM
    -Dosgi.requiredJavaVersion=1.8
    -Dosgi.dataAreaRequiresExplicitInit=true
    -Xms512m
    -Xmx1024m
    -Xss2m
    --add-modules=ALL-SYSTEM
    

Algunas sugerencias encontradas en la Web pueden ya no ser útiles (por la versión de Eclipse o JDK usados) o bien pueden ser perjudiciales (en caso de usar parámetros para Eclipse o JDK) que dependan directamente de los recursos (RAM/CPU) en la computadora.

Si todo ha salido bien, puedes continuar con las prácticas.