wrapper.java.library.path.<n>

Compatibilidad :2.2.9
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Estas propiedades se utilizan para especificar una lista de directorios en los que buscar cualquier biblioteca nativa (JNI) utilizada por la aplicación. Debe colocar la biblioteca nativa del Wrapper en uno de los directorios especificados. (Windows: wrapper.dll, Linux/UNIX: libwrapper.so)

Componente <n>:

Cada elemento tiene un nombre de propiedad que empieza con "wrapper.java.library.path.", y el componente "<n>" del nombre de la propiedad es un número entero a partir de "1". Por defecto, la numeración debe estar en secuencia, sin espacios. La propiedad wrapper.ignore_sequence_gaps se puede configurar opcionalmente para permitir espacios en la secuencia.

Ejemplo:
wrapper.java.library.path.1=../lib

También es posible obtener el comportamiento predeterminado de Java solicitando que la ruta del sistema se agregue al final de la ruta de la biblioteca Java generada por el Wrapper. Por favor, lea la documentación asociada a la propiedad wrapper.java.library.path.append_system_pathantes de hacerlo.

NOTA

Entradas de ruta de la biblioteca que contienen espacios:

El Wrapper gestionará correctamente los elementos de ruta que contengan espacios. Esto se logra encerrando entre comillas la ruta de la biblioteca generada. Los valores de propiedad de cada elemento de ruta de la biblioteca nunca deben definirse entre comillas, incluso si contienen espacios.

NOTA

Algunas bibliotecas nativas hacen referencia a otras bibliotecas enlazadas dinámicamente. Java localizará la biblioteca JNI inicial mediante la ruta de la biblioteca de Java, pero las bibliotecas secundarias se cargan mediante el mecanismo predeterminado de la plataforma.

Utilize las propiedades wrapper.system.library.path.<n> para configurar las rutas donde se encuentran las bibliotecas secundarias.

Bibliotecas nativas específicas de la plataforma

El Wrapper también proporciona una función que facilita la creación de distribuciones binarias que se ejecutan en cualquier plataforma, incluso si la aplicación utiliza bibliotecas nativas.

En el caso de la biblioteca nativa del Wrapper, el Wrapper es inteligente en la forma en que localiza su componente nativo. La biblioteca se puede nombrar de tal manera que contenga el nombre del sistema operativo actual, el nombre de la plataforma y la profundidad de bits. Por ejemplo, wrapper-windows-x86-32.dll y libwrapper-linux-x86-32.so.

Sin embargo, la mayoría de las bibliotecas no admiten esta función y esperan que sus bibliotecas nativas tengan el mismo nombre para todas las plataformas. Esto suele obligar a publicar distribuciones de una aplicación específicas para cada plataforma. Sin embargo, al definir la ruta de la biblioteca como se indica a continuación, el Wrapper referenciará dinámicamente el directorio correcto de la plataforma durante la ejecución, lo que permite incluir todas las plataformas compatibles en una única distribución del Wrapper.

Ejemplo:
wrapper.java.library.path.1=../lib
wrapper.java.library.path.2=../lib/native/%WRAPPER_OS%-%WRAPPER_ARCH%-%WRAPPER_BITS%

Lo cual se resuelve en lo siguiente:

Windows:
wrapper.java.library.path.1=../lib
wrapper.java.library.path.2=../lib/native/windows-x86-32
Linux:
wrapper.java.library.path.1=../lib
wrapper.java.library.path.2=../lib/native/linux-x86-32
Solaris:
wrapper.java.library.path.1=../lib
wrapper.java.library.path.2=../lib/native/solaris-sparc-32

NOTA

Como se mencionó anteriormente, si las bibliotecas nativas necesitan cargar sus propias bibliotecas externas, también debe configurar las rutas correctamente. Si estos archivos se instalan externamente en los sistemas, el método anterior funcionará. Sin embargo, si desea distribuirlos con su aplicación, colóquelos en los directorios específicos de la plataforma junto con las demás bibliotecas nativas. Luego, las propiedades wrapper.system.library.path.<n> se pueden configurar de la siguiente manera.

wrapper.system.library.path.1=../lib
wrapper.system.library.path.2=../lib/native/%WRAPPER_OS%-%WRAPPER_ARCH%-%WRAPPER_BITS%

Referencia: Librería