Cómo agregar archivos de recursos en ejecutables de Delphi

Los juegos y otros tipos de aplicaciones que usan archivos multimedia como sonidos y animaciones deben distribuya los archivos multimedia adicionales junto con la aplicación o incruste los archivos dentro del ejecutable.

En lugar de distribuir archivos separados para el uso de su aplicación, puede agregar los datos sin procesar a su aplicación como un recurso. Luego puede recuperar los datos de su aplicación cuando sea necesario. Esta técnica es generalmente más deseable porque puede evitar que otros manipulen esos archivos de complemento.

Este artículo te mostrará cómo incrustar (y usar) archivos de sonido, videoclips, animaciones y, en general, cualquier tipo de archivos binarios en un ejecutable de Delphi. Para el propósito más general, verás cómo poner un Archivo MP3 dentro de una Delphi exe.

En el "Archivos de recursos simplificados"En el artículo se le presentaron varios ejemplos del uso de mapas de bits, íconos y cursores de los recursos Como se indica en ese artículo, podemos usar el Editor de imágenes para crear y editar recursos que consisten en ese tipo de archivos. Ahora, cuando estamos interesados ​​en almacenar varios tipos de archivos (binarios) dentro de un ejecutable de Delphi, tendremos que lidiar con los archivos de script de recursos (.rc), el

La inclusión de varios archivos binarios en su ejecutable consta de 5 pasos:

1. Cree y / o recopile todos los archivos que desea poner en un exe.
2. Cree un archivo de script de recursos (.rc) que describa los recursos utilizados por su aplicación,
3. Compile el archivo de archivo de script de recursos (.rc) para crear un archivo de recursos (.res),
4. Enlace el archivo de recursos compilado al archivo ejecutable de la aplicación,
5. Usar elemento de recurso individual.

El primer paso debe ser simple, simplemente decida qué tipos de archivos le gustaría almacenar en su ejecutable. Por ejemplo, almacenaremos dos canciones .wav, una animación .ani y una canción .mp3.

Antes de continuar, aquí hay algunas declaraciones importantes sobre las limitaciones al trabajar con recursos:

• Cargar y descargar recursos no es una operación que requiere mucho tiempo. Los recursos son parte del archivo ejecutable de las aplicaciones y se cargan al mismo tiempo que se ejecuta la aplicación.
• Toda la memoria (libre) se puede usar al cargar / descargar recursos. En otras palabras, no hay límites en la cantidad de recursos cargados al mismo tiempo.
• Por supuesto, los archivos de recursos duplican el tamaño de un ejecutable. Si desea archivos ejecutables más pequeños, considere colocar recursos y partes de su proyecto en un biblioteca de enlaces dinámicos (DLL) o es más variación especializada.

Veamos ahora cómo crear un archivo que describa los recursos.

Un archivo de script de recursos es simplemente un archivo de texto simple con la extensión .rc que enumera los recursos. El archivo de script tiene este formato:

ResName1 ResTYPE1 ResFileName1
ResName2 ResTYPE2 ResFileName2
...
ResNameX ResTYPEX ResFileNameX
...

RexName especifica un nombre único o un valor entero (ID) que identifica el recurso. ResType describe el tipo de recurso y el ResFileName es la ruta completa y el nombre del archivo del recurso individual.

Para crear un nuevo archivo de script de recursos, simplemente haga lo siguiente:

1. Cree un nuevo archivo de texto en su directorio de proyectos.
2. Cámbiele el nombre a AboutDelphi.rc.

En el archivo AboutDelphi.rc, tenga las siguientes líneas:

Clock WAVE "c: \ mysounds \ projects \ clock.wav"
MailBeep WAVE "c: \ windows \ media \ newmail.wav"
Cool AVI cool.avi
Introducción RCDATA introsong.mp3

El archivo de script simplemente define recursos. Siguiendo el formato dado, el script AboutDelphi.rc enumera dos archivos .wav, una animación .avi y una canción .mp3. Todas las declaraciones en un archivo .rc asocian un nombre de identificación, tipo y nombre de archivo para un recurso dado. Hay alrededor de una docena de tipos de recursos predefinidos. Estos incluyen iconos, mapas de bits, cursores, animaciones, canciones, etc. El RCDATA define recursos de datos genéricos. RCDATA le permite incluir un recurso de datos sin procesar para una aplicación. Los recursos de datos sin procesar permiten la inclusión de datos binarios directamente en el archivo ejecutable. Por ejemplo, la declaración RCDATA anterior nombra la introducción de recursos binarios de la aplicación y especifica el archivo introsong.mp3, que contiene la canción para ese archivo MP3.

