Skip to Content
Nueva versión 12 disponible 🎉
DesktopOfuscación

Ofuscación

Un proyecto de ofuscación reúne los ensamblados que se van a proteger, sus dependencias y los ajustes de cada uno. Babel Desktop lo muestra como un grafo en un diagrama o como una tabla en una cuadrícula y lo ejecuta con el motor de Babel Obfuscator.

Babel Desktop guarda los proyectos como archivos .babel, el formato de proyecto de MSBuild que usa la tarea de MSBuild. Puede compilar con MSBuild un proyecto guardado en la aplicación, y abrir en la aplicación un proyecto .babel ya existente.

A partir de la versión 12.1.1, un proyecto guardado en un equipo donde la tarea de MSBuild está instalada carga la tarea desde el archivo de esa instalación, y un proyecto que todavía indica la tarea por el nombre del ensamblado y su versión se convierte al guardarlo. Consulte Tarea de MSBuild.

Babel Desktop conserva las partes de un archivo .babel que no edita, como los comentarios, las propiedades personalizadas y las tareas de MSBuild personalizadas. No evalúa las importaciones, las condiciones ni las tareas personalizadas de MSBuild: un proyecto que dependa de ellas debe compilarse con MSBuild. La única excepción es el elemento UsingTask de la tarea Babel, que se convierte como se describe arriba.

Destinos, dependencias y flujos

Un proyecto se compone de unos pocos tipos de elementos. Las demás páginas de esta sección usan estas palabras con el significado siguiente.

TérminoSignificado
DestinoUn ensamblado que el motor ofusca y escribe en su propio archivo de salida. Cada destino tiene sus propios ajustes. También se llama destino principal.
DependenciaUn ensamblado que se combina con un destino, se incrusta en él o solo se usa para resolver sus referencias. Una dependencia pertenece a un único destino y no tiene ajustes propios. Consulte Dependencias.
Vínculo de mapUna conexión entre dos destinos: el primero escribe su archivo map XML de renombrado y el segundo lo lee, de modo que los dos coinciden en los nombres nuevos de los símbolos públicos. Consulte Orden de ejecución.
FlujoUn grupo de destinos unidos entre sí por dependencias, vínculos de map u orden de ejecución. Los destinos de un flujo se ejecutan uno después de otro, en el orden de sus pasos.

Crear un proyecto

Un proyecto se prepara en cuatro pasos, desde añadir los ensamblados hasta la primera ejecución.

Añadir los ensamblados

Haga clic en Añadir ensamblados en la pantalla de inicio o en + Añadir ensamblado en la barra de herramientas (Ctrl+Shift+A, Cmd+Shift+A en macOS), o arrastre ensamblados .NET desde el administrador de archivos hasta el diagrama. Cada ensamblado se convierte en un destino: un nodo del diagrama y una fila de la cuadrícula.

Conectar las dependencias

Añada los ensamblados que se combinan con un destino, se incrustan en él o a los que este hace referencia, tal como se describe en Dependencias. Si se trata de un conjunto de ensamblados que se distribuyen juntos, conecte con vínculos de map los destinos que usan la API pública unos de otros.

Configurar cada destino

Seleccione un destino y abra el panel de propiedades para editar sus ajustes y sus reglas XML, o edite varios destinos a la vez en la cuadrícula. Consulte Ajustes del destino y La cuadrícula del proyecto.

Guardar y ejecutar

Guarde el proyecto con Archivo > Guardar (Ctrl+S, Cmd+S en macOS) y, a continuación, haga clic en Ejecutar proyecto (Ctrl+Enter, Cmd+Enter en macOS). Consulte Ejecutar el proyecto.

Los comandos de configuración realizan el segundo y el tercer paso en los casos más habituales: una aplicación con sus bibliotecas combinadas en ella, o un conjunto de bibliotecas cuyos símbolos públicos se renombran. Flujos de trabajo habituales describe los dos paso a paso.

Abrir y guardar proyectos

Un proyecto se guarda como archivo .babel. La mayoría de los comandos de proyecto están en el menú Archivo y tienen también un atajo de teclado.

AcciónCómo
Nuevo proyectoArchivo > Nuevo proyecto, Ctrl+N (Cmd+N en macOS), Proyecto: nuevo en la paleta de comandos o el botón Nuevo proyecto a la izquierda de la barra de herramientas
Abrir un proyectoArchivo > Abrir proyecto…, Ctrl+O (Cmd+O en macOS), el botón Abrir proyecto… de la pantalla de inicio o un archivo .babel soltado en la cuadrícula
Abrir un proyecto recienteProyecto: Abrir reciente… en la paleta de comandos
GuardarArchivo > Guardar, Ctrl+S (Cmd+S en macOS)
Guardar con otro nombreArchivo > Guardar como…, Ctrl+Shift+S (Cmd+Shift+S en macOS)

Guardar escribe el archivo .babel abierto y solo pide un nombre de archivo cuando el proyecto es nuevo. El cuadro de diálogo Abrir proyecto se abre en la carpeta del último proyecto abierto. Si el proyecto actual tiene cambios sin guardar, Babel Desktop pregunta si desea descartarlos antes de crear o abrir otro, y vuelve a preguntarlo antes de cerrar la ventana. Si hay una tarea en ejecución, espere a que termine antes de abrir otro proyecto.

Babel Desktop también recuerda, en este equipo, si la última vez vio un proyecto en el diagrama o en la cuadrícula. Cambiar de vista no modifica el archivo de proyecto.

Reemplazar una entrada

Para que un destino apunte a una compilación nueva de su ensamblado sin perder sus ajustes, seleccione el destino y ejecute Ensamblado: reemplazar entrada y conservar ajustes… desde la paleta de comandos. Ensamblado: quitar destino seleccionado, o Quitar ensamblado en el menú de un nodo o de una fila, quita un destino junto con sus dependencias y sus conexiones.

Páginas de esta sección

Las páginas siguientes tratan las dos vistas de un proyecto, cómo se conectan y ordenan sus destinos, su configuración, la ejecución y sus resultados, y terminan con ejemplos completos.

  • El diagrama del proyecto: la vista de grafo, sus nodos, el menú del nodo y cómo desplazarse por ella.
  • Dependencias: las dependencias de combinación, incrustación y referencia, y cómo combinar un destino con otro.
  • Orden de ejecución: flujos, pasos, conexiones de flujo y vínculos de map.
  • La cuadrícula del proyecto: la vista de tabla, la edición de muchos destinos a la vez, el orden de ejecución y los detalles de cada destino.
  • Ajustes del destino: el panel de propiedades, los archivos map, las reglas XML, los complementos del motor, los comandos de configuración y los niveles de protección.
  • Ejecutar el proyecto: los archivos de salida, el panel Actividad, las advertencias y los flujos que se ejecutan en paralelo.
  • Resultados de ejecución: la puntuación de ofuscación y las estadísticas de protección de cada ejecución.
  • Flujos de trabajo habituales: una aplicación, una aplicación con bibliotecas combinadas y un conjunto de bibliotecas con ofuscación pública.

Para devolver a sus nombres originales las trazas de pila ofuscadas de una aplicación protegida mediante sus archivos map XML, use el Descodificador de pila.

Last updated on