Runtime.LoadLibrary(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Carga la biblioteca nativa especificada por el libname argumento .
[Android.Runtime.Register("loadLibrary", "(Ljava/lang/String;)V", "GetLoadLibrary_Ljava_lang_String_Handler")]
public virtual void LoadLibrary(string? libname);
[<Android.Runtime.Register("loadLibrary", "(Ljava/lang/String;)V", "GetLoadLibrary_Ljava_lang_String_Handler")>]
abstract member LoadLibrary : string -> unit
override this.LoadLibrary : string -> unit
Parámetros
- libname
- String
el nombre de la biblioteca.
- Atributos
Excepciones
si no se puede cargar la biblioteca, ya sea porque no se encuentra o porque hay algún problema con ella.
Comentarios
Carga la biblioteca nativa especificada por el libname argumento . El libname argumento no debe contener ningún prefijo específico de la plataforma, extensión de archivo o ruta de acceso. Si una biblioteca nativa llamada libname está vinculada estáticamente con la máquina virtual, se invoca la función JNI_OnLoad_libname exportada por la biblioteca. Consulte la especificación JNI para obtener más detalles.
De lo contrario, el argumento libname se carga desde una ubicación de biblioteca del sistema y se asigna a una imagen de biblioteca nativa de forma dependiente de la implementación.
En primer lugar, si hay un administrador de seguridad, se llama a su checkLink método con libname como argumento. Esto puede dar lugar a una excepción de seguridad.
El método es el medio System#loadLibrary(String) convencional y conveniente de invocar este método. Si los métodos nativos se van a usar en la implementación de una clase, una estrategia estándar consiste en colocar el código nativo en un archivo de biblioteca (llámelo LibFile) y, a continuación, colocar un inicializador estático: <blockquote>
static { System.loadLibrary("LibFile"); }
</blockquote> dentro de la declaración de clase. Cuando se carga e inicializa la clase, también se cargará la implementación de código nativa necesaria para los métodos nativos.
Si se llama a este método más de una vez con el mismo nombre de biblioteca, se omiten las llamadas segundas y posteriores.
Documentación de Java para java.lang.Runtime.loadLibrary(java.lang.String).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.