Compatibilidad con CMake
CMake sigue siendo el modelo de proyecto que está más profundamente integrado en CLion.
Proyecto CMake
Abrir proyecto CMake
Cualquier proyecto basado en CMake se puede abrir fácilmente en CLion, sin necesidad de configuración adicional:
- apunte el proyecto al archivo de root CMakeLists.txt en las fuentes de su proyecto, o
- a la carpeta de generación existente o el archivo CMakeCache.txt (ésto solo funciona para el generador de Makefiles).
Marcar directorio como
En caso de que desee marcar directorios manualmente, como bibliotecas o fuentes / encabezados de proyecto, o excluir algunos directorios (por ejemplo, independientemente de la estructura del proyecto CMake), puede hacerlo con la funcionalidad Marcar directorio como. Esto afectará a la indexación (por ejemplo, puede excluir los directorios de compilación, binarios, registros y datos generados a partir de la indexación), junto con la generación de código, refactorizaciones y navegación. Más información.
Detectar CLion
Si necesita detectar si el comando CMake en su proyecto se ejecutó desde CLion (y si es así, configurar variables / rutas especiales o ejecutar algunos scripts adicionales de su elección) utilice la variable de entorno CLION_IDE . Para que sea más fácil de encontrarla, CLion le proporciona la finalización de las variables de entorno.
Añadir / eliminar archivos
Al añadir un nuevo archivo, CLion sugiere que se añada al destino de CMake.
Al eliminar archivos del proyecto, CLion elimina la referencia al archivo de los argumentos del comando, o le advierte sobre un comando posiblemente incorrecto después de la eliminación.
Importar proyectos
También puede importar proyectos que no sean de CMake (File | Import Project...), para los cuales CLion generará un archivo CMakeLists.txt.
Generadores CMake
La compatibilidad con la API CMake File permite a CLion activar varios generadores CMake. Los usuarios pueden seleccionar Ninja, Xcode, Visual Studio, etc. Esto funciona con todas las plataformas, en el modo remoto y con WSL.
Más informaciónConfiguración de CMake
Perfiles CMake
Con los perfiles CMake (Build, Execution, Deployment | CMake) usted tiene control sobre el directorio de generación de CMake, los tipos de configuración de CMake, las opciones y variables de entorno de CMake, etc.
Cree la cantidad de perfiles CMake que necesite desde cero, o copie los existentes (con todas las configuraciones ya incorporadas). Almacene la configuración de compilación de su proyecto en preajustes de CMake nuevos y universales, y CLion detectará e importará automáticamente los preajustes de CMake en perfiles de CMake.
Alterne entre los perfiles de CMake con el botón ejecutar configuración de la barra de herramientas o con el botón Ejecutar (Shift+Alt+F10)/ Depurar (Shift+Alt+F9) de la ventana de configuración emergente.
Ventana de herramientas y Caché de CMake
La ventana de herramientas de CMake contiene los registros de salida de CMake, que se pueden utilizar para rastrear el progreso y depurar los scripts de CMake.
Puede revisar las variables de la caché de CMake y actualizar las opciones de CMake que se pasan al comando CMake en una única interfaz de usuario basada en una tabla en Settings | Build, Execution, Deployment | CMake.
Cuando la tabla esté enfocada, comience a escribir para buscar una variable o su valor. CLion también muestra la descripción corta en las descripciones emergentes de las variables de caché de CMake.
Menú de CMake
Vaya a Tools | CMake para realizar operaciones útiles relacionadas con CMake:
- Volver a cargar Proyecto de CMake se puede utilizar para aplicar los últimos cambios de CMake y forzar a CLion a volver a cargar el proyecto para que éstos se reflejen en el editor (la recarga automática se puede habilitar en
Build, Execution, Deployment | CMake). - Cambiar Root del Proyecto es útil en caso de que su directorio root del proyecto difiera del directorio donde se encuentra el archivo de nivel superior CMakeLists.txt.
- Restablecer Caché y Recargar Proyecto le permite borrar el caché de CMake sin eliminar todos los índices y cachés del IDE.
Compatibilidad inteligente con CMake
Cambiar nombre en CMake
Si utiliza la refactorización Rename Shift+F6 para cambiar el nombre de los símbolos de usuario en CMake (como funciones o macros), todos los usos se actualizarán automáticamente.
Instalar CMake
Si tiene algún destino de instalación de CMake en su proyecto, ahora puede invocar Install desde el menú Run de CLion. El comando instalar de cmake se ejecutará. Alternativamente, puede agregar un paso de instalación a cualquiera de sus configuraciones de ejecución en CLion.
Comentarios en CMake
CLion es compatible con los argumentos de 3 corchetes y la sintaxis de comentarios de bloque de CMake. Para comentar rápidamente una línea en CMake, no es necesario que la seleccione, simplemente coloque el signo de intercalación sobre ella y presione Ctrl+/. Para comentar un bloque, selecciónelo y presione Ctrl+Shift+/.
Asistencia a la codificación en CMakeLists.txt
El editor de archivos CMake en CLion le ayuda a editar los archivos CMakeLists.txt más fácilmente. Esto incluye:
- Ajuste de fuente y color de CMake.
- La capacidad de expandir y contraer varias regiones de código en CMake.
- Finalización de código para comandos y variables de CMake.
- Finalización de código para
find_packagepara los paquetes incluidos en CMake. - Documentación de comandos CMake en la finalización del código.
- Vista de estructura de CMake.
- Tachado de los comandos obsoletos en CMake.
Generación de código en CMake
Cree construcciones de código personalizadas o de uso frecuente en CMake y vuelva a utilizarlas con plantillas personalizables. Seleccione entre plantillas predefinidas o cree las suyas propias.
Para utilizar la plantilla, escriba su abreviatura (aquí también puede utilizar la función autocompletar) y luego presione Tab (o cualquier tecla no predeterminada que haya configurado) para expandir la plantilla.
Una vez que haya finalizado la edición, aparecerá un banner donde puede elegir volver a cargar el proyecto actual manualmente o habilitar la carga automática en cada edición.
Quick Documentation en CMake
La ventana emergente de Quick Documentation está ahora disponible en los scripts de CMake. Se muestra la documentación para las entidades estándar de CMake:
- Comandos
- Políticas
- Módulos
- Variables
- Propiedades
Siempre se muestra la documentación para la versión de CMake actualmente incluida, y por ahora no está disponible para las entidades definidas por el usuario.
Depurador CMake
Dado que CMake es un lenguaje de sistemas de compilación, la investigación de errores y la detección de comportamientos sospechosos en un script de CMake no siempre es sencilla. Puede depurar los scripts de CMake en CLion como código normal. Establezca puntos de interrupción, recorra el código y observe las variables y los objetivos de CMake. Más información.
Perfilado CMake
En CLion, puede inspeccionar visualmente por qué tarda mucho tiempo en recargar su proyecto CMake. A partir de CMake 3.18, se puede activar el nuevo rastreo en la configuración de CMake. CLion le ayudará a ejecutar el trazado y a visualizar los resultados. Más información.