Manual del usuario Kit de distribucin de Microsoft(R) FoxPro(R) para MS-DOS(TM) Versin 2.

6 Microsoft Corporation La informacin contenida en este documento puede ser modificada sin previo aviso. Las empresas, nombres y datos usados en los ejemplos son ficticios, a menos que se indique lo contrario. Ninguna parte de este manual puede ser reproducida o transmitida bajo forma alguna, ni por cualquier medio, ya sea electrnico o mecnico, sea cual sea el motivo, sin mediar la previa autorizacin por escrito de Microsoft Corporation. (C) 1989-1994 Microsoft Corporation. Reservados todos los derechos. Microsoft, el logotipo grfico de Fox, FoxPro, MS y MS-DOS son marcas registradas, y Windows es una marca comercial, todas ellas propiedad de Microsoft Corporation en los Estados Unidos de Am rica y en otros pases. El resto de los nombres de productos mencionados se utilizan slo para fines de identificacin, y pueden ser marcas registradas y/o marcas comerciales propiedad de sus respectivas empresas. Documento N FX38075-0293

______________________________________________________ Uso de Write para ver este documento Si desea Ayuda sobre el uso de Write, presione F1. Si maximiza la ventana de Write, podr leer fcilmente este documento. Para ello, haga clic en el botn "Maximizar" situado en la esquina superior derecha de la ventana. O bien, abra el Men de control en la esquina superior izquierda de la ventana de Write (presione ALT+BARRA ESPACIADORA) y elija el comando Maximizar. Para imprimir el documento, elija Imprimir en el men Archivo. Acerca de este documento Este documento contiene informacin traducida y adaptada correspondiente al Kit de distribucin de Microsoft FoxPro para MS-DOS. La informacin contenida en este documento est ms actualizada que la incluida en el manual del usuario (User's Guide) en ingl s. ______________________________________________________________________________ Contenido Captulo 1 1.1 1.2 1.3 1.4 Introduccin e instalacin Contenido del paquete del Kit de distribucin 1.1.1 Registro 1.1.2 Contrato de licencia Requisitos de la plataforma Actualizar aplicaciones de FoxPro para MS-DOS 2.0 1.3.1 Cambios con respecto al Kit de distribucin de FoxPro para MS-DOS 2.0 Instalacin

1.5 Captulo 2 2.1 2.2

1.4.1 Artculos de la base de conocimientos Distribuir aplicaciones de FoxPro para MS-DOS Desarrollar aplicaciones de FoxPro para su distribucin Desarrollar una aplicacin runtime Otras consideraciones 2.2.1 Consideraciones sobre hardware, memoria y redes 2.2.2 Mens y comandos de men disponibles en aplicaciones runtime 2.2.3 Caractersticas no disponibles en aplicaciones distribuidas Mens Comandos Programas de men y comandos READ de fundacin Otras caractersticas 2.2.4 Proteger el cdigo fuente 2.2.5 Incluir el archivo de recursos FOXUSER FOXUSER como archivo FOXUSER en un proyecto 2.2.6 Incluir controladores de impresora Controladores de impresora como archivos Controladores de impresora en un proyecto 2.2.7 Agregar ayuda a la aplicacin Ayuda como archivo Ayuda en un proyecto Tratamiento de errores Preparar la aplicacin para su distribucin Empaquetar la aplicacin Crear un .FXP 3.2.1 Asegurar el cdigo fuente para un archivo .FXP Crear archivos .APP y .EXE 3.3.1 Asegurar el cdigo fuente para archivos .APP y .EXE 3.3.2 Desde el Administrador de proyectos 3.3.3 Con el comando BUILD APP 3.3.4 Con el comando BUILD EXE Probar la aplicacin runtime Ejecutar archivos .FXP, .APP y .EXE 4.1.1 Smbolo del sistema de MS-DOS Ejecutar un archivo .FXP o .APP Ejecutar un archivo .EXE compacto Ejecutar un archivo .EXE autnomo estndar o un archivo .EXE autnomo extendido de 32 bits Incluir modificadores de lnea de comandos Transferir parmetros desde el smbolo del sistema de MS-DOS a una aplicacin 4.1.2 Archivo de proceso por lotes 4.1.3 Cargador runtime 4.1.4 Modificadores del cargador runtime 4.1.5 Modificadores de lnea de comandos Especificar un archivo de configuracin: -C Evitar el uso de la memoria expandida: -E Evitar el uso de F11 o F12: -K Suprimir la pantalla de introduccin de FoxPro: -T 4.1.6 Especificar modificadores con FOXPROSWX 4.1.7 Archivo CONFIG.FP Crear discos de distribucin Hacer copias de seguridad del cdigo fuente

2.3 Captulo 3 3.1 3.2 3.3

Captulo 4 4.1

Captulo 5 5.1

5.2 5.3 5.4 5.5

Crear un archivo personalizado de instalacin por lotes Archivos necesarios del Kit de distribucin de FoxPro Otros archivos necesarios Archivos prohibidos Documentacin de FoxPro Condiciones para usar cdigo de las aplicaciones de ejemplo de FoxPro

Captulo 1: Introduccin e instalacin Con el Kit de distribucin de Microsoft(R) FoxPro(R) para MS-DOS(R)*, podr crear y distribuir aplicaciones y archivos ejecutables. Los usuarios podrn ejecutar los programas de FoxPro para MS-DOS, archivos de aplicacin y archivos ejecutables que usted desarrolle sin necesidad de disponer de una copia de FoxPro para MS-DOS. ___________________________________________________________________________ Importante Ciertas caractersticas utilizadas en la fase de desarrollo no estarn disponibles en las aplicaciones y archivos ejecutables que usted cree y/o distribuya con el Kit de distribucin de FoxPro para MS-DOS. Estos elementos se enumeran en la seccin "Caractersticas no disponibles en aplicaciones distribuidas" del captulo 2. ___________________________________________________________________________ En este captulo se describe: El contenido del paquete del Kit de distribucin Los requisitos de la plataforma La actualizacin de aplicaciones de FoxPro para MS-DOS 2.0 La instalacin La forma de distribuir aplicaciones de FoxPro para MS-DOS *Tambi n se menciona simplemente como el Kit de distribucin 1.1 Contenido del paquete del Kit de distribucin Su paquete del Kit de distribucin de Microsoft FoxPro para MS-DOS contiene lo siguiente: Los archivos del Kit de distribucin, tanto en formato de disquetes de 5,25 pulgadas como de 3,5 pulgadas de alta densidad. Este manual. Una tarjeta de registro del Kit de distribucin. Cuando la devuelva a Microsoft, esta tarjeta de registro ser su prueba de propiedad del Kit de distribucin de Microsoft FoxPro para MS-DOS. Un contrato de licencia del Kit de distribucin. Esta es la licencia para usar y distribuir los archivos de biblioteca de soporte y el cargador runtime de FoxPro para MS-DOS. 1.1.1 Registro Por favor, rellene la tarjeta de registro y remtala a Microsoft inmediatamente. Esta tarjeta documenta su posesin de una licencia del Kit de distribucin y le garantiza que recibir todas las noticias relativas a los productos e informacin actualizada. 1.1.2 Contrato de licencia La licencia del Kit de distribucin de FoxPro para MS-DOS est limitada a usted. Esta licencia le da derecho a distribuir los archivos de la Biblioteca de soporte de FoxPro para MS-DOS y/o el cargador runtime junto con sus archivos .FXP, .APP y .EXE, a tantos usuarios como desee y sin hacer ningn pago adicional a Microsoft. Para ver una lista completa de los archivos del Kit de distribucin y el uso que se autoriza de ellos, consulte el captulo 5, "Crear discos de distribucin".

Usted deber proporcionar toda la asistencia que necesiten los usuarios de las aplicaciones que distribuya. Microsoft no asume ninguna obligacin relativa a la comercializacin ni a la asistencia de las aplicaciones distribuidas. ___________________________________________________________________________ Importante Bajo ninguna circunstancia deber distribuir a los usuarios la versin de desarrollo de Microsoft FoxPro para MS-DOS. ___________________________________________________________________________ Su empresa debe poseer una copia con licencia del Kit de distribucin por cada desarrollador que vaya a crear aplicaciones para su distribucin. Si en su empresa hay cinco desarrolladores que crean aplicaciones para distribuirlas, deber adquirir cinco copias con licencia del Kit de distribucin. Con el Kit de distribucin puede crear todo tipo de aplicaciones (monousuario, multiusuario). Mientras que la versin 2.0 de FoxPro requera contratos de licencia para monousuario, multiusuario, etc., la versin 2.6 de FoxPro ya no hace estas distinciones. Sin embargo, como se ha mencionado anteriormente, para cumplir los requisitos legales deber poseer una copia con licencia del Kit de distribucin de FoxPro 2.6 para MS-DOS para cada desarrollador que utilice FoxPro 2.6 para MS-DOS para crear aplicaciones para su distribucin. 1.2 Requisitos de la plataforma Cada una de las plataformas de Microsoft FoxPro requiere su propio Kit de distribucin. El Kit de distribucin de Microsoft FoxPro para MS-DOS slo se puede utilizar para distribuir aplicaciones Microsoft FoxPro para MS-DOS. Para crear y/o distribuir aplicaciones desarrolladas en cualquier otra plataforma de Microsoft FoxPro, deber usar el Kit de distribucin correspondiente a esa plataforma. Por ejemplo, para distribuir aplicaciones para Microsoft FoxPro para Windows, deber usar el Kit de distribucin de Microsoft FoxPro para Windows. 1.3 Actualizar aplicaciones de FoxPro para MS-DOS 2.0 Para actualizar una aplicacin desarrollada para su distribucin mediante FoxPro para MS-DOS versin 2.0, primero deber volver a generar la aplicacin en Microsoft FoxPro para MS-DOS versin 2.6. Entonces podr usar el Kit de distribucin de Microsoft FoxPro para MS-DOS versin 2.6 para crear y/o distribuir la aplicacin. Para ver ms informacin acerca de la actualizacin de aplicaciones, consulte el captulo 24, "Uso de archivos de otras plataformas", del manual de FoxPro para MS-DOS. 1.3.1 Cambios con respecto al Kit de distribucin de FoxPro para MS-DOS 2.0 Hay pocas diferencias entre las versiones 2.0 y 2.6 del Kit de distribucin de Microsoft FoxPro para MS-DOS. Una diferencia importante es que en el Kit de distribucin versin 2.6 ya no se usa PROAPI16.EXE. 1.4 Instalacin ______________________________________________________________________________ Importante Antes de instalar el Kit de distribucin, haga una copia de seguridad de los discos del Kit de distribucin copindolos a un segundo juego de discos. Guarde los discos originales en un lugar seguro y use las copias como discos de trabajo. ______________________________________________________________________________ ______________________________________________________________________________ Importante El programa de instalacin del Kit de distribucin de FoxPro para MS-DOS cambia los archivos de versin de desarrollo existentes de FoxPro para MS-DOS. Para instalarlo correctamente: * Debe instalar el Kit de distribucin en el directorio donde se encuentre instalada la versin de desarrollo de Microsoft FoxPro para MS-DOS versin 2.6.

* Si va a instalar el Kit de distribucin en una red, su nombre de usuario deber tener todos los derechos de archivo. ______________________________________________________________________________ Para iniciar la instalacin, inserte en la unidad A el disco 1 del Kit de distribucin y escriba: a:INSTALAR Presione ENTRAR y siga las instrucciones de instalacin que aparecern en la pantalla. La primera vez que instale el Kit de distribucin, el programa de instalacin le preguntar su nombre y el nombre de su empresa. Esta informacin se mostrar si ejecuta otra vez el programa de instalacin. A continuacin, el programa de instalacin le pedir que confirme la unidad y el directorio de destino para los archivos del Kit de distribucin. El directorio de destino predeterminado es FPD26. Si ha instalado la versin de desarrollo de Microsoft FoxPro para MS-DOS versin 2.6 en un directorio distinto de FPD26, especifique esta unidad y/o directorio, y luego presione ENTRAR. El programa de instalacin mostrar las opciones del Kit de distribucin junto con la cantidad de espacio en disco que necesita cada opcin. Cuando seleccione las opciones que desea instalar, el programa comprobar el espacio disponible en el disco y le avisar si no hay suficiente espacio para completar la instalacin. Puede ignorar el aviso y continuar la instalacin. Si responde "S" a la instalacin de cualquiera de las opciones se activar el botn radio "Generar ejecutable" del dilogo Opciones al generar del Administrador de proyectos, de forma que pueda generar archivos .EXE. Para obtener ms informacin acerca de las diferentes opciones de instalacin y su uso, consulte "Empaquetar la aplicacin", en el captulo 3. Si instala el Kit de distribucin completo, su directorio de inicio (FPD26 de manera predeterminada) contendr los archivos siguientes: ______________________________________________________________________________ Archivos del Kit de distribucin ______________________________________________________________________________ Archivo Descripcin ______________________________________________________________________________ FOXCLIBM.LIB Crea archivos .EXE autnomos versin FOXMATHM.LIB estndar FOXPRO.LIB FOXPROS.LIB WOVL.LIB FOXBIND.EXE FOXCLIBR.LIB FOXMATHR.LIB FOXPROSX.LIB FOXPROX.LIB WLINK8.EXE FOXD2600.ESL FOXD2600.ESO Crea archivos .EXE autnomos versin extendida de 32 bits

Vinculador para generar archivos .EXE autnomos Biblioteca de soporte runtime

FOXDX260.ESL

Biblioteca de soporte runtime extendida de 32 bits

FOXR.EXE Cargador runtime ______________________________________________________________________________ 1.4.1 Artculos de la base de conocimientos El Kit de distribucin de FoxPro para MS-DOS contiene artculos de la base de conocimientos. Puede verlos ejecutando KBVIEW.APP, una aplicacin FoxPro instalada en el directorio de FoxPro. Estos artculos contienen informacin til acerca de diversos temas relacionados con FoxPro. 1.5 Distribuir aplicaciones de FoxPro para MS-DOS Crear aplicaciones de FoxPro para MS-DOS para su distribucin es un proceso similar a desarrollar aplicaciones estndar de FoxPro para MS-DOS. Debe crear una aplicacin con la versin de desarrollo de FoxPro para MS-DOS, teniendo en cuenta las caractersticas que no se encuentran disponibles en el entorno runtime. La aplicacin se compila como archivo .FXP, .APP o .EXE, y se somete a prueba en el entorno runtime. Entonces puede distribuir a los puntos de distribucin esa aplicacin, los archivos de proceso por lotes relacionados y los archivos runtime necesarios de FoxPro para MS-DOS. Los puntos de distribucin no necesitan tener FoxPro para MS-DOS para poder ejecutar la aplicacin.

Captulo 2: Desarrollar aplicaciones de FoxPro para su distribucin Este captulo proporciona directrices para el desarrollo de aplicaciones para el entorno runtime. Para obtener informacin detallada acerca de la creacin de aplicaciones usando una versin de desarrollo de Microsoft FoxPro para MS-DOS, consulte la documentacin de desarrollo de FoxPro y el captulo 13, "Administrador de proyectos", del Manual del usuario de FoxPro. 2.1 Desarrollar una aplicacin runtime El desarrollo de una aplicacin runtime de FoxPro para su distribucin implica seis pasos bsicos: 1. Crear y depurar la aplicacin usando una versin de desarrollo de FoxPro para MS-DOS. 2. Crear archivos de ayuda y dems documentacin. La aplicacin utiliza su propio archivo de ayuda en lugar del archivo de ayuda estndar de FoxPro para MS-DOS (FOXHELP.DBF). Consulte la seccin "Agregar ayuda a la aplicacin" ms adelante en este manual para obtener ms informacin sobre la creacin de ayuda para la aplicacin. Adems, cree los manuales u otra documentacin impresa que desee distribuir con su aplicacin. 3. Ejecutar y depurar su aplicacin en el entorno runtime. El entorno runtime es id ntico al entorno de la versin de desarrollo de FoxPro en la mayora de los aspectos. Sin embargo, puesto que varias caractersticas estndar no estn disponibles en el entorno runtime, deber asegurarse de que la aplicacin funciona correctamente. Las diferencias entre el entorno runtime y el de la versin de desarrollo de FoxPro se explican ms adelante en este mismo captulo. 4. Usando el Kit de distribucin de FoxPro para MS-DOS, tiene la opcin de compilar la aplicacin para crear un archivo .EXE compacto o un archivo .EXE autnomo.

5. Crear un archivo personalizado por lotes de instalacin, si lo desea, y crear los discos de distribucin. 6. Empaquetar los discos de distribucin y la documentacin impresa, y poner la aplicacin a disposicin de los puntos de distribucin. Para obtener informacin acerca de los archivos necesarios en los discos de distribucin adems de los archivos de la aplicacin, consulte el captulo 5, "Crear discos de distribucin". 2.2 Otras consideraciones Las secciones siguientes describen algunas de las limitaciones del Kit de distribucin. Asegrese de tener en cuenta estas limitaciones cuando desarrolle una aplicacin para distribuirla con el Kit de distribucin. 2.2.1 Consideraciones sobre hardware, memoria y redes Las aplicaciones que cree con el Kit de distribucin de Microsoft FoxPro para MS-DOS tendrn los mismos requisitos de hardware, memoria y redes que la versin de desarrollo de FoxPro para MS-DOS. Puede proporcionar las siguientes versiones de sus aplicaciones: * Versin estndar. Los archivos .FXP, .APP y .EXE de la versin estndar proporcionan la velocidad y versatilidad de FoxPro a sistemas con restricciones de memoria, o con procesadores 8086, 8088 286. * Versin extendida de 32 bits. Los archivos .FXP, .APP y .EXE de la versin extendida de 32 bits utilizan la capacidad de los microprocesadores 386 y 486, y pueden usar toda la memoria extendida disponible, lo que normalmente significa una mayor velocidad de ejecucin. Utilice las directrices siguientes para decidir qu versin se ajusta mejor a su entorno de distribucin: * Para usar la versin extendida de 32 bits, el sistema que ejecute la aplicacin deber tener un procesador 386 o superior y al menos 3 MB de memoria. * Si el sistema que vaya a ejecutar la aplicacin tiene 3 MB de memoria o ms, el uso de la versin extendida de 32 bits ofrecer un mejor rendimiento en la mayora de los casos. Para obtener ms informacin acerca de las capacidades de la versin extendida de 32 bits y de la versin estndar de FoxPro para MS-DOS, consulte la documentacin de FoxPro para MS-DOS. Para obtener informacin adicional acerca del uso del Kit de distribucin de FoxPro para crear aplicaciones que se ejecuten en un entorno de red, consulte la documentacin de FoxPro para MS-DOS. 2.2.2 Mens y comandos de men disponibles en aplicaciones runtime Cuando distribuya un archivo .FXP, .APP o .EXE, la estructura de mens de FoxPro para MS-DOS incluir los siguientes mens y comandos de men predeterminados: * Men Sistema Acerca de FoxPro, Ayuda, y los siguientes accesorios de escritorio: Calculadora, Calendario/Agenda, Caracteres especiales, Tabla ASCII, Capturar y Puzzle. * Men Archivo Cerrar, Guardar, Guardar como y Revertir. * Men Edicin

Todos los comandos estndar del men Edicin se encuentran disponibles. * Men Ventana Ocultar (as como Ocultar todo y Mostrar todo), Borrar, Mover, Tamao, Zoom, Recorrer y los nombres de todas las ventanas abiertas (con las teclas de m todo abreviado 0-9 para las diez primeras). Puede desactivar o quitar cualquiera de estos mens y comandos de men predeterminados. Utilice SET SKIP OF para desactivar o activar mens y comandos de men. Para quitar uno o todos los ttulos o comandos de men, use RELEASE PAD o RELEASE BAR. Tambi n puede agregar mens y comandos de men a la estructura de mens de FoxPro para MS-DOS. Consulte la documentacin de FoxPro para MS-DOS para obtener informacin adicional acerca de cmo agregar mens y comandos de men a su aplicacin. 2.2.3 Caractersticas no disponibles en aplicaciones distribuidas Las bibliotecas del Kit de distribucin de FoxPro no admiten ciertas caractersticas que estn disponibles en la versin de desarrollo de FoxPro para MS-DOS. Las caractersticas siguientes no estarn disponibles en las aplicaciones .FXP, .APP o .EXE que usted distribuya utilizando el Kit de distribucin de FoxPro para MS-DOS. Mens Los siguientes mens del sistema de FoxPro y sus comandos no estarn disponibles en las aplicaciones que usted distribuya: * * * * * * * Men Men Men Men Men Men Men Tabla Registro Programa Pantalla Men RQBE Proyecto

Ttulos de men Los ttulos de men siguientes no estarn disponibles en las aplicaciones que usted distribuya. Men SISTEMA: Macros..., Archivador Men ARCHIVO: Nuevo..., Abrir..., Especificar impresora..., Imprimir..., Salir Men VENTANA: Color..., Comandos, Depuracin, Seguimiento, Ver Comandos Los comandos siguientes devolvern un mensaje de error "Caracterstica no disponible" si los incluye en las aplicaciones que usted distribuya: BUILD APP BUILD EXE BUILD PROJECT COMPILE FILER CREATE MENU* CREATE QUERY* CREATE SCREEN* MODIFY MENU* MODIFY QUERY* MODIFY SCREEN* SET SET VIEW ON SUSPEND

* Aunque no pueda incluir comandos que creen o modifiquen mens, pantallas o consultas, podr ejecutar programas existentes de men, pantalla o consulta (archivos .MPR, .SPR y .QPR).

Los comandos siguientes no se admiten en los archivos .FXP, .APP o .EXE y se ignoran cuando se encuentran: SET DEBUG SET DEVELOPMENT SET DOHISTORY SET ECHO SET STEP

Programas de men y comandos READ de fundacin En muchos casos, un programa de men personalizado funciona en la versin de desarrollo de FoxPro para MS-DOS, pero cuando se ejecuta la versin de distribucin del programa, el men aparece y a continuacin el programa sale al smbolo del sistema de MS-DOS. En tales casos, incorpore un comando READ de fundacin a la aplicacin. Para incorporar un comando READ de fundacin, siga estos pasos: 1. Incluya el cdigo siguiente en el preprograma del men o programa: PUBLIC m.done m.done = .F. 2. Ejecute el cdigo siguiente cuando el usuario elija el comando de men Salir: m.done = .T. CLEAR READ ALL 3. En el postprograma del men o programa, incluya el cdigo siguiente antes de cualquier otro cdigo: READ VALID m.done ______________________________________________________________________________ Nota Para obtener ms informacin acerca de los comandos READ de formacin, consulte el ejemplo EX1.PJX del directorio GOODIES\FNDATION y la seccin relativa al comando READ en la documentacin de FoxPro para MS-DOS. ______________________________________________________________________________ Otras caractersticas Las aplicaciones .FXP, .APP y .EXE distribuidas no contienen caractersticas que s se encuentran disponibles en el entorno de desarrollo interactivo. Por ejemplo, los usuarios de runtime no pueden abrir las ventanas Depuracin, Seguimiento o Ver, ni usar el Generador de mens, el Generador de pantallas, la ventana RQBE, etc. Adems, la ejecucin y compilacin de archivos fuente requiere la versin de desarrollo de FoxPro. 2.2.4 Proteger el cdigo fuente Para impedir que alguien pueda ver el cdigo fuente, incluya SET DEBUG OFF como primera lnea en todos los programas de aplicacin que cree para su distribucin. Si transfiere parmetros a su programa desde el smbolo del sistema de MS-DOS, incluya SET DEBUG OFF como segunda lnea del programa despu s de la instruccin PARAMETERS. Consulte SET DEBUG en la Ayuda de FoxPro para obtener ms informacin al respecto. Para evitar que la aplicacin incluya informacin de depuracin, muestre primero el cuadro de dilogo Opciones del proyecto escogiendo Opciones en el men Proyecto. Luego, seleccione la casilla "Codificar" y desactive la casilla "Info para depuracin" del cuadro de dilogo Opciones del proyecto. Guarde el proyecto antes de generar el archivo ejecutable.

2.2.5 Incluir el archivo de recursos FOXUSER El archivo de recursos de FoxPro almacena informacin variada que puede utilizar su aplicacin, tal como la posicin de las ventanas, las configuraciones de color, las configuraciones de la ventana Examinar, las definiciones de etiquetas y las configuraciones de los controladores de impresora. Este archivo de recursos es una tabla/.DBF de FoxPro con un archivo memo asociado, denominados respectivamente FOXUSER.DBF y FOXUSER.FPT. Cuando se crea una aplicacin FoxPro se almacenan muchos elementos de informacin en el archivo FOXUSER. Si su aplicacin utiliza cualquiera de estos recursos, deber distribuir con la aplicacin la tabla/.DBF FOXUSER (o la tabla/.DBF de recursos que usted cree especficamente para la aplicacin). FOXUSER como archivo Si su aplicacin utiliza informacin almacenada en un archivo de recursos de FoxPro y distribuye la aplicacin como un archivo .FXP, asegrese de distribuir FOXUSER.DBF y FOXUSER.FPT junto con la aplicacin. El archivo de recursos debe estar situado en el mismo directorio que los archivos ejecutables distribuidos. Si tambi n distribuye un archivo de configuracin CONFIG.FP, puede incluir el elemento de configuracin RESOURCE en CONFIG.FP para especificar una ubicacin y un nombre diferentes para el archivo de recursos. Tambi n es posible especificar en la aplicacin la ubicacin y el nombre del archivo de recursos mediante el comando SET RESOURCE. FOXUSER en un proyecto Si su aplicacin utiliza informacin almacenada en un archivo de recursos de FoxPro y usted distribuye la aplicacin como un archivo .APP o .EXE, puede incluir FOXUSER.DBF y FOXUSER.FPT en el proyecto de la aplicacin. Si incluye FOXUSER en un proyecto, ser de slo lectura y no se podr modificar. Si no incluye el archivo de recursos en el proyecto de la aplicacin, o si marca el archivo de recursos como excluido del proyecto de la aplicacin, asegrese de distribuir el archivo de recursos junto con la aplicacin. FOXUSER se podr modificar si tiene el atributo de lectura/escritura. Para obtener ms informacin acerca de cmo crear un proyecto e incluir y excluir archivos de un proyecto, consulte la documentacin de FoxPro para MS-DOS. 2.2.6 Incluir controladores de impresora Si su aplicacin incluye un informe que utiliza una configuracin de controlador de impresora o si su aplicacin usa SET PDSETUP para especificar una configuracin de controlador de impresora, deber distribuir junto con su aplicacin GENPD.APP, el programa de interfaz de controlador de impresora de FoxPro. Las configuraciones de controladores de impresora se almacenan en el archivo de recursos de FoxPro, FOXUSER.DBF. Si crea configuraciones de controlador de impresora para sus aplicaciones, incluya el archivo de recursos que contiene las configuraciones de controlador de impresora y su archivo memo asociado. Controladores de impresora como archivos Si distribuye la aplicacin como un archivo .FXP, asegrese de distribuir GENPD.APP como un archivo junto con su aplicacin. GENPD.APP debe estar situado en el mismo directorio que los archivos ejecutables distribuidos. Si distribuye tambi n un archivo de configuracin CONFIG.FP, podr incluir en CONFIG.FP el elemento de configuracin _GENPD para especificar una ubicacin diferente para GENPD.APP. Si su aplicacin incluye configuraciones de controlador de impresora

almacenados en el archivo de recursos FOXUSER.DBF, asegrese de distribuir FOXUSER.DBF y FOXUSER.FPT junto con su aplicacin. El archivo de recursos FOXUSER debe estar situado en el mismo directorio que los archivos ejecutables distribuidos. Si distribuye un archivo de configuracin CONFIG.FP, podr incluir en CONFIG.FP el elemento de configuracin RESOURCE para especificar una ubicacin y un nombre diferente para el archivo de recursos. Tambi n es posible especificar el nombre y ubicacin del archivo de recursos dentro de la aplicacin mediante el comando SET RESOURCE. Controladores de impresora en un proyecto GENPD.APP debe distribuirse como archivo junto con su aplicacin, tanto si incluye GENPD.APP en el proyecto como si no lo incluye. Si se incluye GENPD.APP en el proyecto, FoxPro lo marcar automticamente como excluido del proyecto y slo permanecer en el proyecto como referencia. Si su aplicacin incluye configuraciones de controlador de impresora almacenadas en el archivo de recursos de FoxPro, FOXUSER.DBF, puede incluir FOXUSER.DBF y FOXUSER.FPT en el proyecto de la aplicacin. Si no incluye el archivo de recursos en el proyecto de la aplicacin, asegrese de distribuir el archivo de recursos junto con la aplicacin. 2.2.7 Agregar ayuda a la aplicacin Puede crear ayuda interactiva para distribuirla junto con la aplicacin. El texto de ayuda se almacena en una tabla/.DBF de ayuda junto con la aplicacin. Para obtener ms informacin acerca de la creacin de un archivo de ayuda personalizado, consulte la documentacin de FoxPro para MS-DOS. Ayuda como archivo Si su aplicacin utiliza un archivo de ayuda personalizado y la aplicacin se distribuye como un archivo .FXP, asegrese de distribuir los archivos de ayuda junto con la aplicacin. Los archivos de ayuda deben estar situados en el mismo directorio que los archivos ejecutables distribuidos. Si distribuye un archivo de configuracin CONFIG.FP, podr incluir en CONFIG.FP el elemento de configuracin HELP para especificar un nombre y una ubicacin diferentes para los archivos de ayuda. La ubicacin y el nombre de los archivos de ayuda pueden especificarse tambi n dentro de la aplicacin mediante el comando SET HELP. Ayuda en un proyecto Si su aplicacin usa un archivo de ayuda personalizado y la aplicacin se distribuye como un archivo .APP o .EXE, podr incluir los archivos de ayuda en el proyecto de la aplicacin. Si no incluye los archivos de ayuda en el proyecto de la aplicacin, asegrese de distribuir los archivos de ayuda junto con la aplicacin. Si los archivos de ayuda estn incluidos en el proyecto pero estn marcados como excluidos, deber distribuir los archivos .DBF y .FPT junto con la aplicacin. El usuario puede cambiar estos archivos. Si no desea que los usuarios tengan la posibilidad de cambiar el contenido de los archivos de ayuda, inclyalos en el proyecto, pero no los marque como excluidos. ______________________________________________________________________________ Nota No tiene autorizacin para distribuir los archivos de ayuda o cualquier parte de los archivos de ayuda que se incluyen en la versin de desarrollo de FoxPro para MS-DOS. ______________________________________________________________________________ 2.3 Tratamiento de errores En ocasiones, es posible que ocurran errores inesperados durante la ejecucin de la aplicacin. Para tratar errores imprevistos, puede especificar en su aplicacin una rutina de tratamiento de errores mediante ON ERROR. Para

obtener ms informacin acerca del tratamiento de errores, consulte ON ERROR en la ayuda de FoxPro. Si no especifica una rutina ON ERROR, cuando FoxPro encuentre un error detendr la ejecucin del programa y mostrar una alerta de error que presentar al usuario las dos opciones siguientes: * Cancelar

Si elige Cancelar, FoxPro detendr inmediatamente la ejecucin del programa y devolver el control al MS-DOS. * Ignorar

Si elige Ignorar, FoxPro ignorar la lnea que caus el error y ejecutar la siguiente lnea del programa. O bien, si presiona la tecla ESC durante la ejecucin del programa, FoxPro ignorar la pulsacin ESC y reanudar la ejecucin sin omitir ninguna lnea del programa. Puede especificar en su aplicacin un procedimiento, con ON ESCAPE, para interceptar la pulsacin de la tecla ESC. ______________________________________________________________________________ Nota Para ver una lista y una explicacin completa de los mensajes de error de FoxPro para MS-DOS, consulte la ayuda de FoxPro. ______________________________________________________________________________

Captulo 3: Preparar la aplicacin para su distribucin Esta seccin contiene informacin acerca de cmo preparar los archivos .FXP, .APP y .EXE de FoxPro para su distribucin. 3.1 Empaquetar la aplicacin Antes de poder distribuir su aplicacin, debe crear un archivo .FXP, .APP o .EXE para la aplicacin. Use la versin de desarrollo de FoxPro para MS-DOS para crear estos archivos. La tabla siguiente contiene una lista de las ventajas y los requisitos de cada tipo de archivo. ______________________________________________________________________________ Consideraciones sobre el tipo de archivo ______________________________________________________________________________ Tipo de archivo Ventajas Notas ______________________________________________________________________________ .FXP Requiere menos espacio en disco. Requiere una Biblioteca de soporte. Si incluye la Biblioteca de soporte extendida, requiere un sistema 386 o superior y al menos 3 MB de memoria. Puede que se requieran otros archivos .FXP si su aplicacin llama a otros programas. No es posible incluir otros archivos (CONFIG.FP,

archivos de recursos, etc.) en el archivo .FXP. ______________________________________________________________________________ .APP Un solo archivo. Requiere una Biblioteca de soporte. Si incluye la Es posible incluir archivos Biblioteca de soporte adicionales (CONFIG.FP, archivo extendida, requiere un de recursos, etc.) en el archivo sistema 386 o superior y al .APP. Estos archivos sern de slo menos 3 MB de memoria. lectura Puede ser mayor que un archivo .FXP. ______________________________________________________________________________ .EXE Un solo archivo. Requiere una Biblioteca compacto de soporte. Si incluye Requiere menos espacio en disco. la Biblioteca de soporte extendida, requiere un Es posible incluir archivos sistema 386 o superior y al menos 3 MB de memoria. adicionales (CONFIG.FP, archivo de recursos, etc.) en el archivo .EXE. Estos archivos sern de slo lectura. ______________________________________________________________________________ .EXE Un solo archivo. Puede ser muy grande. Puede autnomo que tenga que dividir un Es posible incluir archivos archivo .EXE grande en dos o adicionales (CONFIG.FP, archivo de ms discos para poder recursos, etc.) en el archivo .EXE distribuirlo. Estos archivos sern de slo lectura. Requieren mucho tiempo para generarse. ______________________________________________________________________________ .EXE Un solo archivo. Puede ser muy grande. Puede extendido que tenga que dividir un autnomo Es posible incluir archivos archivo .EXE grande en dos de 32 bits adicionales (CONFIG.FP, archivo o ms discos para poder de recursos, etc.) en el archivo distribuirlo. .EXE. Estos archivos sern de slo lectura. Requieren mucho tiempo para generarse. Ejecucin rpida. Requieren un sistema 386 o superior y al menos 3 MB de memoria. ______________________________________________________________________________ 3.2 Crear un .FXP Puede distribuir una aplicacin para su uso en runtime compilndola en un archivo .FXP. Para ello, elija Compilar en el men Programa como se explica en la documentacin de FoxPro o utilice el comando COMPILE como se explica en la ayuda de FoxPro. Si su aplicacin llama a otros programas, asegrese de compilar estos programas e incluirlos en los discos de distribucin. 3.2.1 Asegurar el cdigo fuente para un archivo .FXP Si crea un archivo .FXP mediante el dilogo Compilar, desactive la casilla de seleccin "Info para depuracin" y seleccione la casilla de seleccin

"Codificado". Si crea un archivo .FXP con el comando COMPILE, incluya las palabras clave NODEBUG y ENCRYPT. El primer paso excluye la informacin de depuracin del archivo .FXP, reduciendo el tamao del cdigo compilado y ahorrando espacio en el disco, e impide que los usuarios de la aplicacin compilada puedan ver la ejecucin del programa en la ventana Seguimiento. El segundo paso impide que los usuarios puedan alterar el cdigo fuente. 3.3 Crear archivos .APP y .EXE Cuando su proyecto contenga todos los archivos necesarios, podr generar un archivo de aplicacin .APP o un archivo ejecutable .EXE para su distribucin. Puede generar un archivo .APP mediante la ventana Proyecto o con el comando BUILD APP y puede generar un archivo .EXE mediante la ventana Proyecto o con el comando BUILD EXE. ______________________________________________________________________________ Importante Si existe un archivo .APP con el mismo nombre que el archivo .EXE autnomo, FoxPro para MS-DOS lo eliminar cuando usted cree el archivo .EXE. Tenga en cuenta tambi n que si existe un archivo .EXE y usted crea un archivo .APP con el mismo nombre, FoxPro para MS-DOS eliminar el archivo .EXE. Esto evitar que usted ejecute o distribuya el archivo equivocado. ______________________________________________________________________________ Es posible incluir una amplia variedad de archivos en el proyecto. Por ejemplo, puede incluir una tabla/.DBF de recursos FOXUSER y un archivo de configuracin CONFIG.FP. ______________________________________________________________________________ Importante Si en un proyecto incluye un archivo de configuracin de FoxPro, ste deber llamarse CONFIG.FP. ______________________________________________________________________________ ______________________________________________________________________________ Nota Para obtener ms informacin acerca de cmo crear un proyecto e incluir y excluir archivos de un proyecto, consulte la documentacin de Microsoft FoxPro para MS-DOS. ______________________________________________________________________________ 3.3.1 Asegurar el cdigo fuente para archivos .APP y .EXE Desactive la casilla de seleccin "Info para depuracin" en el dilogo Opciones del proyecto, seleccione la casilla "Codificado" y guarde el proyecto antes de generar la aplicacin o el archivo ejecutable. Estos pasos protegen el cdigo fuente. Para mostrar el cuadro de dilogo Opciones del proyecto, elija Opciones en el men Proyecto. 3.3.2 Desde el Administrador de proyectos Para crear un archivo .APP cuando el proyecto de la aplicacin se encuentra abierto en la ventana Proyecto, elija el botn de comando"Generar". Aparecer el cuadro de dilogo Opciones al generar. En dicho cuadro de dilogo, elija el botn de comando "Generar aplicacin". Para crear un archivo .EXE cuando el proyecto de la aplicacin se encuentra abierto en la ventana Proyecto, elija el botn de comando "Generar". Aparecer el dilogo Opciones al generar. En dicho cuadro de dilogo, elija el botn de comando "Generar ejecutable". ______________________________________________________________________________ Importante El botn de comando "Generar ejecutable" aparecer desactivado si no se ha instalado el Kit de distribucin de FoxPro. ______________________________________________________________________________

Puede crear tres tipos de archivos .EXE: * Compacto

Un archivo .EXE compacto requiere la Biblioteca de soporte .EXE de FoxPro. La Biblioteca de soporte .EXE de FoxPro consta de tres archivos: FOXD2600.ESL, la Biblioteca de soporte .EXE estndar, FOXD2600.ESO y la Biblioteca de soporte .EXE extendida de 32 bits FOXDX260.ESL. * Autnomo

Crea un archivo .EXE completamente autocontenido que tiene los mismos requisitos que la versin estndar de FoxPro para MS-DOS. * Autnomo extendido

Crea un archivo .EXE completamente autocontenido que tiene los mismos requisitos que la versin extendida de 32 bits de FoxPro para MS-DOS. 3.3.3 Con el comando BUILD APP Puede usar BUILD APP para crear un archivo .APP en lugar de generar el archivo .APP desde la ventana Proyecto. Puede usar BUILD APP en un programa o en la ventana Comandos. BUILD APP crea un archivo .APP a partir de un proyecto. Antes de usar BUILD APP para crear el archivo .APP, asegrese de que su proyecto contenga todos los archivos que necesite la aplicacin. Las opciones de generacin especificadas en el cuadro de dilogo Opciones al generar se guardan junto con el proyecto y son utilizadas por BUILD APP. Las referencias no resueltas u otros errores que se encuentren durante el proceso de generacin se presentan y opcionalmente se almacenan, en el directorio del proyecto, en un archivo de errores que tiene el mismo nombre que el proyecto y la extensin .ERR. Para obtener informacin adicional acerca del uso de BUILD APP para crear un archivo .APP, consulte la ayuda de FoxPro. 3.3.4 Con el comando BUILD EXE Puede usar el comando BUILD EXE para crear un archivo .EXE en lugar de generar el archivo .EXE ejecutable desde la ventana Proyecto. Puede usar BUILD EXE en un programa o en la ventana Comandos. Sin embargo, dispondr de ms opciones si crea el archivo .EXE desde la ventana Proyecto. BUILD EXE crea un archivo .EXE a partir de un proyecto. Antes de usar BUILD EXE para crear el archivo .EXE, asegrese de que su proyecto contenga todos los archivos que necesite la aplicacin. Las opciones de generacin especificadas en el cuadro de dilogo Opciones al generar se guardan junto con el proyecto y son utilizadas por BUILD APP. Las referencias no resueltas u otros errores que se encuentren durante el proceso de generacin se presentan y opcionalmente se almacenan, en el directorio del proyecto, en un archivo de errores que tiene el mismo nombre que el proyecto y la extensin .ERR. Si incluye la palabra clave opcional STANDALONE con el comando BUILD EXE se crear un archivo .EXE versin estndar completamente autocontenido. No necesitar distribuir ningn archivo adems del archivo .EXE autnomo, pero dependiendo de la naturaleza de su aplicacin puede que desee incluir algunos de los archivos enumerados en la tabla Archivos que puede necesitar la aplicacin, en el captulo 5. Un archivo .EXE autnomo tiene los mismos requisitos que la versin estndar

de FoxPro para MS-DOS. Para crear un archivo .EXE autnomo, los archivos siguientes debern estar en el mismo directorio que los archivos de FoxPro para MS-DOS: FOXPRO.LIB FOXPROS.LIB FOXCLIBM.LIB FOXMATHM.LIB WLINK8.EXE WOVL.LIB

Si incluye la clusula opcional EXTENDED en el comando BUILD.EXE se crear un archivo .EXE versin extendida de 32 bits completamente autocontenido. No necesitar distribuir ningn otro archivo adems del archivo .EXE autnomo de 32 bits, pero puede que desee incluir algunos de los archivos enumerados en la tabla Archivos que puede necesitar la aplicacin, en el captulo 5. Un archivo .EXE autnomo extendido de 32 bits tiene los mismos requisitos que la versin extendida de 32 bits de FoxPro para MS-DOS. Para crear un archivo .EXE autnomo extendido de 32 bits, los archivos siguientes debern estar en el mismo directorio que los archivos de FoxPro para MS-DOS: FOXPROX.LIB FOXPROSX.LIB FOXCLIBR.LIB FOXMATHR.LIB FOXBIND.EXE WLINK8.EXE

______________________________________________________________________________ Importante Los archivos ejecutables autnomos requieren mucho ms tiempo (aproximadamente de 5 a 60 minutos ms) para generarse que los archivos ejecutables compactos. Si piensa que el proceso de generacin est llevando mucho tiempo o que su sistema se ha bloqueado, espere hasta que se complete el proceso de compilacin. No reinicie el sistema, ya que esto podra daar sus archivos. ______________________________________________________________________________ Si no incluye la clusula STANDALONE o EXTENDED con el comando BUILD EXE, FoxPro para MS-DOS crear un archivo .EXE compacto. Para ejecutar un archivo .EXE compacto, la Biblioteca de soporte .EXE de FoxPro deber estar en la ruta del MS-DOS. La Biblioteca de soporte .EXE consta de tres archivos: FOXD2600.ESL, la Biblioteca de soporte .EXE estndar FOXD2600.ESO y la Biblioteca de soporte .EXE extendida de 32 bits FOXDX260.ESL.

Captulo 4: Probar la aplicacin runtime Despu s de compilar la aplicacin runtime, es importante probar la aplicacin en el entorno runtime, usando los mismos procedimientos de inicio que recomiende para la aplicacin. Este captulo describe varias maneras de configurar e iniciar la aplicacin y de tratar los errores que pueden aparecer al probar la aplicacin compilada. 4.1 Ejecutar archivos .FXP, .APP y .EXE Un archivo .FXP o .APP puede iniciarse desde el smbolo del sistema de MS-DOS o desde un archivo de proceso por lotes usando el cargador runtime. Tambi n puede usar el archivo CONFIG.FP para iniciar un archivo .FXP o .APP directamente desde el smbolo del sistema de MS-DOS sin incluir un nombre de archivo. Para iniciar un archivo .EXE, introduzca el nombre del archivo a continuacin del smbolo del sistema de MS-DOS. 4.1.1 Smbolo del sistema de MS-DOS

Ejecutar un archivo .FXP o .APP Un archivo .FXP o .APP puede iniciarse desde el smbolo del sistema de MS-DOS usando el cargador runtime. Utilice esta lnea de comando: FOXR <nombre de archivo> Especifique con <nombre de archivo> el nombre del archivo .FXP o .APP que desea ejecutar. Ejecutar un archivo .EXE compacto Para ejecutar un archivo .EXE compacto, escriba su nombre en el smbolo del sistema de MS-DOS y presione la tecla ENTRAR. Los archivos .EXE compactos actan automticamente como el cargador runtime y ejecutan la versin ms avanzada de la Biblioteca de soporte. La Biblioteca de soporte debe estar en la ruta del MS-DOS. Puede incluir el modificador -X despu s del nombre del archivo .EXE compacto para forzar al archivo ejecutable a usar la Biblioteca de soporte estndar. Incluya +X despu s del nombre de archivo para forzar el uso de la Biblioteca de soporte extendida de 32 bits. Ejecutar un archivo .EXE autnomo estndar o un archivo .EXE autnomo extendido de 32 bits Para ejecutar un archivo .EXE autnomo estndar o un archivo .EXE autnomo extendido de 32 bits, escriba su nombre de archivo a continuacin del smbolo del sistema de MS-DOS y presione ENTRAR. Incluir modificadores de lnea de comandos Puede incluir los modificadores -C, -E, -K y/o -T de lnea de comandos despu s del nombre de archivo al ejecutar un archivo .FXP, .APP o .EXE. Puede agregar los modificadores en la misma lnea de comandos, despu s de los modificadores del cargador runtime. Los modificadores de lnea de comandos y los modificadores del cargador runtime se explican detalladamente ms adelante en este mismo captulo. Transferir parmetros desde el smbolo del sistema de MS-DOS a una aplicacin Si la primera lnea de programa del archivo fuente del archivo .FXP, .APP o .EXE es una instruccin PARAMETERS, podr transferir parmetros al programa desde la lnea de comandos de MS-DOS. Especifique los parmetros despu s de todos los modificadores del cargador runtime y de lnea de comandos, y separe los parmetros con espacios en blanco. Ejemplo: Inicie MIEXE.EXE con la lnea de comandos: MIEXE HOLA ADIOS El primer programa ejecutado en MIEXE.EXE tiene como primera lnea: PARAMETERS x y Los parmetros de tipo alfanum rico deben incluirse entre comillas dobles (" ") slo si los parmetros incluyen espacios en blanco o caracteres especiales. Si utiliza comillas simples, FoxPro para MS-DOS generar el mensaje de error: "Nmero de parmetros incorrecto". Todos los parmetros se transfieren como de tipo alfanum rico. Por ejemplo, si transfiere el nmero 1 a un programa, el programa identificar la variable como de tipo alfanum rico. 4.1.2 Archivo de proceso por lotes Puede crear un archivo de comandos por lotes que ejecute el archivo .FXP, .APP

o .EXE. Por ejemplo, para crear un archivo de comandos por lotes denominado CUENTA.BAT que ejecute una aplicacin FoxPro para MS.DOS denominada CUENTA1.APP, introduzca la lnea siguiente en un archivo creado con el editor de texto de FoxPro y luego guarde el archivo como CUENTA.BAT: FOXR CUENTA1.APP Al escribir el siguiente comando a continuacin del smbolo del sistema se ejecutar la aplicacin de FoxPro para MS-DOS denominada CUENTA1.APP: CUENTA Tambi n puede incluir en el archivo de proceso por lotes modificadores del cargador y modificadores de lnea de comandos despu s del nombre de la aplicacin. Ambos tipos de modificadores se explican detalladamente ms adelante en este mismo captulo. 4.1.3 Cargador runtime El cargador runtime de FoxPro, FOXR.EXE, se utiliza para ejecutar archivos .APP y .FXP. FOXR.EXE comprueba qu versin o versiones de la Biblioteca de soporte de FoxPro se encuentran disponibles (estndar o extendida de 32 bits). Luego invoca la Biblioteca de la versin ms avanzada que pueda ejecutarse en el sistema. Tenga en cuenta que el cargador consume algo de memoria. Los archivos .EXE compactos actan automticamente como cargadores e invocan la versin ms avanzada disponible de la Biblioteca de soporte de FoxPro. Cuando FOXR.EXE tiene la opcin de ejecutar distintas versiones de la Biblioteca de soporte de FoxPro, se ejecuta la versin ms avanzada. El orden de precedencia es el siguiente: 1. Biblioteca de soporte de FoxPro extendida de 32 bits 2. Biblioteca de soporte de FoxPro estndar Para usar FOXR.EXE, escriba FOXR a continuacin del smbolo del sistema de MSDOS y presione ENTRAR. FOXR invocar la versin apropiada de la Biblioteca de soporte de FoxPro. 4.1.4 Modificadores del cargador runtime Para ejecutar una versin especfica de la Biblioteca de soporte de FoxPro, puede especificar modificadores opcionales del cargador runtime despu s del nombre del cargador o del archivo .EXE compacto. La tabla siguiente describe los modificadores del cargador runtime, FOXR.EXE. ______________________________________________________________________________ Modificadores del cargador runtime FOXR.EXE ______________________________________________________________________________ Modificador Significado Notas ______________________________________________________________________________ +X Cargar versin extendida de 32 bits -X No cargar versin extendida de 32 bits -M<n> Con <n> K de memoria libres, ejecutar Valor <n> la versin extendida. predeterminado = 2000 /? Mostrar texto de ayuda. ______________________________________________________________________________ Para forzar la ejecucin de una versin, incluya el signo + delante del

modificador. Para evitar que se ejecute una versin, incluya el signo delante del modificador. Ejemplos Para ver una lista de los modificadores disponibles para el cargador, escriba en el smbolo del sistema de MS-DOS el nombre del cargador seguido de un espacio en blanco y /?, y luego presione ENTRAR. FOXR /? En este ejemplo se utiliza FOXR.EXE con el modificador +X para forzar que se invoque la Biblioteca de soporte extendida: FOXR +X La configuracin predeterminada para el cargador runtime FOXR invoca la Biblioteca de soporte versin estndar si hay menos de 2 MB de memoria disponibles, y la Biblioteca de soporte extendida si hay 2 MB de memoria o ms. En este ejemplo, el modificador -M se utiliza para que se requieran al menos 4 MB de memoria libre antes de que el cargador intente usar la Biblioteca de soporte extendida. FOXR -M4000 4.1.5 Modificadores de lnea de comandos Los modificadores de lnea de comandos de FoxPro, o de inicio, permiten configurar la aplicacin que va a distribuir. Los modificadores se incluyen despu s del nombre de archivo del cargador runtime. Si incluye modificadores del cargador runtime (-X, +X), incluya los modificadores de lnea de comandos despu s de los modificadores del cargador runtime. Si incluye ms de un modificador, seprelos con espacios. A continuacin de los modificadores, especifique el nombre de su aplicacin de FoxPro para MS-DOS. Especificar un archivo de configuracin: -C Puede especificar el nombre del archivo de configuracin que usar FoxPro para MS-DOS con el modificador de inicio -C. La sintaxis de este modificador es: -C<nombre de ruta>\<archivo> Si no incluye <archivo>, deber incluir de todas formas una barra inversa (\) despu s del <nombre de ruta> para que FoxPro para MS-DOS busque un archivo CONFIG.FP existente. Evitar el uso de la memoria expandida: -E Para evitar que FoxPro para MS-DOS utilice memoria expandida, use el modificador -E. FOXR -E Evitar el uso de F11 o F12: -K Para evitar el uso de las teclas F11 y F12 en la aplicacin distribuida, use el modificador -K. FOXR -K Suprimir la pantalla de introduccin de FoxPro: -T Puede evitar que en la aplicacin que usted distribuya se presente la pantalla de introduccin de FoxPro; para ello, incluya el modificador -T. El ejemplo siguiente ejecuta el programa ORGANIZE y suprime la pantalla de introduccin

de FoxPro. FOXR -T ORGANIZE ______________________________________________________________________________ Nota Para obtener ms informacin acerca de los modificadores de inicio, consulte la documentacin de FoxPro para MS-DOS. ______________________________________________________________________________ 4.1.6 Especificar modificadores con FOXPROSWX Si ejecuta el cargador runtime o un archivo .EXE compacto sin ninguno de los modificadores, el cargador runtime o el archivo .EXE compacto buscar los modificadores especificados en una variable de entorno del MS-DOS denominada FOXPROSWX. Si existe FOXPROSWX, el cargador runtime o el archivo .EXE compacto utilizar los modificadores que dicha variable contenga. Cree esta variable de entorno del MS-DOS mediante el comando SET del MS-DOS. FOXPROSWX puede especificar los modificadores -C, -E, -K y -T de lnea de comandos despu s de los modificadores del cargador runtime. Tambi n puede incluir el nombre de la aplicacin que se debe ejecutar. En el ejemplo siguiente, se crea FOXPROSWX en el smbolo del sistema de MS-DOS y se almacena en ella el modificador -T (suprimir la pantalla de introduccin). Luego se ejecuta el cargador runtime FOXR.EXE. Puesto que la lnea de comando del cargador runtime no especifica ningn modificador, el cargador utiliza el modificador contenido en FOXPROSWX. SET FOXPROSWX= -T FOXR Si se incluyen modificadores en la lnea de comandos del cargador runtime, stos complementarn o, en caso de conflicto, anularn los modificadores de la variable de entorno FOXPROSWX. ______________________________________________________________________________ Importante No incluya espacios en blanco entre FOXPROSWX y el signo igual. Para obtener informacin adicional acerca de la creacin de una variable de entorno del MS-DOS mediante SET, consulte el manual del MS-DOS. ______________________________________________________________________________ 4.1.7 Archivo CONFIG.FP Puede iniciar un archivo .FXP o .APP directamente desde el smbolo del sistema de MS-DOS sin incluir el nombre del archivo .FXP o .APP en la lnea de comandos del cargador runtime, si el archivo CONFIG.FP contiene la lnea: COMMAND = DO <nombre de archivo> Cuando escriba FOXR, FoxPro para MS-DOS leer el archivo CONFIG.FP y ejecutar el archivo .FXP o .APP especificado mediante COMMAND. Slo se puede incluir una instruccin COMMAND en el archivo CONFIG.FP.

Captulo 5: Crear discos de distribucin Este captulo proporciona informacin acerca de la creacin de discos de distribucin para la aplicacin, los archivos necesarios para distribuir una aplicacin completa y los archivos que est prohibido distribuir. 5.1 Hacer copias de seguridad del cdigo fuente

Como ocurre en todos los mbitos del desarrollo de aplicaciones, es conveniente hacer copias de seguridad completas de los archivos originales del programa antes de crear el archivo o archivos .FXP, .APP y .EXE. Guarde las copias de seguridad en un lugar distinto que las aplicaciones compiladas. ______________________________________________________________________________ Advertencia Asegrese de guardar copias separadas de los archivos fuente originales para su uso futuro. No es posible volver a crear programas fuente a partir del cdigo compilado. ______________________________________________________________________________ 5.2 Crear un archivo personalizado de instalacin por lotes Puede que desee crear un archivo personalizado de proceso por lotes que instale su aplicacin. Consulte la documentacin de Microsoft MS-DOS para obtener informacin acerca de cmo crear archivos de proceso por lotes del MSDOS. Tambi n puede encontrar ejemplos tiles de archivos personalizados de instalacin por lotes en libros de otras empresas que traten sobre el desarrollo de aplicaciones FoxPro. 5.3 Archivos necesarios del Kit de distribucin de FoxPro Cuando vaya a incluir su archivo o archivos .FXP, .APP o .EXE en un disco, asegrese de incluir tambi n los dems archivos necesarios. Algunos archivos sern necesarios para la mayora de las aplicaciones que distribuya porque son necesarios para el entorno runtime. Otros archivos slo se necesitarn si las aplicaciones incluyen determinadas caractersticas. La tabla siguiente contiene una lista de los archivos que deber distribuir para cada tipo de aplicacin. ______________________________________________________________________________ Archivos necesarios en los discos de distribucin segn el tipo de aplicacin. ______________________________________________________________________________ Cuando distribuya Con esta Deber distribuir Descripcin una aplicacin biblioteca tambi n estos de este tipo: de soporte: archivos: ______________________________________________________________________________ .FXP Estndar FOXR.EXE Cargador runtime FOXD2600.ESL Biblioteca de soporte FOXD2600.ESO Biblioteca de soporte .FXP Extendida FOXR.EXE FOXDX260.ESL FOXR.EXE FOXD2600.ESL FOXD2600.ESO FOXR.EXE FOXPROX.ESL FOXD2600.ESL FOXD2600.ESO FOXDX260.ESL Cargador runtime Biblioteca de soporte extendida de 32 bits Cargador runtime Biblioteca de soporte Biblioteca de soporte Cargador runtime Biblioteca de soporte extendida de 32 bits Biblioteca de soporte Biblioteca de soporte Biblioteca de soporte extendida de 32 bits

.APP

Estndar

.APP

Extendida

.EXE compacto .EXE compacto .EXE autnomo

Estndar Extendida

(no se requieren archivos de Bibliotecas de soporte ni cargador runtime para ninguna de las versiones) ______________________________________________________________________________

5.4 Otros archivos necesarios Puede que necesite incluir archivos adicionales en sus discos de distribucin para dar soporte a ciertas caractersticas incluidas en la aplicacin. La tabla siguiente contiene una lista de los archivos que puede necesitar y cundo se requieren. ______________________________________________________________________________ Archivos que puede necesitar la aplicacin ______________________________________________________________________________ Archivo Descripcin Se necesita ______________________________________________________________________________ CONFIG.FP Archivo de configuracin Si desea aplicar configuraciones para la aplicacin personalizadas a la aplicacin FOXSWAP.COM FOXUSER.DBF y Archivo de recursos FOXUSER.FPT *.FKY Archivos de macros de teclado Si la aplicacin usa RUN con el modificador /N Si desea aplicar configuraciones personalizadas a la aplicacin Si ha creado macros de teclado personalizadas para la aplicacin Si distribuye con la aplicacin configuraciones de controladores de impresora personalizados

GENPD.APP

Aplicacin de controladores de impresora

*.MEM Archivos excluidos DRIVER2.PLB

Archivo de variables de memoria Para personalizar o inicializar variables de memoria Archivos marcados como Cuando hay archivos que no se "Excluir" en el proyecto de la pueden incluir en el proyecto aplicacin Aplicacin de controladores de Si la aplicacin requiere impresora controladores de impresora

______________________________________________________________________________ ______________________________________________________________________________ Nota Se recomienda incluir FOXPRO.INT, el archivo internacional de FoxPro que proporciona secuencias de ordenacin adicionales y soporte de pginas de cdigo, junto con la aplicacin a distribuir. Debe incluir FOXPRO.INT junto con la aplicacin si sta utiliza una secuencia de ordenacin diferente de MACHINE o si se ejecuta en mltiples plataformas de FoxPro. Incluya FOXPRO.INT en el directorio raz de la estructura de directorios que contenga los archivos que desee incluir en los discos de distribucin. ______________________________________________________________________________ 5.5 Archivos prohibidos El contrato de licencia prohibe la distribucin de los siguientes archivos estndar de FoxPro para MS-DOS. Para obtener ms informacin al respecto, consulte el contrato de licencia Microsoft. ______________________________________________________________________________ Archivos que no puede distribuir con las aplicaciones ______________________________________________________________________________

Archivo Descripcin ______________________________________________________________________________ FOXHELP.DBF Archivo de ayuda de FoxPro FOXHELP.FPT Archivo memo de ayuda de FoxPro FOXCLIBM.LIB FOXMATHM.LIB FOXPRO.LIB FOXPROS.LIB WOVL.LIB Para crear archivos .EXE autnomos versin estndar FOXCLIBR.LIB FOXBIND.EXE FOXMATHR.LIB FOXPROSX.LIB FOXPROX.LIB Para crear archivos .EXE autnomos versin extendida de 32 bits WLINK8.EXE Vinculador para crear archivos .EXE autnomos FOXPRO.EXE FOXPROX.EXE FOX.EXE FOXPRO.OVL Archivos de programa de la versin de desarrollo de FoxPro ______________________________________________________________________________ Documentacin de FoxPro No est autorizada la reproduccin o distribucin, total o parcial, de la documentacin o de los archivos de ayuda de FoxPro para MS-DOS. Condiciones para usar cdigo de las aplicaciones de ejemplo de FoxPro El contrato de licencia le prohibe incluir ninguna de las aplicaciones de ejemplo de FoxPro para MS-DOS. Sin embargo, puede usar fragmentos del cdigo de las aplicaciones de ejemplo como ejemplos para crear sus propias aplicaciones. <Fin de DKREAD.WRI>