Runtime.LoadLibrary(String) Método

Referência

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 pode ser carregada, ou porque 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, extensão de arquivo ou caminho específico da plataforma. Se uma biblioteca nativa chamada libname estiver vinculada estaticamente à VM, a função JNI_OnLoad_libname exportada pela biblioteca será chamada. Consulte a Especificação JNI para obter mais detalhes.

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

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

O método System#loadLibrary(String) é o meio convencional e conveniente de invocar este método. Se 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, a segunda e as chamadas subsequentes serão ignoradas.

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

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

Aplica-se a

Compartilhar via