--- authors: - author: 'Ka Ho Ng' email: khng@FreeBSD.org copyright: '2021 The FreeBSD Foundation' description: 'Uso de Servidores de Lenguajes para desarrollo en el árbol de src de FreeBSD para obtener resultados precisos para saltar a definiciones o auto completado.' tags: ["FreeBSD", "Language Server", "LSP"] title: 'Uso de Servidores de Lenguajes para Desarrollo en el Árbol Src de FreeBSD' trademarks: ["freebsd"] --- = Uso de Servidores de Lenguajes para Desarrollo en el Árbol Src de FreeBSD :doctype: article :toc: macro :toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :source-highlighter: rouge :experimental: :images-path: articles/freebsd-src-lsp/ ifdef::env-beastie[] ifdef::backend-html5[] include::shared/authors.adoc[] include::shared/mirrors.adoc[] include::shared/releases.adoc[] include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists.adoc[] include::shared/{{% lang %}}/urls.adoc[] :imagesdir: ../../../images/{images-path} endif::[] ifdef::backend-pdf,backend-epub3[] include::../../../../shared/asciidoctor.adoc[] endif::[] endif::[] ifndef::env-beastie[] include::../../../../../shared/asciidoctor.adoc[] endif::[] toc::[] [[intro]] == Introducción Esta guía trata sobre cómo configurar el árbol de src de FreeBSD con servidores de lenguajes para realizar la indexación del código fuente. Esta guía describe los pasos para Vim/NeoVim y VSCode. Si usas un editor de texto diferente puedes usar esta guía como referencia y buscar los comandos equivalentes para tu editor. [[requirements]] == Requisitos Para seguir esta guía se necesita tener instalados ciertos requisitos. Necesitamos un servidor de lenguajes, `ccls` o `clangd`, y opcionalmente una base de datos de compilación. La instalación del servidor de Lenguajes se puede realizar con `pkg` o con ports. Si escogemos `clangd` tenemos que instalar `llvm`. Usando `pkg` para instalar `ccls`: [source, shell] .... # pkg install ccls .... Si queremos usar `clangd` necesitamos instalar `llvm` (El comando de ejemplo usa `llvm15` pero escoge la versión que quieras): [source, shell] .... # pkg install llvm15 .... Para instalar mediante ports escoge tu combinación favorita de herramientas de la lista que aparece abajo: * Implementaciones de servidores de lenguajes ** package:devel/ccls[] ** package:devel/llvm12[] (Otras versiones son válidas, pero cuanto más nuevo, mejor. Reemplaza `clangd12` con clangdN en caso de usar otra versión.) * Editores ** package:editors/vim[] ** package:editors/neovim[] ** package:editors/vscode[] * Generador de base de datos de compilación ** package:devel/python[] (Para la implementación de scan-build-py de llvm) ** package:devel/py-pip[] (Para la implementación de scan-build de rizsotto) ** package:devel/bear[] [[editor-settings]] == Configuración del editor [[settings-vim]] === Vim/Neovim ==== Plugins de LSP para el cliente Este ejemplo utiliza el gestor de plugins incorporado en ambos editores. El plugin de LSP para el cliente es link:https://github.com/prabirshrestha/vim-lsp[prabirshrestha/vim-lsp]. Para configurar el plugin cliente de LSP en Neovim: [source, shell] .... # mkdir -p ~/.config/nvim/pack/lsp/start # git clone https://github.com/prabirshrestha/vim-lsp ~/.config/nvim/pack/lsp/start/vim-lsp .... y para Vim: [source, shell] .... # mkdir -p ~/.vim/pack/lsp/start # git clone https://github.com/prabirshrestha/vim-lsp ~/.vim/pack/lsp/start/vim-lsp .... Para activar el plugin cliente de LSP en el editor, añade el siguiente fragmento en [.filepath]#~/.config/nvim/init.vim# cuando uses Neovim, o [.filepath]#~/.vim/vimrc# cuando uses Vim: .Para ccls [source, vim] .... au User lsp_setup call lsp#register_server({ \ 'name': 'ccls', \ 'cmd': {server_info->['ccls']}, \ 'allowlist': ['c', 'cpp', 'objc'], \ 'initialization_options': { \ 'cache': { \ 'hierarchicalPath': v:true \ } \ }}) .... .Para clangd [source, vim] .... au User lsp_setup call lsp#register_server({ \ 'name': 'clangd', \ 'cmd': {server_info->['clangd12', '--background-index', '--header-insertion=never']}, \ 'allowlist': ['c', 'cpp', 'objc'], \ 'initialization_options': {}, \ }) .... Dependiendo de la versión de `clangd` que hayas instalado podrías necesitar actualizar la `server-info` para apuntar al binario adecuado. Por favor, dirígete a link:https://github.com/prabirshrestha/vim-lsp/blob/master/README.md#registering-servers[] para aprender cómo configurar los atajos de teclado y el auto completado de código. El sitio oficial de clangd es link:https://clangd.llvm.org[], y el enlace al repositorio de ccls es link:https://github.com/MaskRay/ccls/[]. Abajo se muestra la configuración de referencia para los atajos de teclado y el auto completado de código. Pon el siguiente fragmento en [.filepath]#~/.config/nvim/init.vim#, o [.filepath]#~/.vim/vimrc# para usarlo con Vim: [source, vim] .... function! s:on_lsp_buffer_enabled() abort setlocal omnifunc=lsp#complete setlocal completeopt-=preview setlocal keywordprg=:LspHover nmap (lsp-definition) nmap ] (lsp-peek-definition) nmap (lsp-peek-definition) nmap gr (lsp-references) nmap (lsp-next-reference) nmap (lsp-previous-reference) nmap gI (lsp-implementation) nmap go (lsp-document-symbol) nmap gS (lsp-workspace-symbol) nmap ga (lsp-code-action) nmap gR (lsp-rename) nmap gm (lsp-signature-help) endfunction augroup lsp_install au! autocmd User lsp_buffer_enabled call s:on_lsp_buffer_enabled() augroup END .... [[settings-vscode]] === VSCode ==== Plugins de LSP para el cliente Los plugins de cliente de LSP son necesarios para arrancar un demonio de servidor de lenguajes. Presiona `Ctrl+Shift+X` para mostrar el panel de búsquedas online de extensiones. Teclea `llvm-vs-code-extensions.vscode-clangd` cuando utilices clangd, o `ccls-project.ccls` cuando utilices ccls. Después, presiona `Ctrl+Shift+P` para mostrar la paleta del editor de comandos. Teclea `Preferences: Open Settings (JSON)` y presiona `Enter` para abrir [.filepath]#settings.json#. Dependiendo de la implementación del servidor de lenguajes, utiliza uno de los siguientes pares de clave/valor de JSON en [.filepath]#settings.json#: .Para clangd [source, json] .... [ /* Begin of your existing configurations */ ... /* End of your existing configurations */ "clangd.arguments": [ "--background-index", "--header-insertion=never" ], "clangd.path": "clangd12" ] .... .Para ccls [source, json] .... [ /* Begin of your existing configurations */ ... /* End of your existing configurations */ "ccls.cache.hierarchicalPath": true ] .... [[cdb]] == Base de datos de compilación Una base de datos de compilación contiene un array de objetos de comandos de compilación. Cada objeto especifica una forma de compilar un fichero fuente. El fichero de la base de datos de compilación es normalmente [.filename]#compile_commands.json#. La base de datos es utilizada por el servidor de lenguajes con propósitos de indexado. Por favor consulta link:https://clang.llvm.org/docs/JSONCompilationDatabase.html#format[] para detalles acerca del formato del fichero de la base de datos de compilación. [[cdb-generators]] === Generadores [[generators-scan-build-py]] ==== Utilizando scan-build-py ===== Instalación La herramienta `intercept-build` de scan-build-py se utiliza para generar la base de datos de compilación. Instala package:devel/python[] primero para tener el intérprete de python. Para obtener `intercept-build` de LLVM: [source, shell] .... # git clone https://github.com/llvm/llvm-project /path/to/llvm-project .... donde [.filename]#/path/to/llvm-project/# es la ruta que quieres en el repositorio. Crea un alias en el fichero de configuración del shell para tu comodidad: [source, shell] .... alias intercept-build='/path/to/llvm-project/clang/tools/scan-build-py/bin/intercept-build' .... Se puede usar link:https://github.com/rizsotto/scan-build[rizsotto/scan-build] en lugar del scan-build-py de LLVM. El scan-build-py de LLVM era rizsotto/scan-build que se integró en el árbol de LLVM.Se puede instalar esta implementación mediante `pip install --user scan-build`. El script `intercept-build` está en [.filename]#~/.local/bin# por defecto. ===== Uso En el directorio de más alto nivel en el árbol src de FreeBSD, genera la base de datos de compilación con `intercept-build`: [source, shell] .... # intercept-build --append make buildworld buildkernel -j`sysctl -n hw.ncpu` .... El flag `--apend` le dice a `intercept-build` que lea una base de datos de compilación existente (si es que existe) y que añada los resultados a dicha base de datos. Las entradas con claves duplicadas de comandos son integradas. La base de datos de compilación generada por defecto se salva en el directorio de trabajo actual como [.filename]#compile_commands.json#. [[generators-bear]] ==== Usando devel/bear ===== Uso En el directorio de más alto nivel en el árbol src de FreeBSD, genera la base de datos de compilación con `bear`: [source, shell] .... # bear --append -- make buildworld buildkernel -j`sysctl -n hw.ncpu` .... El flag `--apend` le dice a `bear` que lea una base de datos de compilación existente (si es que existe) y que añada los resultados a dicha base de datos. Las entradas con claves duplicadas de comandos son integradas. La base de datos de compilación generada por defecto se salva en el directorio de trabajo actual como [.filename]#compile_commands.json#. [[final]] == Final Una vez que la base de datos de compilación ha sido generada, abre cualquier fichero fuente del árbol src de FreeBSD y el demonio servidor de LSP será arrancado también en segundo plano. Abrir ficheros fuente en el árbol src la primera vez lleva significativamente más tiempo antes de que el servidor LSP sea capaz de completar el resultado, debido al indexado inicial en segundo plano que realiza el servidor LSP mediante la compilación de todas las entradas listadas en la base de datos de compilación. Sin embargo el demonio de servicio de lenguajes no indexa ficheros fuente que no aparecen en la base de datos de compilación, por lo tanto no se muestran resultados completos para ficheros fuentes que no se compilan durante la ejecución de `make`.