Nota: asegúrese de tener todos los recursos que enumere en su archivo .rc disponibles. Si los archivos están dentro de su directorio de proyectos, no tiene que incluir el nombre completo del archivo. En mi archivo .rc, las canciones .wav se encuentran * en algún lugar * del disco y tanto la animación como la canción MP3 se encuentran en el directorio del proyecto.

Para utilizar los recursos definidos en el archivo de script de recursos, debemos compilarlo en un archivo .res con el compilador de recursos de Borland. El compilador de recursos crea un nuevo archivo basado en el contenido del archivo de script de recursos. Este archivo generalmente tiene una extensión .res. El vinculador de Delphi luego formateará el archivo .res en un archivo de objeto de recurso y luego lo vinculará al archivo ejecutable de una aplicación.

La herramienta de línea de comandos del compilador de recursos de Borland se encuentra en el directorio Delphi Bin. El nombre es BRCC32.exe. Simplemente vaya al símbolo del sistema y escriba brcc32 y luego presione Entrar. Dado que el directorio Delphi \ Bin está en su ruta, se invoca el compilador Brcc32 y muestra la ayuda de uso (ya que se llamó sin parámetros).

Para compilar el archivo AboutDelphi.rc en un archivo .res, ejecute este comando en el símbolo del sistema (en el directorio de proyectos):

BRCC32 Acerca de Delphi. RC

De manera predeterminada, al compilar recursos, BRCC32 nombra el archivo de recursos compilados (.RES) con el nombre base del archivo .RC y lo coloca en el mismo directorio que el archivo .RC.

Puede nombrar el archivo de recursos como desee, siempre que tenga la extensión ".RES" y el nombre de archivo sin la extensión no sea el mismo que el de cualquier unidad o nombre de proyecto. Esto es importante porque, por defecto, cada proyecto Delphi que se compila en una aplicación tiene un archivo de recursos con el mismo nombre que el archivo del proyecto, pero con la extensión .RES. Es mejor guardar el archivo en el mismo directorio que su archivo de proyecto.

Una vez que el archivo .RES está vinculado al archivo ejecutable, la aplicación puede cargar sus recursos en tiempo de ejecución según sea necesario. Para usar realmente el recurso, deberá realizar algunas llamadas a la API de Windows.

Para seguir el artículo, necesitará un nuevo proyecto de Delphi con un formulario en blanco (el nuevo proyecto predeterminado). Por supuesto, agregue el {$ R AboutDelphi. RES} directiva a la unidad del formulario principal. Finalmente es hora de ver cómo usar los recursos en una aplicación Delphi. Como se mencionó anteriormente, para usar los recursos almacenados dentro de un archivo exe tenemos que lidiar con la API. Sin embargo, se pueden encontrar varios métodos en los archivos de ayuda de Delphi que tienen habilitados los "recursos".

Por ejemplo, eche un vistazo a LoadFromResourceName método de un objeto TBitmap. Este método extrae el recurso de mapa de bits especificado y le asigna el objeto TBitmap. Esto es * exactamente * lo que hace la llamada a la API de LoadBitmap. Como siempre, Delphi ha mejorado una llamada a la función API para satisfacer mejor sus necesidades.

Ahora, agregue el componente TMediaPlayer a un formulario (nombre: MediaPlayer1) y agregue un TButton (Button2). Deje que el evento OnClick se vea así:

Un pequeño * problema * es que la aplicación crea una canción MP3 en una máquina de usuario. Puede agregar un código que elimine ese archivo antes de que finalice la aplicación.

Por supuesto, cualquier otro tipo de archivo binario se puede almacenar como un tipo RCDATA. El TRsourceStream está diseñado especialmente para ayudarnos a extraer dicho archivo de un ejecutable. Las posibilidades son infinitas: HTML en un exe, EXE en exe, base de datos vacía en un exe, y así sucesivamente.