Runtime.LoadLibrary(String) Método

Definição

Namespace:: Java.Lang

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Carrega a biblioteca nativa especificada pelo 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

o nome da biblioteca.

Atributos: RegisterAttribute

Exceções

UnsatisfiedLinkError

se a biblioteca não puder ser carregada, porque ela não foi encontrada ou porque há algo errado com ela.

Comentários

Carrega a biblioteca nativa especificada pelo libname argumento. O libname argumento não deve conter nenhum prefixo específico da plataforma, extensão de arquivo ou caminho. Se uma biblioteca nativa chamada libname estiver estaticamente vinculada à VM, a função JNI_OnLoad_libname exportada pela biblioteca será invocada. Consulte a Especificação JNI para obter mais detalhes.

Caso contrário, o argumento libname é carregado de um local de biblioteca do sistema e mapeado para uma imagem de biblioteca nativa de maneira dependente de implementação.

Primeiro, se houver um gerenciador de segurança, seu checkLink método será chamado com o libname argumento como argumento. Isso pode resultar em uma exceção de segurança.

O método System#loadLibrary(String) é o meio convencional e conveniente de invocar esse método. Se os métodos nativos devem ser usados na implementação de uma classe, uma estratégia padrão é colocar o código nativo em um arquivo de biblioteca (chamá-lo LibFile) e, em seguida, colocar um inicializador estático: <blockquote>

static { System.loadLibrary("LibFile"); }

</blockquote> dentro da declaração de classe. Quando a classe é carregada e inicializada, a implementação de código nativo necessária para os métodos nativos também será carregada.

Se esse método for chamado mais de uma vez com o mesmo nome de biblioteca, as segundas e subsequentes chamadas serão ignoradas.

Java documentação para java.lang.Runtime.loadLibrary(java.lang.String).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a